Skip to main content

Response code and message

This status refers exclusively to the result of the create payment operation.

Reason CodeHTTP Status CodeResponseTransaction.statusCauseNext Action
waiting_confirmation200pendingConfirmation 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_status200pendingStatus 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.
cancelled200abortedThe consumer has cancelled the payment. Payment is not completed.Consumer can retry the payment again or use another payment method to pay.
timeout200abortedThe 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_issuer200declinedThe issuer has declined the payment.Contact bank or use another method.
do_not_retry200declinedThe issuer has declined the payment and it should not be retried.Contact bank or use another method.
insufficient_funds200declinedThe consumer does not have enough funds.Use a different payment method.
suspected_fraud200declinedPayment 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_amount200declinedPayment 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.
referral200declinedAdditional issuer verification required.Consumer needs to contact bank. Retry or use another method.
exceeded_activity200declinedBalance/limit/frequency exceeded.Contact bank. Retry or use another method.
invalid_account200declinedAccount 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_card200declinedIssuer requested card pickup.Contact bank. Retry or use another method.
restricted_card200declinedCard cannot be used for the payment.Contact bank. Retry or use another method.
lost_card200declinedCard is reported lost.Contact bank. Retry or use another method.
stolen_card200declinedCard is reported stolen.Contact bank. Retry or use another method.
expired_card200declinedCard is expired or has wrong expiry date.Contact bank. Retry or use another method.
security_violation200declinedSecurity violation reported by processor or issuer.Contact bank. Retry or use another method.
not_allowed_by_issuer200declinedPayment not allowed by issuer.Contact bank. Retry or use another method.
invalid_account_number200declinedAccount number is incorrect.Retry with correct account number. If issue persists, contact bank.
duplicated_transaction200declinedOperation reported as duplicated.Check if operation already processed. Retry later if needed.
not_supported_by_issuer200declinedOperation not supported by issuer.Contact bank. Retry or use another method.
processing_error200failedOperation failed due to incorrect/missing data or system error.Please try again later.
invalid_request400*Request has unexpected parameters.Check reason.invalidParams in response and adjust the request.
invalid_operation400*Invalid operation for resource's current state.
Example: Refund on non-succeeded payment
Check reason.description in response. Adjust flow as needed.
not_supported400*Operation not supported due to scheme/issuer restriction.Check reason.description. Refer to developer portal.
not_allowed400*Operation not allowed due to configuration restriction.Check reason.description for more details.
locked_operation409*Operation already in progress, locked by idempotency key.Try again later.
blocked422rejectedOperation is blocked by the system.Check reason.description in response.
exceeded_amount422rejectedAmount exceeds original transaction.Check reason.description in response.
configuration_error500*Account misconfiguration.Contact support to resolve.
unavailable_idempotency503*Idempotency system unavailable.Retry without idempotency key or try again later.
internal_error503*Internal system error.Please try again later.