Skip to content

Decline codes

Every transaction has a status derived from the gateway response code. Use it to decide whether to retry, ask for a new card or stop billing.

Each status has two numbers:

  • Code — CreditCore’s own status code. It’s the status_id sent in the webhooks, and the value shown in the platform filters as [code] name.
  • Gateway code — the gateway (NMI) response_code the status is mapped from.

Codes are grouped: 1xx approved, 2xx declined, 5xx technical errors, 6xx fraud and security, 7xx other errors and 999 unmapped.

Status Code Gateway code Meaning
APPROVED 100 100 Transaction approved.
Status Code Gateway code Meaning Recommended action
DECLINED 200 200 Declined by the issuer. Retry later or ask for another card.
DO_NOT_HONOR 201 201 Generic decline. Ask for another card.
OPERATION_NOT_PERMITTED 203 204 Transaction not allowed for this card. Ask for another card.
INSUFFICIENT_BALANCE 210 202 Insufficient funds. Retry in a few days (done automatically on renewals).
CREDIT_LIMIT_EXCEEDED 211 203 Over the credit limit. Retry later.
INCORRECT_PAYMENT_DETAILS 220 220 Incorrect payment details. Ask the buyer to check their details.
CARD_EXPIRED 221 223 Card expired. Ask for an updated card.
SECURITY_CODE_MISMATCH 222 225 CVC mismatch. Ask the buyer to re-enter the CVC.
WRONG_PIN 223 226 Incorrect PIN. Ask for another card.
UNKNOWN_CARD 224 222 Card issuer not recognised. Ask for another card.
INVALID_CARD_NUMBER 225 221 Invalid card number. Ask the buyer to re-enter the card.
CALL_YOUR_BANK 230 240 Issuer requests contact. Ask the buyer to call their bank.
STOP_THIS_SUBSCRIPTION 232 262 Cardholder asked to stop recurring charges. Stop billing. Unsubscribe the customer.
UPDATE_CARD_DETAILS 233 263 Card details changed. Ask for an updated card.
RETRY_LATER 234 264 Temporary issue. Retry in 3–5 days.
DECLINE_WITH_MESSAGE 235 260 Declined with an issuer message. See response_text.
GATEWAY_REJECTION 240 300 Rejected by gateway rules. Contact CreditCore.
Status Code Gateway code Meaning Recommended action
PROCESSOR_FAILURE 500 400 Processor error. Retry later.
CONNECTIVITY_ERROR 501 420 Connection error between processor and bank. Retry later.
DUPLICATE_REQUEST 502 430 Duplicate transaction. Don’t retry.
FORMAT_ERROR 503 440 Invalid request format. Contact CreditCore.
INVALID_REQUEST_DATA 504 441 Invalid request data. Check the input data.
MERCHANT_SETUP_ERROR 510 410 Merchant account configuration error. Contact CreditCore.
MERCHANT_ACCOUNT_DISABLED 511 411 Merchant account disabled. Contact CreditCore.
CARD_TYPE_NOT_ACCEPTED 513 461 Card brand not accepted. Ask for another card brand.
Status Code Gateway code Meaning Recommended action
STOLEN_CARD 600 252 Card reported stolen. Don’t retry.
LOST_CARD 601 251 Card reported lost. Don’t retry.
CARD_PICKUP_REQUIRED 602 250 Card must be retained. Don’t retry.
FRAUD_SUSPECTED 610 253 Suspected fraud. Don’t retry.
Status Code Gateway code Meaning Recommended action
VALIDATION_ERROR 700 — Submission rejected by gateway validation. Check the card details.
BAD_REQUEST 701 — Encrypted card data could not be processed. Reload the checkout and retry.
ERROR 999 — Unmapped error. Contact CreditCore.