Status Machine

This section shows the status values you receive when integrating with LB Pay: from API responses, webhooks, balance, and statement queries.

Source	When to use
API response	After `POST` or `GET` on Pix In, Pix Out, Refund, or Internal Transfer
Webhook	Asynchronous notification when a transaction reaches a final or relevant state
Balance	Current account snapshot (not a transaction lifecycle)
Statement	Historical ledger lines (settled movements, not pending operations)

Poll the API or wait for a webhook — do not mix both vocabularies for the same decision without mapping the tables in each topic below.

Topics

Topic	Description
Pix In	Deposit / immediate charge lifecycle
Pix Out	Withdraw lifecycle (`POST` and `GET`)
Pix Refund	Refund lifecycle
Internal transfer	Internal transfer lifecycle
Webhooks	Event names and payload `status` values
Balance	Balance snapshot fields
Statement	Statement line classification

Operation	API final status	Typical webhook
Deposit	`PAID`	`pixChargePaid` → `paid`
Deposit	`EXPIRED`	`pixChargeExpired` → `expired`
Withdraw	`SUCCESS`	`pixWithdrawSuccess` → `success`
Withdraw	`REJECTED` / `FAILED`	`pixWithdrawFailed` → `rejected` / `failed`
Refund	`REFUNDED`	`pixRefundSuccess` → `success`
Refund	`NOT_EXECUTED`	`pixRefundFailed` → `failed`

See Webhooks guide for payload fields and delivery rules.