Error Codes Coming Soon
Early preview
Real-Time Payments are coming soon. This preview gives you an early look at the expected experience so you can begin planning your integration.
RTP Reject Reasons
Real-Time Payments received by you may be rejected for a number of reasons. When an RTP received payment is rejected, the receivedPayment.rejected webhook event will be fired and rejectReason is populated on the Realtime Received Payment resource.
| Reason | Short Description |
|---|---|
InvalidCreditorAccountNumber | The account number provided is invalid or missing. |
ClosedAccountNumber | The account has been closed. |
BlockedAccount | The account is blocked, prohibiting posting of transactions. |
InvalidCreditorAccountType | The account type is invalid for this transaction. |
TransactionForbidden | This transaction type is forbidden on this account. |
TransactionTypeNotSupportedOrAuthorized | This transaction type isn't supported or authorized on this account. |
NotAllowedAmount | The transaction exceeds the allowed transaction limit. |
PaymentTypeLimitBreach | The payment exceeds the limit for this payment type. |
TransactionAmountExceedsLimits | The transaction amount exceeds the limits agreed between bank and client. |
UnknownEndCustomer | The account holder is unknown or no longer exists. |
EndCustomerDeceased | The account holder is deceased. |
DuplicatePayment | This payment is a duplicate of another payment. |
Narrative | The payment was rejected for a business-related reason. |
Other | The payment was rejected for a reason not covered by the codes above. |
RTP Return Reasons
Real-Time Payments received by you may be returned for a number of reasons. When an RTP received payment is returned, the receivedPayment.returned webhook event will be fired and returnReason is populated on the Realtime Received Payment resource.
| Reason | Short Description |
|---|---|
ClosedAccountNumber | Account number specified has been closed on the receiver's books. |
InsufficientFunds | Amount of funds available to cover specified message amount is insufficient. |
AlreadyReturned | Cancellation not accepted as the transaction has already been returned. |
CustomerDecision | Reported when the cancellation cannot be accepted because of a customer decision (Creditor). |
LegalDecision | Reported when the cancellation cannot be accepted because of regulatory rules. |
NoAnswerFromCustomer | No response from beneficiary (to the cancellation request). |
NoOriginalTransactionReceived | Original transaction (subject to cancellation) never received. |