Para quem vende · API e webhooks
API: saque Pix para a chave de outra pessoa
Com o saque para terceiros liberado na sua conta, POST /gateway/transfers com o nome e o documento de OUTRA pessoa manda o Pix para a chave dela. Vale o limite por vez e o diário de terceiros, sai só do saldo do Pix e, por padrão, passa pela análise da equipe (PENDING até sair).
Passo a passo
- Peça ao suporte para liberar o saque para terceiros na sua conta (vem desligado).
- Chame POST /gateway/transfers com identifier, amount, pix e owner com o nome completo e o CPF/CNPJ do terceiro; chave CPF/CNPJ tem de ser o documento informado.
- Acima do limite diário de terceiros a resposta é 400 GATEWAY_OUT_OF_RANGE: tente no dia seguinte ou peça revisão do limite.
- Acompanhe pelos webhooks de transferência: o saque fica PENDING enquanto a equipe analisa.
- O mesmo identifier devolve o mesmo saque (seguro repetir depois de um 504).
Isso ajudou?
