Skip to main content

​
Fluxo de transferência Pix Out (cash-out)

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.

​
Passo 1: criar transferência

Use POST /v2/transfers com a chave Pix do destinatário e o valor em centavos (mínimo R$1,00 = 100 centavos).

​
Passo 2: acompanhar status

  • Webhook como principal canal de notificação
  • GET /v2/transfers/{id} como fallback/reconciliação

​
Passo 3: cancelar (se necessário)

Use POST /v2/transfers/{id}/cancel para cancelar uma transferência que ainda esteja com status pending.
Apenas transferências com status pending podem ser canceladas. Após o início do processamento, o cancelamento não é possível.

​
Passo 4: reconciliar

Use GET /v2/transfers com filtros de status e paginação para conciliação operacional.
Para detalhes de payload e resposta, consulte os endpoints da seção Transfers ou a referência OpenAPI v2.