Skip to main content
POST
/
bank
/
create
cURL
curl --request POST \
  --url https://sandbox.dollarpe.xyz/cms/api/v1/bank/create \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-SIGNATURE: <api-key>' \
  --header 'X-TIMESTAMP: <api-key>' \
  --data '
{
  "customer_id": "c2cf861b-342b-4318-a90e-85cd0312e82f",
  "account_number": "7627389201",
  "ifsc": "SBI0001829IU",
  "account_name": "Sandbox Technologies Pvt Ltd"
}
'
{
  "status": true,
  "message": "Success",
  "data": {
    "id": "4e6f1b20-a73c-11ec-b909-0242ac120002",
    "customer_id": "550e8400-e29b-41d4-a716-446655440000",
    "account_number": "123456789012",
    "ifsc": "ABC123456",
    "account_name": "Sandbox Technologies Pvt Ltd",
    "vpa": "testing@upi",
    "bank_account_type": "ACCOUNT_DETAILS",
    "bank_account_status": "VERIFIED",
    "failure_reason": "null"
  }
}
Either [account_number, ifsc] or vpa is required.
Only 3 bank accounts and UPI IDs allowed.

​
Error Codes and Messages

API Status CodeResponseReason
400Customer not found or access deniedCustomer not found
400Customer not found or access deniedCustomer does not belong to the organization
400Customer is unverifiedCustomer is not KYC verified
400VPA already in useUPI ID is already in use
400Maximum 3 UPI IDs allowed3 UPI IDs are already added for the customer
400Account number already in useAccount number is already in use
400Maximum 3 bank account details allowed3 Bank Accounts are already added for the customer
400KYC already in useKYC is being used by another customer
500Internal Server ErrorInternal Server Error

Authorizations

​
X-API-KEY
string
header
required

API Key for authentication

​
X-TIMESTAMP
string
header
required

Current timestamp in seconds since epoch

​
X-SIGNATURE
string
header
required

HMAC SHA256 signature of the request encoded in Base64

Body

application/json
​
customer_id
string<uuid>
required

Customer's unique identifier

Example:

"c2cf861b-342b-4318-a90e-85cd0312e82f"

​
account_number
string
required

Bank account number

Example:

"7627389201"

​
ifsc
string
required

IFSC code of the bank

Example:

"SBI0001829IU"

​
account_name
string
Example:

"Sandbox Technologies Pvt Ltd"

Response

Bank account added successfully

​
status
boolean
Example:

true

​
message
string
Example:

"Success"

​
data
object