Skip to main content

​
Endpoint

POST https://api.pagou.ai/v2/transfers
A API de Pix Out exige um IP fixo e seguro de origem para as requisições. Chamadas originadas de IPs desconhecidos ou não autorizados serão bloqueadas.
Pix Out para qualquer chave Pix é uma funcionalidade de Banking as a Service (BaaS) e precisa ser habilitada explicitamente. Por padrão, sua conta só está autorizada a solicitar transferências Pix Out para a própria chave Pix.

​
Regras

  • pix_key_type: CPF, CNPJ, EMAIL, PHONE ou EVP
  • amount: valor em centavos, mínimo 100 (R$1,00)
  • description: opcional, máximo 140 caracteres
  • external_ref: opcional, máximo 100 caracteres (usado para idempotência)

​
Exemplo

curl --request POST \
  --url https://api.pagou.ai/v2/transfers \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --data '{
    "pix_key_type": "CPF",
    "pix_key_value": "12345678901",
    "amount": 5000,
    "description": "Pagamento fornecedor",
    "external_ref": "pedido-001"
  }'
Consulte a referência OpenAPI v2 para schema completo e respostas detalhadas.