Reason Codes

Reason codes are used to identify the cause of a payment decline. These codes help merchants and payment processors understand why a transaction was rejected and determine the appropriate next steps.

While these codes are primarily used for card payments, they may also apply to other payment methods, such as electronic funds transfers (EFT). Some declines may allow the transaction to be retried, while others indicate a permanent failure that requires alternative action.

The table below lists reason codes, their associated messages, and whether retrying the transaction is recommended.

๐Ÿšง

Codes 10066 and 10067 are only applicable to Betting clients.

CodeMessage
10000Not authorized by the acquirer
10001Contact your card central
10002Expired card - do not try again
10003Not authorized. Contact your card central
10004Invalid requirement
10005Invalid transaction
10007Check the card data
10008Invalid installment - do not try again
10009Invalid CVV
10010Canceled transaction
10011Exceeded date for operation
10012Transaction value not allowed. Do not try again
10013Capture failure
10014Cancellation failed
10015System unavailable
10017Transaction not allowed. Do not try again
10019Re-enter transaction
10020Database error
10021Non-registered or request out of time
10022Number of tries exceeded
10023Integrator error
10024Time out
10025Incorrect validity date
10026Suspicious card
10027Fraudulent card
10029Canceled card
10030Transaction already exists
10031Card not configured
10032Undo transaction
10033Not authorized
10034Transaction already canceled
10037Contact your card issuer. Do not try again
10040Card does not allow international transaction
10041Invalid data
10042Invalid token
10043Error running operation
10044Disabled purchaser
10045The company cannot complete this transaction. Contact our support
10046Transaction amount exceeded - try again later
10047Rejected transaction. Contact your card issuer
10048Insufficient funds
10049Invalid Card
100503-D Secure required
10051Payer tax ID mismatched
10052Unknown error - contact the processor
10053Invalid Submerchant
10055Insufficient information - Please try again
100583DS - Authentication failed
10065Pre-auth required
10066*Denied due to payer document validation rules
10067*Denied due to payer banking details validation rules

(*): These codes are only valid for Betting clients.