Sacar

POST /integration/v1/payouts

{
  "amount": "500.00",
  "pixKey": "fulano@exemplo.com.br",
  "callbackUrl": "https://loja.exemplo.com.br/webhooks/saque/77"
}

O saldo sai na solicitação

No instante em que o saque é criado, o valor sai de available e vai para held. O total da conta não muda — o que muda é o que você pode usar.

Sem isso, uma conta com R$ 100 poderia pedir dois saques de R$ 100 enquanto o primeiro espera, e os dois passariam na checagem de saldo.

Os estados

status	Significa
awaiting_approval	acima do limiar da conta, esperando aprovação humana
approved	aprovado, entrando na fila
executing	em execução
settled	pago — endToEndId disponível
rejected	recusado; a retenção foi devolvida
failed	falhou; a retenção foi devolvida

awaiting_approval não é erro. Acima de um limiar definido para a sua conta, o saque espera aprovação humana do seu provedor. Repetir a chamada só cria um segundo saque — e retém o valor de novo.

Recusa e falha devolvem a retenção integralmente.

Não há segundo fator aqui

O segundo fator existe no painel, para pessoas. Numa integração servidor-a-servidor ele não teria onde morar: o código viajaria junto com a chave de API, o que anula o segundo fator em vez de aplicá-lo.

O que o substitui é a assinatura da chamada mais a janela de aprovação.

Confirmar

Assine payout.settled e payout.failed. O endToEndId do PIX vem no payout.settled e é o que você usa para conciliar com o extrato do recebedor.