Add Account
This API is used to add new accounts and update the latest status of existing user accounts.
INFO
Entity can trigger this API to update the latest status of existing accounts without the support of Account Fetch webhook.
Request
MANDATORY
All parameters
in the request are required to proceed.
WARNING
The request should be in a array
and include all the accounts of the user in the entity.
Parameters
head
Object
API_ID
String
Unique ID generated from the dashboard. Eg: 1a21as51a351f1155f
API_KEY
String
Unique KEY generated from the dashboard. Eg: AAD5451FS654SD6F5SD46F3S1D5S
result
Object
code
Integer
status
String
The status against the request.
Allowed values: SUCCESS
, FAILED
user
Object
mobile
String
Mobile number of user. Character length : 10 Eg: 9876543210
country_code
String
Country code for the mobile number.
Character length : 2
Eg: 91
accounts
Array of Objects
branch_code
String
Branch code where the account is maintained. Character length : 02 (Min), 12 (Max) Eg: BR001
branch_name
String
Name of the branch where the account is maintained.
Character length : 04 (Min), 20 (Max) Eg: KOCHIN MAIN
account_name
String
Name of the account holder registered with the entity. Character length : 30 (Max) Only UPPERCASE letters are allowed. Eg: RAJESH KJ
account_number
String
User account number. Character length : 04 (Min), 20 (Max) Eg: 123456789
account_type
String
Allowed values: SA
, CA
, TL
, OD
Eg: SA
account_class
String
Classification of account under account_type. Character length: 30 (Max) Eg: AGRICULTURAL LOAN
account_status
String
Eg: ACTIVE
account_opening_date
String
Date of opening the account from the branch. Format: YYYY-MM-DD Eg: 2020-11-20
account_currency
String
Possible values: INR
Eg: INR
account_daily_limit
String
Maximum amount that can be transferred through NEFT/ RTGS/ IMPS/ UPI. Character length : 6 (Max) [I.e. 999999] Eg: 44999
auth_salt
String
Salt value for hashing the authentication pin for debit transactions. [Applies to high-level configuration only.]
Character length : 32 (Max) Eg: abcdefghi1234567abcdefghi1234567
is_debit_allowed
Boolean
If debit transactions are not allowed for the account, keep it false
.
Default value is true
.
Possible values: true
, false
Eg: true
is_credit_allowed
Boolean
If credit transactions are not allowed for the account, keep it false
.
Default value is true
.
Possible values: true
, false
Eg: true
is_cash_debit_allowed
Boolean
If the account does not allow cash-based WITHDRAWALS, keep it false
.
Default value is true
.
Possible values: true
, false
Eg: true
is_cash_credit_allowed
Boolean
If the account does not allow cash-based DEPOSITS, keep it false
.
Default value is true
.
Possible values: true
, false
Eg: true
Request format
Response
Parameters
INFO
All the parameters received in the request except API_ID
& API_KEY
are returned in the response. The response will include all accounts associated with the user created by the entity. Find request parameters.
Response format
Result Code
See the listed common result codes
Last updated