## TL;DR

The issuer rejected the charge for insufficient funds even though the account shows a balance: pending holds reduce the available amount, or the transaction was sent in installments that the debit card cannot support. Retry as a single debit payment, ask the customer to check pending authorizations, or offer another method. The balance the customer sees is not always the balance available to authorize against.

```text
mercadopago cc_rejected_insufficient_amount on a debit card with balance
```

## Use this when

- Mercado Pago rejects a debit card with cc_rejected_insufficient_amount despite a visible balance
- The payment was sent with installments
- You need fallback logic for debit declines

## Not for this skill when

- A credit card is declined for its limit (different issuer logic)
- The card number itself is malformed
- You are debugging Mercado Pago API authentication

## Steps

1. Check how the payment was sent: installments on a debit card are a common trigger.
   Expected: You know whether installments were requested.
2. Retry the payment as a single debit charge with one installment.
   Expected: The installment-related rejection is ruled out.
3. Ask the customer to check for pending holds that reduce the available balance.
   Expected: Hidden holds are surfaced.
4. Offer an alternative: another card, Pix, or boleto, depending on the market.
   Expected: The customer can complete the purchase.
5. Log the decline pattern: repeated insufficient_amount on debits with balance suggests an installments misconfiguration on your side.
   Expected: A systemic cause is caught.

## Tool compatibility

Mercado Pago payments API; cc_rejected_insufficient_amount is an issuer response passed through by Mercado Pago.

## Variant phrasings

### mercadopago debit card insufficient amount with balance

The paradox stated from the customer's view.

### cc_rejected_insufficient_amount installments debit

Names the installments trigger.

### mercadopago issuer rejected debit balance available

The issuer-side framing.

## Why it happens

Issuers authorize against the available balance, not the ledger balance: pending pre-authorizations, holds, and daily debit limits all shrink what is actually spendable. Additionally, some issuers reject installment plans on debit products outright, returning an insufficient-amount style decline. Mercado Pago passes the issuer's verdict through unchanged. The customer's app balance and the authorizable balance are two different numbers, which is why the decline looks wrong to the shopper.

## Edge cases / pitfalls

- Defaulting debit checkouts to one installment avoids the most common misconfiguration.
- The decline is issuer-side: retrying rapidly can stack more holds and make it worse.
- In Brazil and Mexico, Pix is a strong fallback when debit keeps failing.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_AILJi6XUvhUWzCCszGaFuA