Status Lifecycle

Quick Reference

WhatCharge status reference

WhyTrack every state in the payment lifecycle

Every charge moves through a series of statuses from creation to settlement. Understanding these transitions lets you build integrations that react correctly at each stage and handle edge cases gracefully.

Transitions vary by method

Exact transitions depend on the payment method, capture mode (auto vs manual), and acquirer. The diagram below shows the full superset of possible transitions.

Status order

1. issued — Charge created, not yet sent to acquirer
2. pending — Sent to acquirer, awaiting response
3. confirmed — Acquirer authorized the transaction
4. pre_captured — Capture requested, awaiting confirmation
5. paid — Funds captured successfully
6. refunded — Full or partial refund completed
7. refund_error — Refund attempt failed
8. pre_chargeback_resolution — Dispute opened, evidence window active
9. chargeback — Dispute lost, funds debited
10. chargeback_requested — Cardholder initiated dispute with issuer
11. chargeback_reversed — Dispute resolved in merchant favor
12. chargeback_refunded — Merchant refunded disputed charge
13. canceled — Charge voided before capture
14. error — Terminal failure from acquirer or gateway

State transitions

What to do at each status

Status	Meaning	Terminal?	Your action
issued	Charge created locally	No	Wait for acquirer submission
pending	Awaiting acquirer response	No	Wait for webhook notification
confirmed	Authorization approved	No	Capture manually or wait for auto-capture
pre_captured	Capture in progress	No	Wait for capture confirmation webhook
paid	Funds captured	No	Fulfill the order and send receipt
refunded	Refund completed	Yes	Notify customer, update accounting records
refund_error	Refund failed	Yes	Retry refund or escalate to A55 support
pre_chargeback_resolution	Dispute evidence window	No	Gather evidence and submit before deadline
chargeback	Dispute lost	Yes	Record debit, review fraud patterns
chargeback_requested	Dispute initiated	No	Prepare evidence for representment
chargeback_reversed	Dispute won	No	Returns to paid, no action needed
chargeback_refunded	Disputed charge refunded	Yes	Record final settlement adjustment
canceled	Voided before capture	Yes	No funds moved, safe to discard
error	Terminal failure	Yes	Log error, retry with a new charge if appropriate

Response Codes →Charge Webhooks →Create a Charge →