Reason code and message

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.
required_authentication	200	declined	The payment is declined because it requires strong customer authentication to proceed.	The consumer can retry the payment and authenticate their card, or use another payment method to pay.
pin_required	200	declined	The issuer has declined the payment because PIN is required.	The consumer can retry the payment and authenticate their card, or use another payment method to pay.
incorrect_pin	200	declined	The issuer has declined the payment because PIN entered was incorrect.	The consumer can retry the payment or use another payment method to pay.
pin_exceeded	200	declined	The issuer has declined the payment because PIN tries were exceeded.	The consumer can use another payment method to pay.
invalid_pin_block	200	failed	The operation failed due to invalid pin block format.	Contact our support team.
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.
timeout_issuer	200	failed	The operation failed due to timeout from issuer.	The consumer can retry the payment later or use another payment method to pay.
invalid_request	400	*	Request has unexpected parameters.	Check reason.invalidParams in response and adjust the request.
authentication_invalid	401	*	Authentication invalid.	Authentication invalid. Details would be provided on invalidParamsobject
not_found	404	*	The request resource does not exist.	The request resource does not exist.
locked_operation	409	*	The requested operation is already in progress and has been locked for the idempotency key until completion.	Please try again later.
invalid_operation	422	rejected	Invalid operation for resource's current state. Example: Refund on non-succeeded payment	Check reason.description in response. Adjust flow as needed.
not_supported	422	rejected	Operation not supported due to scheme/issuer restriction.	Check reason.description. Refer to developer portal.
not_allowed	422	rejected	Operation not allowed due to configuration restriction.	Check reason.description for more details.
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.