Troubleshoot card payment declines
Card declines happen when the issuer, validation rules, or checkout configuration blocks payment before an approved sale exists. A decline is different from a chargeback, which occurs after approval, and different from a refund initiated by the seller.
Use this guide when buyers cannot complete card payment, when declined attempts appear in Sales, or when a campaign shows traffic but weak card approval rates.
Decline patterns
| Symptom | Likely cause | First place to check |
|---|---|---|
| Buyer sees payment declined | Issuer rejection or gateway decline | Sales |
| Card form will not submit | Validation error or missing required fields | Live checkout link |
| Installments look wrong | Installment settings do not match the offer | Plan and offer |
| Subscription charge confusing | Trial or renewal terms unclear | Checkout copy and subscriptions |
| No card option shown | Payment method not enabled for the offer | Offer settings |
Investigation workflow
- Confirm the correct business workspace.
[Screenshot: App header — correct business workspace selected.]
- Search Sales by buyer email and widen the date range.
[Screenshot: Sales search — buyer email with extended date range.]
- Open the declined attempt and note status, offer, and payment method.
[Screenshot: Sale detail — declined card attempt with offer visible.]
- Confirm the offer allows card payments in payment methods.
[Screenshot: Offer payment methods — card enabled on the offer.]
- Open the same checkout link as a buyer.
[Screenshot: Live checkout — card payment form visible.]
- Review price, installments, trial, and subscription copy.
[Screenshot: Checkout copy — price and payment terms match offer.]
- Test with a different card when possible.
[Screenshot: Alternate card test — decline or success result noted.]
- Review Financial Overview error tabs if declines spike during a campaign.
[Screenshot: Financial Overview errors tab — decline spike visible.]
- Collect buyer email, checkout link, approximate time, and error message before escalation.
[Screenshot: Escalation ticket — decline evidence documented.]
Decline vs chargeback vs refund
| Event | When it happens | Guide to use |
|---|---|---|
| Card decline | During checkout | This article |
| Refund | Seller or support returns money after approval | Process refunds |
| Chargeback | Buyer disputes through payment provider | Chargebacks and disputes |
What to tell buyers
- Declines are often decided by the card issuer, not the seller.
- Trying another card or PIX may work when available.
- Installments and subscription terms on checkout should match what support explains.
- A declined attempt does not create an approved sale or delivery entitlement.
Best practices
- Align checkout copy with actual payment method and pricing settings.
- Train support to find declined attempts in Sales.
- Review decline spikes by offer, funnel step, and campaign link.
- Use incomplete payment recovery when follow-up is part of the workflow.
- Test mobile checkout because many card attempts happen on phones.
Common mistakes
- Treating declines as chargebacks.
- Changing pricing mid-campaign without retesting checkout links.
- Promising access after a declined attempt.
- Ignoring installment or subscription copy mismatches.
- Investigating campaign attribution before confirming the buyer could pay at all.
FAQ
Is a declined card the same as a chargeback?
No. A decline stops payment at checkout. A chargeback is a dispute after an approved sale. See chargebacks and disputes.
Why did one buyer succeed and another fail on the same offer?
Issuers, card limits, fraud checks, and buyer input differ. Compare both attempts in Sales and confirm they used the same checkout link.
Can I recover declined checkout attempts?
Sometimes. Review recover incomplete payments and support follow-up rules.