Reason Codes

Wix uses codes to represent detailed information about the statuses of different payment related processes. These codes are used to display information about these processes on your site's dashboard.

Reason codes can be divided into 4 groups:

  1. Account connection failures
  2. Pending transactions
  3. Declined transactions
  4. Declined refunds

If you can't find a corresponding reason code for your scenario, use 6000 and provide an appropriate errorCode and errorMessage with your response.

Account connection failure codes

Reason CodeName
2000Merchant account is not active
2001Merchant account blocked or restricted
2002Merchant account invalid
2003Merchant account expired
2004Merchant authorization failed
2005Merchant contact provider
2006Merchant limit exceeded
2007Payment method is not activated
2008Merchant account is in test mode
2009Merchant account does not match currency

Pending transaction codes

Note When state is set to Pending, the transaction is likely to be approved in the future.

Reason CodeName
5005Pending fraudulent transaction

Declined transaction codes

Reason CodeName
3000General bank decline
3001Invalid amount
3002Transaction type is not supported
3003Currency is not supported
30043D secure failed
30053D secure not enabled
3006Country is not supported
3007Conversion error
3008Address verification failed
3009Buyer to repeat purchase
3010Return buyer to provider
3011AVS CVC check failed
3012Insufficient funds
3013Card expired
3014Invalid expiration date
3015Invalid card number
3016Invalid CVV CVC
3017Card type not supported
3018Too many requests
3019Card limit exceeded
3020Test card declined
3021Tokenization issue
3026Receiving limit
3027Transaction already processed
3028Insufficient funds wallet
3029Expired payment source
3030Buyer canceled
3031Transaction action already committed
3034Installments failed
3035Transaction expired
3036Invalid PIN
3037Terminal not available
3038Revocation of payment
3039Payment account invalid
3040Security violation
3041Invalid account
3042Do not try again
3043Buyer revoked authorization
3044Bank notification failed
3045Mandate canceled
3046Mandate not active
4000Cart amount does not match order
4001Billing address missing
4002Shipping address missing
4003ZIP code missing
4004Phone number missing or invalid
5000Lost or stolen card
5001Risk management declined
5002Restricted or blocked card
5003Restricted or blocked buyer
5004Buyer declined and contact provider
5006Risk bank decline
5007Pick up card
5009Pending general
6000General error

Declined refund codes

Reason CodeName
3022Refund not allowed
3023Payment already refunded
3024Partial refund not allowed
3025Insufficient funds for refund
3032Refund attempts exceeded
3033Refund time limit exceeded
Was this helpful?