No ambiente de teste o saque segue o mesmo fluxo da produção (resposta com statusANALYSISe webhookspix_out.analysisepix_out.paid), mas não passa por banco nenhum: o pagamento é simulado, o saldo de teste é debitado e nenhum dinheiro é movimentado.
Como funciona
- Solicite o saque — Informe o valor, a chave PIX de destino e os dados do beneficiário. O saldo é reservado automaticamente e a resposta retorna com status
ANALYSIS - Acompanhe pelo webhook — Cadastre um endpoint assinando os eventos
pix_out.*(pix_out.paid,pix_out.rejected,pix_out.error,pix_out.refunded) para receber atualizações automáticas sobre o processamento - Consulte quando precisar — Verifique o status do saque a qualquer momento
Status do Saque
Devolução pelo recebedor
O recebedor pode devolver um saque pago em uma ou mais devoluções parciais. A devolução também acontece quando o banco do recebedor devolve um pagamento já concluído (por exemplo, conta encerrada ou bloqueada); nesse caso costuma vir uma única devolução do valor total. Cada devolução concluída no banco é creditada no seu saldo disponível pelo valor que voltou (a taxa do saque não é devolvida) e gera um eventopix_out.refunded: com status PARTIALLY_REFUNDED e partial: true enquanto a soma das devoluções não chega ao valor do saque, e com status REFUNDED e partial: false na devolução que completa o valor. O saque continua PAID até completar o valor; ao completar, passa a REFUNDED. Veja Devoluções no webhook na seção Webhooks.
Webhook de Saques
Quando o status de um saque é atualizado, você recebe uma notificação nos endpoints que assinam os eventospix_out.*.
Exemplo de payload:
A URL do endpoint deve retornar HTTP 200 para confirmar o recebimento. Em caso de falha, o sistema reenvia com backoff exponencial. Veja Configurar webhooks para detalhes de eventos e validação da assinatura HMAC.