Skip to main content
Use Pix Out when your platform sends money out to suppliers, sellers, or internal payout recipients.

​
Public operations

  • POST /v2/transfers
  • GET /v2/transfers
  • GET /v2/transfers/{id}
  • POST /v2/transfers/{id}/cancel

​
Operating model

  1. Create the transfer from your backend.
  2. Persist your payout reference, Pagou transfer ID, and requestId.
  3. Treat webhook delivery as the primary state update path.
  4. Reconcile with GET /v2/transfers/{id} when the state is uncertain.
  5. Allow cancellation only from states your operators can safely stop.

​
Status vocabulary

Use API resource status for payout state and webhook event names for transitions.
  • Resource statuses: pending, scheduled, in_analysis, processing, paid, rejected, cancelled, error, unknown
  • Webhook events: payout.created, payout.in_analysis, payout.processing, payout.transferred, payout.failed, payout.rejected, payout.canceled