Fieldwork uses Stripe as a payment processor to handle credit-card transactions.
If Stripe does not accept a payment, they will provide a decline code as a response.
We have listed the decline codes from Stripe below, along with suggestions for next steps to take to try and complete the payment.
For more information, please visit Stripe's helpcenter
DECLINE CODE: approve_with_id
DESCRIPTION: The payment cannot be authorized.
NEXT STEPS: The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.
DECLINE CODE: call_issuer
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: card_velocity_exceeded
DESCRIPTION: The customer has exceeded the balance or credit limit available on their card.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: currency_not_supported
DESCRIPTION: The card does not support the specified currency.
NEXT STEPS: The customer needs check with the issuer that the card can be used for the type of currency specified.
DECLINE CODE: do_not_honor
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: do_not_try_again
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: duplicate_transaction
DESCRIPTION: A transaction with identical amount and credit card information was submitted very recently.
NEXT STEPS: Check to see if a recent payment already exists.
DECLINE CODE: expired_card
DESCRIPTION: The card has expired.
NEXT STEPS: The customer should use another card.
DECLINE CODE: fraudulent
DESCRIPTION: The payment has been declined as Stripe suspects it is fraudulent. NEXT STEPS: Do not report more detailed information to your customer. Instead, present as you would the generic_declinedescribed below.
DECLINE CODE: generic_decline
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: incorrect_number
DESCRIPTION: The card number is incorrect.
NEXT STEPS: The customer should try again using the correct card number.
DECLINE CODE: incorrect_cvc
DESCRIPTION: The CVC number is incorrect.
NEXT STEPS: The customer should try again using the correct CVC.
DECLINE CODE: incorrect_pin
DESCRIPTION: The PIN entered is incorrect. This decline code only applies to payments made with a card reader.
NEXT STEPS: The customer should try again using the correct PIN.
DECLINE CODE: incorrect_zip
DESCRIPTION: The ZIP/postal code is incorrect.
NEXT STEPS: The customer should try again using the correct billing ZIP/postal code.
DECLINE CODE: insufficient_funds
DESCRIPTION: The card has insufficient funds to complete the purchase.
NEXT STEPS: The customer should use an alternative payment method.
DECLINE CODE: invalid_account
DESCRIPTION: The card, or account the card is connected to, is invalid.
NEXT STEPS: The customer needs to contact their card issuer to check that the card is working correctly.
DECLINE CODE: invalid_amount
DESCRIPTION: The payment amount is invalid, or exceeds the amount that is allowed. NEXT STEPS: If the amount appears to be correct, the customer needs to check with their card issuer that they can make purchases of that amount.
DECLINE CODE: invalid_cvc
DESCRIPTION: The CVC number is incorrect.
NEXT STEPS: The customer should try again using the correct CVC.
DECLINE CODE: invalid_expiry_year
DESCRIPTION: The expiration year invalid.
NEXT STEPS: The customer should try again using the correct expiration date.
DECLINE CODE: invalid_number
DESCRIPTION: The card number is incorrect.
NEXT STEPS: The customer should try again using the correct card number.
DECLINE CODE: invalid_pin
DESCRIPTION: The PIN entered is incorrect. This decline code only applies to payments made with a card reader.
NEXT STEPS: The customer should try again using the correct PIN.
DECLINE CODE: issuer_not_available
DESCRIPTION: The card issuer could not be reached, so the payment could not be authorized.
NEXT STEPS: The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.
DECLINE CODE: lost_card
DESCRIPTION: The payment has been declined because the card is reported lost. NEXT STEPS: The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.
DECLINE CODE: new_account_information_available
DESCRIPTION: The card, or account the card is connected to, is invalid.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: no_action_taken
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: not_permitted
DESCRIPTION: The payment is not permitted.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: pickup_card
DESCRIPTION: The card cannot be used to make this payment (it is possible it has been reported lost or stolen).
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: pin_try_exceeded
DESCRIPTION: The allowable number of PIN tries has been exceeded.
NEXT STEPS: The customer must use another card or method of payment.
DECLINE CODE: processing_error
DESCRIPTION: An error occurred while processing the card.
NEXT STEPS: The payment should be attempted again. If it still cannot be processed, try again later.
DECLINE CODE: reenter_transaction
DESCRIPTION: The payment could not be processed by the issuer for an unknown reason.
NEXT STEPS: The payment should be attempted again. If it still cannot be processed, the customer needs to contact their card issuer.
DECLINE CODE: restricted_card
DESCRIPTION: The card cannot be used to make this payment (it is possible it has been reported lost or stolen).
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: revocation_of_all_authorizations
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: revocation_of_authorization
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: security_violation
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: service_not_allowed
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: stolen_card
DESCRIPTION: The payment has been declined because the card is reported stolen. NEXT STEPS: The specific reason for the decline should not be reported to the customer. Instead, it needs to be presented as a generic decline.
DECLINE CODE: stop_payment_order
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer should contact their card issuer for more information.
DECLINE CODE: testmode_decline
DESCRIPTION: A Stripe test card number was used.
NEXT STEPS: A genuine card must be used to make a payment.
DECLINE CODE: transaction_not_allowed
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: The customer needs to contact their card issuer for more information.
DECLINE CODE: try_again_later
DESCRIPTION: The card has been declined for an unknown reason.
NEXT STEPS: Ask the customer to attempt the payment again. If subsequent payments are declined, the customer should contact their card issuer for more information.
DECLINE CODE: withdrawal_count_limit_exceeded
DESCRIPTION: The customer has exceeded the balance or credit limit available on their card.
NEXT STEPS: The customer should use an alternative payment method.
February 2020
Article ID: 0489