Skip to main content
Use this page for the write path that creates outbound payouts.

Example

curl --request POST \
  --url https://api.pagou.ai/v2/transfers \
  --header "Authorization: Bearer YOUR_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "external_ref": "payout_9001",
    "amount": 1200,
    "currency": "BRL",
    "pix_key": "merchant@example.com",
    "recipient_name": "Ada Lovelace"
  }'

What to persist

  • your payout request ID
  • Pagou transfer id
  • transfer status
  • Pagou requestId

Production note

Treat the create response as an initial acknowledgement only. Final operational state belongs to the webhook and reconciliation model.