Enviar Pix
Caminho 1: por chave Pix
Executar o saque
Use POST /withdraw com a chave do destinatário. pixType aceita: cpf, cnpj, phone, email, evp.
curl -X POST https://api.exemplo.processamento.com/v1/withdraw \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"amount": 250.00,
"pixKey": "joao@example.com",
"pixType": "email",
"callbackUrl": "https://seusite.com.br/webhooks/pix",
"clientReference": "payout-2025-08-001",
"description": "Pagamento referente ao pedido #1234"
}'const res = await fetch('https://api.exemplo.processamento.com/v1/withdraw', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PIX_TOKEN}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 250.00,
pixKey: 'joao@example.com',
pixType: 'email',
callbackUrl: 'https://seusite.com.br/webhooks/pix',
clientReference: 'payout-2025-08-001',
description: 'Pagamento referente ao pedido #1234',
}),
});
const withdraw = await res.json();res = requests.post(
'https://api.exemplo.processamento.com/v1/withdraw',
headers={
'Authorization': f'Bearer {os.environ["PIX_TOKEN"]}',
'Content-Type': 'application/json',
},
json={
'amount': 250.00,
'pixKey': 'joao@example.com',
'pixType': 'email',
'callbackUrl': 'https://seusite.com.br/webhooks/pix',
'clientReference': 'payout-2025-08-001',
'description': 'Pagamento referente ao pedido #1234',
},
)Caminho 2: por QR Code
Executar o pagamento
POST /withdraw/qrcode. Se o QR já tem valor embutido, amount pode ser omitido.
curl -X POST https://api.exemplo.processamento.com/v1/withdraw/qrcode \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"qrCode": "00020126870014br.gov.bcb.pix...",
"amount": 100.00,
"callbackUrl": "https://seusite.com.br/webhooks/pix",
"clientReference": "payout-qr-2025-08-001"
}'Acompanhar status
O saque começa PENDING e evolui para COMPLETED, CANCELED ou ERROR. O callback chega em cada transição. Para consultar manualmente via GET /withdraw:
curl "https://api.exemplo.processamento.com/v1/withdraw?clientReference=payout-2025-08-001" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"Comprovante
Após COMPLETED, baixe o comprovante oficial via GET /withdraw/proof/{id}:
curl "https://api.exemplo.processamento.com/v1/withdraw/proof/PIX2025..." \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"Erros comuns
| Erro | Resolução |
|---|---|
| Saldo insuficiente | Confira GET /user/balance antes |
| Chave Pix inválida | Confira a chave e o pixType antes de enviar |
| Valor abaixo do mínimo | amount ≥ R$ 0,01 (chave) ou ≥ R$ 0,10 (QR) |
| Destinatário diferente | O TrueHolder bloqueia documento divergente |
Receber pagamento Pix
Fluxo completo para receber dinheiro de um cliente via Pix. Você cria a cobrança, exibe o QR Code, processa o callback de COMPLETED e implementa polling como fallback. Código pronto em curl, Node, Python, Go e PHP.
Transferência interna
Quando origem e destino são contas Pix Processamento, você pode mover saldo entre elas sem passar pelo Pix tradicional. Liquidação instantânea, identificação por accountNumber. Ideal para repasses internos entre matriz/filial ou pagar parceiros Pix Processamento.