Pular para o conteúdo principal
Use esta página para o caminho de escrita que inicia um payout.

​
Exemplo de requisição

curl --request POST \
  --url https://api.pagou.ai/v2/transfers \
  --header "Authorization: Bearer SEU_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "pix_key_type": "EMAIL",
    "pix_key_value": "supplier@example.com",
    "amount": 1200,
    "description": "Supplier payout",
    "external_ref": "payout_1001",
    "notify_url": "https://merchant.example/webhooks/pagou/transfers"
  }'

​
Exemplo de resposta

{
  "success": true,
  "requestId": "req_2001",
  "data": {
    "id": "po_1001",
    "status": "pending",
    "amount": 1200,
    "pix_key_type": "EMAIL",
    "external_ref": "payout_1001",
    "created_at": "2026-03-16T14:00:00.000Z"
  }
}

​
Erro comum

Status 422 
{
  "type": "https://api.pagou.ai/problems/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The request contains invalid data.",
  "errors": [
    {
      "field": "pix_key_value",
      "message": "Invalid PIX key value",
      "code": "invalid_string"
    }
  ]
}
Como corrigir: envie o pix_key_type correto e um pix_key_value compatível. Não documente nem dependa de campos não suportados como recipient_name.

​
O que persistir

  • seu ID de solicitação de payout ou external_ref
  • o id da transferência na Pagou
  • o status atual da transferência
  • o requestId da Pagou

​
Observação de produção

Trate a resposta de criação como um aceite inicial, não como liquidação final. O estado operacional final pertence ao webhook e à reconciliação.

​
Próximos passos