Payments and payouts

The statuses you will see, and what moves them.

Payment

Status	Meaning
`pending`	Waiting to be paid. New attempts are allowed.
`paid`	The money was received. Final.
`expired`	Nobody paid before `expiresAt`. Final.

A payment has one or more attempts, one per try at paying. Only one attempt runs at a time (409 attempt_in_progress otherwise). An attempt is requires_action (show the payer what nextAction asks), processing, succeeded, failed or expired.

amount is what you asked for. amountReceived is what arrived. fees and net show what Zeny keeps and what you receive, and settlement shows when the money reaches your balance (pending, then settled).

Payout

Status	Meaning
`pending_approval`	Waiting for a person on your team to approve it in the dashboard.
`processing`	Approved and on its way to the bank or e-wallet.
`paid`	Delivered. Final.
`failed`	Failed after it was approved. Final.
`rejected`	An approver refused it. Final.
`canceled`	You canceled it before it was processed. Final.

Disputes

A payer can dispute a payment through their bank. A dispute is open while it is decided, then won or lost. While it is open, the disputed amount is held back from your balance. Read them with GET /api/merchant/v1/disputes, and expect dispute.opened and dispute.closed webhooks.