Decline Code

A decline code is the reason code returned when a payment attempt fails. When you submit a charge, it travels from the payment processor to the card network (Visa, Mastercard) to the issuing bank, which makes the authorization decision. If declined, the bank returns a response code that indicates why. These codes are essential for determining the appropriate recovery strategy.

Decline codes fall into two broad categories: soft declines and hard declines. Soft declines are temporary and recoverable — they include codes for insufficient funds, issuer temporarily unavailable, processing errors, and rate limits. Hard declines are permanent or semi-permanent — they include codes for stolen cards, closed accounts, invalid card numbers, and fraud-flagged transactions. The recovery approach should differ dramatically based on this classification.

The standardization of decline codes varies by processor and network. ISO 8583 defines a set of response codes used in card payment processing, but payment processors often map these to their own codes with varying levels of detail. Stripe might return "card_declined" with a "decline_code" of "insufficient_funds," while Braintree returns a "processor_response_code" of "2001." Understanding the mapping between processor-specific codes and underlying reasons is critical for effective recovery.

Some decline codes require specific actions. "Do not honor" (the most common and most frustrating code) is a generic decline from the issuer that could mean many things — it often warrants a retry with different timing. "Expired card" should trigger a card update request, not a retry. "Pick up card" or "lost/stolen" should never be retried and may require the card to be removed from file. "Insufficient funds" is highly recoverable with properly timed retries.

LostChurn maintains a comprehensive database of 316 decline codes across 18 payment processors, with recovery recommendations for each. The platform automatically classifies failures, routes them to the appropriate recovery strategy, and provides analytics showing your decline code distribution and recovery rates by code.