order_updated webhook includes a statusClassification object with a broad primary category and a specific secondary reason.
{
"statusClassification": {
"primary": "payment_execution_failed",
"secondary": "insufficient_funds"
}
}
Primary classifications
| Primary | Meaning | Common causes | Handling |
|---|---|---|---|
payment_authorization_failed | Rejected during authorization at the bank. | Wrong credentials, canceled at bank, account restrictions. | Suggest retry, check credentials, try a different bank. |
payment_execution_failed | Authorized but couldn’t execute. | Insufficient funds, account limits, blocked international transfer, bank rejection or outage. | Retry — if the original payment arrives late, it’s auto-returned. |
payment_abandoned | Started but never completed. | Customer closed the browser, session timed out, canceled at the bank. | Show clear messaging, allow retry. |
Secondary classifications
| Code | Description |
|---|---|
wrong_credentials | User entered incorrect bank credentials during authentication. |
incorrect_2fa_response | User provided an incorrect two-factor authentication response. |
pin_blocked | User’s PIN is blocked, e.g. after multiple failed attempts. |
no_active_tan_methods_available | No active TAN (Transaction Authentication Number) methods available. |
timeout | The payment request timed out due to slow response from bank systems. |
connection_to_bank_failed | The user’s bank is not responding to the payment request. |
bank_error | The bank’s system returned an error during processing. |
bank_under_maintenance | The user’s bank is currently under maintenance. |
insufficient_funds | The user’s account has insufficient funds for the payment. |
account_limit_exceeded | The payment exceeds the user’s account transfer limits. |
international_transfer_blocked | International transfers are blocked for this account. |
international_transfer_limit_exceeded | The payment exceeds international transfer limits. |
instant_transfers_not_enabled | Instant transfers are not enabled for this account. |
user_blocked | The user’s account is blocked or restricted. |
unsupported_bank_account | The bank account type is not supported for the requested transfer. |
payment_rejected | The payment was explicitly rejected by the bank. |
cancelled | The payment was canceled by the user or bank. |
payment_not_settled | The payment was not settled within the required timeframe. |