Payment statuses

Read status from the payment intent and from webhooks. The merchant portal groups those values into success, pending, failed, and cancelled.

API status	Portal	What to do
`requires_payment_method`	Pending	Waiting for a card. If `last_payment_error` is set, treat it as failed.
`requires_action`	Pending	Card accepted. The customer still has to enter the emailed one-time password. For pay by onramp: the onramp window is open and the customer has not paid yet.
`processing`	Pending	The customer has paid and it is completing: a pay by bank debit clearing, or pay by onramp crypto being delivered. Wait for `succeeded` before you ship.
`succeeded`	Success	Captured. A charge id (`ch_`) is attached. Mark the order paid.
`payment_failed`	Failed	Webhook when the card or one-time password fails. The intent stays `requires_payment_method` and includes `last_payment_error`.
`canceled`	Cancelled	Cancelled before capture. `canceled` and `cancelled` are the same outcome.
`refunded`	Refunded	Charge status after a full refund. The webhook event is `charge.refunded`.