Response code and message
This status refers exclusively to the result of the create payment operation.
Reason Code | HTTP Status Code | ResponseTransaction.status | Cause | Next Action |
---|---|---|---|---|
waiting_confirmation | 200 | pending | Confirmation is pending for the non-instant operation. This mainly happens for push payment products (wallets). When the processors asynchronously inform the status of a payment or refund to us, you can expect this reason code. | You can fetch the updated status of the operation at a later moment using the get method. |
unknown_status | 200 | pending | Status of the operation is unknown at the moment. | You can fetch the updated status of the operation at a later moment using the get method. |
cancelled | 200 | aborted | The consumer has cancelled the payment. Payment is not completed. | Consumer can retry the payment again or use another payment method to pay. |
timeout | 200 | aborted | The consumer didn't make the payment within the given time frame. | Provide a new payment method to the consumer in-session or inform them to retry off-session. |
rejected_by_issuer | 200 | declined | The issuer has declined the payment. | Contact bank or use another method. |
do_not_retry | 200 | declined | The issuer has declined the payment and it should not be retried. | Contact bank or use another method. |
insufficient_funds | 200 | declined | The consumer does not have enough funds. | Use a different payment method. |
suspected_fraud | 200 | declined | Payment declined due to suspected fraud. Examples: - Stolen credentials - Suspicious consumer information | Do not show details to user. Show a generic decline message and advise contacting the bank. |
invalid_amount | 200 | declined | Payment declined due to invalid amount. Examples: - Amount exceeds card program max. - Authorization > Authentication amount | Retry using correct amount or advise consumer to check with their bank. |
referral | 200 | declined | Additional issuer verification required. | Consumer needs to contact bank. Retry or use another method. |
exceeded_activity | 200 | declined | Balance/limit/frequency exceeded. | Contact bank. Retry or use another method. |
invalid_account | 200 | declined | Account validation failed. Examples: - Account closed or blocked - Card not activated - No valid account available | Contact account provider or bank. Retry or use another method. |
pickup_card | 200 | declined | Issuer requested card pickup. | Contact bank. Retry or use another method. |
restricted_card | 200 | declined | Card cannot be used for the payment. | Contact bank. Retry or use another method. |
lost_card | 200 | declined | Card is reported lost. | Contact bank. Retry or use another method. |
stolen_card | 200 | declined | Card is reported stolen. | Contact bank. Retry or use another method. |
expired_card | 200 | declined | Card is expired or has wrong expiry date. | Contact bank. Retry or use another method. |
security_violation | 200 | declined | Security violation reported by processor or issuer. | Contact bank. Retry or use another method. |
not_allowed_by_issuer | 200 | declined | Payment not allowed by issuer. | Contact bank. Retry or use another method. |
invalid_account_number | 200 | declined | Account number is incorrect. | Retry with correct account number. If issue persists, contact bank. |
duplicated_transaction | 200 | declined | Operation reported as duplicated. | Check if operation already processed. Retry later if needed. |
not_supported_by_issuer | 200 | declined | Operation not supported by issuer. | Contact bank. Retry or use another method. |
processing_error | 200 | failed | Operation failed due to incorrect/missing data or system error. | Please try again later. |
invalid_request | 400 | * | Request has unexpected parameters. | Check reason.invalidParams in response and adjust the request. |
invalid_operation | 400 | * | Invalid operation for resource's current state. Example: Refund on non-succeeded payment | Check reason.description in response. Adjust flow as needed. |
not_supported | 400 | * | Operation not supported due to scheme/issuer restriction. | Check reason.description . Refer to developer portal. |
not_allowed | 400 | * | Operation not allowed due to configuration restriction. | Check reason.description for more details. |
locked_operation | 409 | * | Operation already in progress, locked by idempotency key. | Try again later. |
blocked | 422 | rejected | Operation is blocked by the system. | Check reason.description in response. |
exceeded_amount | 422 | rejected | Amount exceeds original transaction. | Check reason.description in response. |
configuration_error | 500 | * | Account misconfiguration. | Contact support to resolve. |
unavailable_idempotency | 503 | * | Idempotency system unavailable. | Retry without idempotency key or try again later. |
internal_error | 503 | * | Internal system error. | Please try again later. |