# Ecommerce Payment: Declined Card Playbook

A four step vertical timeline of what happens when a card declines, from the same second through the 48 hour hold to release, with common causes named.

- Page: https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/declined-card-playbook
- Collection: [Ecommerce](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro), Standard tier
- Group: [Payments](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/declined-card-playbook.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/ecommerce-pro-payment-sections-declined-card-playbook
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- Installs to: `@/components/blocks/ecommerce-pro/payment-sections/declined-card-playbook`

## About this block

Declined Card Playbook writes down the sequence a store
usually hides behind a red banner. Four steps run down a
vertical timeline: the same second, when nothing is
charged and no hold is placed; within a minute, when one
email carries the actual reason the bank gave; across the
next 48 hours, when the cart and the stock stay reserved
under the buyer email; and after the hold releases, when
the store goes quiet with no retry reminders. Each step
pairs a numbered node with a moment label and one plain
paragraph.

Steps are a single array rendered as connected nodes, so
adding or reordering a moment needs no layout change. The
closing footnote names the honest cause most buyers never
hear: the common decline is not an empty account but the
bank fraud model flagging a first purchase, which one call
to the number on the card clears faster than any retry.

## When to use

Reach for this block near the
[checkout](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/checkouts) flow or in the
[FAQ](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/faq-sections) under the
payment topic, written down before a decline ever happens
so the buyer meets calm instructions instead of a dead
end. It pairs naturally with a
[resolution](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/resolution-sections)
path for the case that needs a person.

A natural flow around it on an Ecommerce Pro page:

**Before**

- [Checkout flow](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/checkouts)

**After**

- [Payment FAQ](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/faq-sections)
- [Contact routes](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/contact-sections)

## What you can display

One strong use is the four step decline sequence. Other
recovery timelines fit the same nodes:

- **Expired card path.** The same steps ending in a one
  field update rather than a bank call.
- **3DS challenge.** The extra verification moment slotted
  between the attempt and the approval.
- **Payment retry window.** A longer hold for a high value
  order with the stock reserved further out.

> Tip: promising one email total, and then keeping that
> promise with no countdown or recovery discount, is the
> detail that makes the calm tone believable.

## More in Ecommerce Payments

- [Accepted Methods Row](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/accepted-methods-row)
- [Bank Transfer Invoice Card](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/bank-transfer-invoice-card)
- [Installments Honest Math](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/installments-honest-math)
- [Multi Currency Pricing Table](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/multi-currency-pricing-table)
- [No Surcharge Receipt](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/no-surcharge-receipt)
- [Payment Security Explainer](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/payment-security-explainer)
- [Refund Speed By Method](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/refund-speed-by-method)
- [Saved Card Controls](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/saved-card-controls)
- [Why No Crypto Card](https://www.shadcn-ui-blocks.com/blocks/ecommerce-pro/payment-sections/why-no-crypto-card)
