Para quem vende · API e webhooks

API: saque Pix, IPs autorizados e resposta 504

POST /gateway/transfers faz o saque Pix para a chave do mesmo titular, só de IPs autorizados na tela da API. Um 504 não é falha: espere o webhook e consulte antes de repetir com identifier novo.

Passo a passo

Cadastre os IPv4 públicos do seu servidor em Integrações › API › IPs autorizados (pede o 2FA).
Chame POST /gateway/transfers com identifier, amount, pix e owner (IP do usuário final, nome e documento).
Acompanhe pelos webhooks de transferência ou por GET /gateway/transfers.
Recebeu 504? Não repita na hora: aguarde o webhook e consulte.

Já tem conta? Este passo a passo fica em Abrir API, no painel.

Isso ajudou?

Artigos relacionados

API: saque Pix para a chave de outra pessoaCom 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).
API: reportar bug, chave vazada e erro de IP no saqueEm Fale com o suporte, os tipos "Bug na API", "Minha chave da API vazou" e "IP não autorizado no saque" pedem os dados certos: endpoint, resposta com o requestId, passos e horário; no erro de IP, também o IP cadastrado e o IP de saída. Chaves e cartão colados são mascarados.
Como solicitar um saqueO saque sai do saldo disponível para a sua chave Pix cadastrada. A tela confere o valor antes de qualquer código: abaixo do mínimo, acima do máximo, acima do limite do dia ou do seu saldo, o motivo aparece embaixo do campo e o pedido nem sai. Com o valor certo, confirmamos que é você com um código (do app autenticador ou do e-mail), numa janela que abre depois do clique e diz o que você está confirmando: o valor que sai do saldo, a chave (mascarada) e quanto você recebe. O botão Tudo preenche o maior valor que dá para pedir agora, já com a taxa de saque e os limites (disponível, máximo por saque, limite do dia e o 1º saque da chave nova): com a taxa descontada, o saldo inteiro sai e você recebe o saldo menos a taxa; com Receber o valor exato, o campo fica com o saldo menos a taxa. A linha embaixo do campo diz, antes do clique, quanto sai do saldo e quanto chega (ex.: "Tudo usa R$ 150,00 do saldo. Você recebe R$ 145,01 (taxa R$ 4,99).") ou por que não dá. O valor de reembolsos já pedidos das suas vendas fica reservado (aparece como "Reservado para reembolsos pedidos") até o reembolso ser concluído ou recusado.
Saldo e saques: os saldos da conta e o saldo compensadoNo topo de Saldo e saques, os saldos da conta que não mudam com o período: disponível para saque, a liberar (só quando há valor), retido, em contestação e total sacado. Conta sem saldo nenhum e sem saque vê uma linha só ("Sem saldo ainda") no lugar dos cartões zerados. No Histórico, uma linha com o resumo do período (concluído, pendente e falhou ou cancelado) segue o filtro da tabela, e cada linha da tabela abre o saque. Se um método ficar negativo (por exemplo, uma contestação no cartão), o positivo do outro compensa: o disponível é o total real e aparece o aviso "Disponível diferente do saldo real"; com o total zerado ou negativo, o saque volta quando ficar positivo.