API Codes
Learn about the API Codes returned by our Cashouts APIs

Cashout Status Codes

Code
Meaning
Description
0
Pending
The cashout was accepted by Directa24 but still it wasn't sent to the bank. It can still be Canceled. See Cancel Cashout
1
Completed
The money reached the customer's account
2
Cancelled
The cashout was cancelled by you
3
Rejected
The cashout was rejected by the bank due to invalid bank account, account closed, etc.
4
Delivered
The cashout was sent to the bank for processing. Can't be Canceled anymore
5
On Hold
Cashout set to on hold by the merchant. It won't be processed until manually changed again to Pending status

Cashout Rejection Error Codes

The error information is the one (if) provided by the Bank.
Code
Name
Description
800
ERROR_ACCOUNT_INCORRECT
Invalid bank account
801
ERROR_ACCOUNT_CLOSED
Bank account is closed
802
ERROR_AMOUNT_INCORRECT
Invalid amount
803
ERROR_BANK_INVALID
Invalid bank code
804
ERROR_BANK_BRANCH_INCORRECT
Invalid bank branch
805
ERROR_BENEFICIARY_DOCUMENT_ID_INVALID
Invalid beneficiary document
806
ERROR_BENEFICIARY_NAME_INCORRECT
Beneficiary name doesn't match bank details
807
ERROR_REJECTED_BY_BANK
Rejected by bank
808
ERROR_OTHER
Other error
809
WITHDRAWAL_EXPIRED
Withdrawal expired
810
LIMIT_EXCEEDED
Beneficiary limit exceeded
811
RISK_POLICY
Violates bank risk policy
812
BLOCKED_FROZEN_ACCOUNT
Bank account blocked/frozen
813
DOCUMENT_ACCOUNT_MISMATCH
Beneficiary document doesn't match bank details
814
INVALID_PIX_KEY
Invalid Pix Key
815
INVALID_IFSC_CODE
Invalid IFSC code
816
INVALID_ACCOUNT_OR_IFSC_CODE
Invalid bank account or IFSC code
817
INVALID_NBIN
Invalid NBIN
818
ACCOUNT_UNABLE
The bank account is unable to receive transfers
819
INVALID_ACCOUNT_TYPE
Invalid bank account type

Cashout Internal Error Codes

Code
Description
300
Invalid params + [param name] + [reason]
302
Invalid control string. Click here for instructions
303
Invalid bank code
401
Invalid credentials
402
Unregistered IP address (Go to API Access to whitelist the IP in the Merchant Panel)
502
Invalid request body - Please check that the JSON is well formatted
508
Limit exceeded: {TRANSACTION|DAILY|MONTHLY|USER MONTHLY QUANTITY}
509
Cashout not found with this ID
510
Invalid status: cashout is not Pending
511
External ID already used
514
Insufficient funds
515
Invalid user status: {BLACKLISTED|BLOCKED}
518
Country not available
519
Merchant not enabled. Contact your Account Manager
524
Invalid Credentials. Contact [email protected]
525
Close loop rejection
526
Invalid currency
533
Invalid Amount. The minimum amount is {currency} {amount} or equivalent in USD
537
Could not make the cashout. Contact [email protected]
538
Invalid account status: {BLACKLISTED}