Learn Anatomy of a Checkout

Lesson 4 of 13

Payment states.

The life of a payment as a state machine: created, authorized, captured, settled, refunded, and disputed.

By Nagesh Koritala 4 min read Last verified: November 2026

  1. Lesson 1: Improve the checkout
  2. Lesson 2: The checkout flow
  3. Lesson 3: Authorization
  4. Lesson 4: Payment states (this lesson)
  5. Lesson 5: Capture
  6. Lesson 6: Clearing and settlement
  7. Lesson 7: Cash capture
  8. Lesson 8: Returns and refunds
  9. Lesson 9: Disputes
  10. Lesson 10: Tokens and stored credentials
  11. Lesson 11: Transaction types
  12. Lesson 12: Complete reference
  13. Lesson 13: Payments compliance
All 16 pages in this guide
  1. Improve the checkout
  2. The checkout flow
  3. Authorization
  4. Payment states
  5. Capture
  6. Clearing and settlement
  7. Cash capture
  8. Returns and refunds
  9. Disputes
  10. Tokens and stored credentials
  11. Transaction types
  12. Complete reference
  13. Payments compliance
  14. Follow one order
  15. Where it breaks
  16. Payments dictionary

Engineers model a payment as a state machine. It helps product people too, because every bug report and every support ticket is really a question about which state a payment is in. Press the actions below and watch where the payment can and cannot go.

This is the simplified model. For the exact statuses real providers use for payments, refunds, disputes, subscriptions, invoices, and payouts, see the Statuses tab in lesson 12.

Payment state machine

Sources for this guide

Card network rules change. Time limits, fees, and authorization windows here reflect published rules and provider documentation as of late 2026; confirm details with your processor before you build against them.

Sources

Your progress stays on this device.

Next: Lesson 5

Capture.

Charging when goods ship: split shipments, partial captures, and reauthorization when a hold expires.

Questions about payments? Email me. I read every note.

Capture: charge each package when it ships, one capture per shipment. $$charge when it ships