POST /v3/pix/payment
Solicite um saque ao titular. Escopo cashout.
POST /v3/pix/payment
Obrigatórios: valor e chave_pix não vazia. Aceitos: nome (nome do destinatário), cpf (documento do destinatário), descricao e urlnoty. Em produção, é necessário ter permissão cashout, MFA na conta, IP autorizado, saldo suficiente incluindo tarifas, destino de titularidade da conta e atender aos requisitos de KYC e limites aplicáveis. O saque é destinado ao titular da conta; não permite transferências genéricas a terceiros.
Envie um header Idempotency-Key único, de 1 a 128 caracteres, para cada saque desejado; reutilize a chave com o mesmo corpo ao repetir a chamada. Alterar o corpo mantendo a chave pode gerar conflito de idempotência. Sem esse header, o mesmo valor e a mesma chave PIX dentro de 120 segundos reutilizam o saque. Dois saques idênticos intencionais precisam de chaves distintas.
{
"statusCode": 200,
"message": "Saque PIX processado com sucesso",
"transactionId": "TRANSACTION_ID"
}Um saque aceito e retido para análise retorna message "Saque PIX recebido e em análise". Um alerta de fraude/MED aberto, outro saque em processamento ou saques automáticos desabilitados podem causar análise. HTTP 200 não garante liquidação final; consulte a transação. O sandbox retorna message "Saque PIX simulado com sucesso (Sandbox)." e mode: "sandbox"; nunca transfere dinheiro real. Acima dos limites de produção por transação ou por dia, a chamada é rejeitada antes do débito, sem retenção para análise.