Card Payments

A card payment is a sequence of financial operations shared by several parties. The merchant creates the sale, a gateway or PSP exposes the integration, the acquirer sponsors the merchant side, the network routes messages, and the issuer decides whether the cardholder account can authorize the amount. One company may bundle several roles, but the state transitions remain distinct.

The application should store the operation, amount, currency, attempt ID, provider reference, and current evidence. “The PSP approved it” is too vague to decide whether goods can ship, funds can be paid out, or a later dispute needs a new journal entry.

Authorization Through Payout

TransitionWhat it provesWhat it does not prove
AuthorizationThe issuer approved the request and usually reserved spending capacityThe merchant received funds
CaptureThe merchant submitted an authorized amount for financial processingClearing or settlement completed
ClearingParticipants exchanged and validated financial records and calculated obligationsCash reached the merchant’s bank
SettlementParticipants discharged obligations according to the railA merchant payout arrived or cannot be returned
PayoutThe PSP instructed available funds to an external bank accountThe destination bank made them irrevocably available

A useful state machine admits more than the happy path:

REQUIRES_METHOD -> REQUIRES_ACTION -> AUTHORIZED
AUTHORIZED -> CAPTURE_PENDING -> CAPTURED -> SETTLEMENT_PENDING -> SETTLED
CAPTURED -> REFUND_PENDING -> REFUNDED
CAPTURED | SETTLED -> DISPUTED -> CHARGEBACK_POSTED | DISPUTE_WON

Also model DECLINED, CANCELED, EXPIRED, and UNKNOWN. A timeout after capture submission is not a decline; Payment Reliability owns the recovery rules. Settlement and payout evidence belong beside the journals described in Payment Ledgers and Reconciliation.

Authorization and Capture Are Business Decisions

Use separate authorization and capture when fulfillment must occur later. A hotel can authorize 300.00 USD, capture 247.50 USD after checkout, and cancel the unused hold. A merchant shipping immediately can capture with authorization and remove the extra failure window.

An uncaptured authorization is reversed or expires. Once captured, returning value is a refund linked to the original operation. A chargeback is not a refund: the cardholder disputes through the issuer, the scheme opens a case, and the merchant may lose funds while evidence is reviewed. Preserve the original capture and post refunds, reversals, and disputes as new operations. Rewriting CAPTURED to FAILED destroys the accounting lineage.

Fulfillment Boundary

Do not fulfill from a browser redirect. The customer can close the tab after issuer approval but before the redirect reaches the merchant. Fulfill from a verified server event or a provider lookup, and make the fulfillment operation idempotent. A later refund or dispute changes the financial position; it does not mean the original fulfillment never happened.

Rejected Lifecycle Visual

The historical card visual is not embedded because it treats an issuer hold as frozen money, fixes capture and funding to one end-of-day schedule, and collapses capture, clearing, interbank settlement, and merchant funding. Timing varies by merchant, acquirer, network, region, and exception path. The timing-neutral lifecycle above is the safer reusable model.

References

  • Visa Developer glossary — network definitions for authorization, clearing, settlement, acquirers, and issuers.
  • Adyen capture — official authorization/capture separation, partial capture, cancellation, and asynchronous capture results.
  • Stripe refunds — official refund behavior and its relationship to the original successful payment.
  • Stripe disputes — official chargeback lifecycle, evidence window, and balance impact.