Transfer Statuses - Pagou Developer Docs

Use one shared status map for product, operations, and support.

API resource statuses

Status	Meaning	Typical action
`pending`	accepted but not final	monitor
`scheduled`	queued for future execution	keep scheduled
`in_analysis`	additional review is required	keep queued and visible to operators
`processing`	settlement in progress	wait for webhook or reconcile
`paid`	settled successfully	mark payout completed
`rejected`	cancelled at the banking partner after submission	funds are not returned automatically; check your balance and contact support before re-sending
`cancelled`	stopped before execution or reversed afterwards	a stopped payout returns the funds; after a reversal, confirm your balance before closing the request
`error`	failed during processing	investigate retry policy
`unknown`	not yet normalized	reconcile immediately

Webhook event mapping

Resource status and webhook event names are not identical.

payout.transferred maps to resource status paid
payout.failed maps to resource status error
payout.rejected maps to resource status rejected
payout.canceled maps to resource status cancelled

Why this matters

If your product displays event names as resource statuses, operator tooling becomes ambiguous. Keep one canonical mapping and reuse it across webhook handlers, dashboards, and reconciliation jobs.

Read next