> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar transferência Pix

> Crie uma solicitação de transferência e persista o ID retornado pela Pagou.

Use esta página para o caminho de escrita que inicia um payout.

## Exemplo de requisição

```bash theme={null}
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://shop.example/webhooks/pagou/transfers"
  }'
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
    "status": "pending",
    "amount": "1200",
    "pix_key_type": "EMAIL",
    "external_ref": "payout_1001",
    "created_at": "2026-03-16T14:00:00.000Z"
  }
}
```

## Erro comum

Status `422`

```json theme={null}
{
  "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

* [Cancelar transferência Pix](/pt/payouts/pix-out/cancel-transfer)
* [Reconciliação de transferências](/pt/payouts/pix-out/reconciliation)