Lifecycle - Documentation - PayNext

Payments follow a unified status flow regardless of processor, making it easy to build consistent payment experiences. Depending on the payment method, a payment may skip statuses that do not apply to it.

Status Flow

Some payment methods have no authorization/capture separation. Instant account-to-account methods such as Pix (Pix Automático) never enter AUTHORIZED — the payment moves from PENDING directly to SETTLING or SETTLED.

Status Definitions

Status	Description
`PENDING`	Payment created, awaiting processing
`AUTHORIZED`	Funds reserved with issuer, awaiting settlement
`SETTLING`	Settlement in progress with processor
`SETTLED`	Funds transferred, payment complete
`INCOMPLETE`	Customer abandoned checkout (e.g., closed 3DS modal)
`DECLINED`	Rejected by issuer or processor
`FAILED`	Technical error prevented processing
`BLOCKED`	Denied by workflow rules before processing
`CANCELLED`	Payment voided before settlement completed

Refunds can be issued for payments in SETTLING or SETTLED status. Refunded payments retain their original status—refund details are returned as a separate object in the API response and can be filtered in the Dashboard.

⌘I