Processing error codes
Apart from general Error status and corresponding HTTP code, Enterprise API will provide you with a detailed description of an error using error codes provided below.
| Error code | Type | Error code description | Reason | Recommendation | Applicable API Function(s) |
|---|---|---|---|---|---|
1000 | Final | Processing error occurred. | Some generic processing error, in most cases occurs on the side of our payout partner. | Please try again later, and if this error occurs multiple times, contact customer support providing the transaction ids. | - fx.rateGet - fx.rateGet.p2a - card.createToken - card.infoGet - partner.statementGet - pay.toAccount - pay.toCard - getBalance - task.statusGet |
2000 | Final | You can receive the 2000 validation error in two formats: - Option 1: Validation error: {field_name}, error: {error_text}. Please try again with corrected payload. - Option 2: {"data":{"validationResult": {"errors": [{"path": "transferAmount","value": "transferAmount","errorTypes": ["0 should be greater than 0"]}],"status": "Error","message": "Validation error."}}} | Data in task payload did not pass Paysend's internal validations. | Please correct the request data according to error description and resend the request. | - pay.toAccount - pay.toCard |
3000 | Final | Failed to save card. | Paysend tried to tokenize the card but did not succeed. | Please try again later, and if this error occurs multiple times, contact customer support providing the global id. | |
3001 | Final | Tokenised card not found. Please try again with the corrected card token. | Token is valid, but the card was not found. | Please check token data and try again. | |
3002 | Final | Unable to decrypt tokenised card. Please try again with the corrected card token. | Token provided is not valid. | Please check token data and try again. | |
3003 | Final | Single transaction limit reached. | Transaction amount is outside of single transaction limit range. | Please try splitting the transaction amount to several transactions with amount below agreed limit for selected destination. | |
3004 | Final | Aggregate transaction limit reached. | Transaction exeeds aggregate transaction limit. | Please try again later, once the limit will be reset. | |
3005 | Final | Processing error occurred. | Internal error during FX rate calculation. | Please try again later, and if this error occurs multiple times, contact customer support providing the request data. | - fx.rateGet - fx.rateGet.p2a - task.statusGet |
3006 | Final | Unable to find requested data. Please check the request parameters and try again. | No data was found for id provided. | Please try again later, and if this error occurs multiple times, contact customer support providing the request data. | - partner.statementGet - task.statusGet |
3007 | Final | Failed to get saved card by token. Please try again later or use other card. | Paysend tried to get tokenized card data but did not succeed. | Please try again later, and if this error occurs multiple times, contact customer support providing the global id. | |
3008 | Final | Wrong Source Transaction Instrument provided (no such account Id) | Source account id provided does not exist. | Please check source account id and correct the error. | - pay.toAccount - pay.toCard |
3009 | Final | Insufficient Balance | Virtual balance is not enough to fund the transaction. | Please top-up the balance and send transaction creation request again. | |
3010 | Final | Bank with this UUID has been deleted. Please update bank data. | Bank UUID provided is no longer active and cannot be used. | Please stop using this id, and perform bank search request to get an updated bank UUID for your criteria. | - pay.toAccount |
3011 | Final | Payment with this invoiceId already exists. | There is already a successful payment with such InvoiceId. Given the idempotency rules please send a payment with a different invoiceId. | Please send a new payment with a different invoiceId. | - pay.toAccount - pay.toCard |
3012 | Final | Declined for compliance or fraud reasons. Please contact customer support for additional information. | Payment has been declined for compliance or fraud reasons. | Please contact customer support for additional information or send a payment to a different recipeint. | - pay.toAccount - pay.toCard |
4000 | Final | Generic decline. Try again and refer to card issuer if issue persists. | Generic error on Paysend's payout partner side. Transaction will not be processed and can be resent. | Please resend the transaction. | - pay.toCard - task.statusGet |
4002 | Final | The issuer is temporarily unavailable or has a system issue. | Error on recepient's bank side. Transaction was not performed and funds will be returned to source account. | Please resend the transaction. | - pay.toCard - task.statusGet |
4003 | Final | Approval amount or frequency limit exceeded. Try again later, send a smaller amount or use another card or account. | Transaction amount is above limits for such type of transaction on recepient's side. | Please try again later, send a smaller amount or use another card or account. | - pay.toAccount - pay.toCard - task.statusGet |
4004 | Final | Insufficient funds in the recipient account. Please use a different card. | Error on recepient's bank side. Transaction was not performed and funds will be returned to source account. | Please try again later, send a smaller amount or use another card or account. | - pay.toCard - task.statusGet |
4005 | Final | Issues with the card information or transaction data. | Error with transaction data. | Check transaction data for any inconsistencies, resend the transaction and contact customer support if error appears again. | - pay.toCard - task.statusGet |
4006 | Final | Declined due to account restrictions or bank policies. Recipient needs to contact the receiving bank. | Restrictions on receiving side. | Contact the recepient to resolve the problem or use another card. | - pay.toAccount - pay.toCard - task.statusGet |
4007 | Final | Declined for security or regulatory reasons. Recipient needs to contact the receiving bank. | Restrictions on receiving side. | Contact the recepient to resolve the problem or use another card. | - pay.toAccount - pay.toCard - task.statusGet |
4008 | Final | Account owner refused incoming money transfer. Please contact the account owner. | Account owner refused incoming transfer, money will be refunded to the account shortly. | Contact the recepient to resolve the problem or use another card/account. | - pay.toAccount - task.statusGet |
4009 | Final | Issues with the account information or transaction data: {error_text}. | Error with transaction data. Error text (if provided by payout partner) will be provided in error description. | Check transaction data for any inconsistencies, resend the transaction and contact customer support if error appears again. | - pay.toAccount - task.statusGet |
4010 | Final | Transaction cancelled. | Transaction was cancelled. | Please try again. | - pay.toAccount - task.statusGet |
4011 | Final | Invalid recipient currency | Recepient currency is incorrect. | Please try again with another currency. | - pay.toAccount - task.statusGet |
4012 | Final | Transaction amount is greater than maximum allowed for transaction | Transaction amount is too big. | Please split the transaction into several so that the amount will be below limit. | - pay.toAccount - task.statusGet |
4013 | Final | Incorrect IFSC or BIC code | Incorrect recepient bank's credentials. | Please check the credentials and repeat the transaction with correct data. | - pay.toAccount - task.statusGet |
4014 | Final | Sender address is incorrect or invalid | Sender address is required, but the information provided is not correct. | Provide correct sender address and repeat the transaction with correct data. | - pay.toAccount - task.statusGet |
4015 | Final | Incorrect branch name or code | Incorrect recepient bank's credentials. | Please check the credentials and repeat the transaction with correct data. | - pay.toAccount - task.statusGet |
4016 | Final | Recipient name does not match the account | Provided account has another owner name. | Please check recepient name and repeat the transaction with correct data. | - pay.toAccount - task.statusGet |
4017 | Final | Invalid Recipient bank account number | Account number is not correct (account does not exist). | Please check account number and repeat the transaction with correct data. | - pay.toAccount - task.statusGet |
4018 | Final | IBAN provided is invalid | IBAN is not correct (account does not exist). | Please check IBAN and repeat the transaction with correct data. | - pay.toAccount - task.statusGet |
9999 | Not final | Unknown error. Please contact customer support. | Some unexpected response from payout partner. | In most cases, the transaction will get a status update from receiving side automatically with some delay. If transaction will not receive such update, it will be reviewed by our support team. You can get details by contacting our customer support. | - pay.toAccount - task.statusGet |