Error codes for transfer dispersions

October 25, 2024

Learn about common mistakes in money transfer dispersals

When making a wire money dispersal request you will be able to check the transaction status through the Get Status endpoint or through a webhook. In case there is a problem completing the dispersal, you will receive an error code as well as a message with the error information. The fields you will receive in the response will be as follows:

"responseCode": "560",
"responseText": "Monto ingresado supera límite"

Below are the codes you may receive.

code	message	What to do?
501	Transaction rejected	You should contact the account issuer to find out why the transaction was rejected.
530	Transaction rejected; information error	At the time of the transaction there was an error in the transaction format. Contact Kushki’s support team, so we can review your case.
514	The account entered is invalid	Verify that the account number has been entered correctly, that it corresponds to the issuing bank and retry.
594	Duplicate transaction	The transaction was declined because there is a match with a previous transaction. This usually happens because a repeated reference number is being entered.
524	Invalid document number	Re-enter the type and ID number corresponding to the account and retry.
518	The account type is invalid	Verify that the account type entered is correct and retry.
517	The transaction type is invalid	Verify that the transaction type to be performed is correct and retry.
516	The payment type is invalid	Verify that the payment type is correct and corresponds to the account type and retry.
513	Amount has invalid syntax	It is necessary to verify the amount entered and retry. For example, it is possible that unallowed characters have been entered in the amount field, as `,` instead of `.` to separate decimals.
596	Transaction rejected due to third party restrictions	You will need to wait a couple of minutes and retry, otherwise use an alternate account or contact the account issuer to verify.
515	Transaction rejected by beneficiary	You should contact the account issuer to find out why the transaction was rejected.
560	Amount entered exceeds limit	You must verify that the authorized balance limit of the account or the limit of credits allowed in the month in the account have not been exceeded. You will need to contact the account issuer to know the reasons or use another account.