Enviar um Pix para uma chave
Envie um Pix da sua conta para uma chave CPF, CNPJ, celular, e-mail ou aleatória.
Envie o Pix
Se quiser mostrar o titular antes, consulte a chave.
curl -X POST https://pix.sandbox.payzu.dev/v1/withdraw \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"amount": 20,
"pixKey": "teste@teste.com",
"pixType": "email",
"callbackUrl": "https://webhook.cool/",
"clientReference": "withdraw_98765",
"description": "Weekly payout"
}'{
"id": "PAYZU20260817B3PL8SG5WQ000000",
"status": "PENDING",
"amount": 20,
"type": "WITHDRAW",
"qrCodeText": null,
"qrCodeBase64": null,
"qrCodeUrl": null,
"generatedName": null,
"generatedDocument": null,
"generatedEmail": null,
"payerName": null,
"payerDocument": null,
"payerInstitutionIspb": null,
"payerInstitutionName": null,
"payerAccountNumber": "000000",
"serviceFeeCharged": 1,
"withdrawPixKey": "teste@teste.com",
"withdrawPixType": "email",
"receiverName": null,
"receiverDocument": null,
"receiverInstitutionIspb": null,
"receiverInstitutionName": null,
"receiverAccountNumber": null,
"endToEndId": null,
"createdAt": "2026-08-11T21:51:29.748Z",
"updatedAt": "2026-08-11T21:51:29.748Z",
"paidAt": null,
"clientReference": "withdraw_98765",
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": null
}Referência: Enviar um Pix para uma chave
| Campo | Regra |
|---|---|
amount | Entre cashOutTicketMin e cashOutTicketMax da sua conta, dentro do que resta do DailyWithdrawLimit. Os três vêm em GET /user. |
pixKey, pixType | A chave e o tipo dela, no formato de Tipos de chave Pix. |
clientReference | O id do pagamento no seu sistema. |
callbackUrl | Onde a PayZu avisa o resultado. |
Na resposta, serviceFeeCharged é a tarifa do saque, em reais, e pode ter mais de duas casas decimais. O status costuma vir PENDING; se já vier COMPLETED, trate como resultado final.
Repetir o clientReference com os mesmos dados retorna o saque já criado.
Com dados diferentes, a PayZu recusa com 409. Para tentar de novo um saque cancelado, use uma referência nova.
Confirme o envio
| Status final | O que traz |
|---|---|
COMPLETED | endToEndId, paidAt e os dados do recebedor preenchidos. |
CANCELED ou ERROR | O motivo em cancellationReason. |
Quando o saque entra em processamento, antes do envio, a PayZu debita de balanceAvailable o valor com a tarifa e soma o valor ao consumo do limite diário. Se o saque for cancelado, a PayZu desfaz o débito e libera o limite.
Recomendamos acompanhar o saque pelo callbackUrl ou por um webhook com os eventos TRANSACTION_COMPLETED, TRANSACTION_CANCELED e TRANSACTION_ERROR, cadastrado em Cadastrar webhooks. Os corpos estão em Transação concluída, Transação cancelada e Transação com erro.
Para conferir um caso específico ou recuperar um callback que não chegou, veja Consultar um envio. O PDF do saque sai em Baixar o comprovante.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZS600 | 400 | O valor mínimo do saque é R$ 1,00. |
PZS601 | 400 | O valor máximo do saque é R$ 50.000,00. |
PZS602 | 400 | O valor do saque está fora dos limites da instituição financeira. |
PZS200 | 422 | Saque não permitido para esta conta no momento. |
PZS202 | 422 | Limite diário de saque excedido. |
PZS206 | 422 | Limite diário não configurado para esta conta. |
PZS500 | 424 | Nenhuma instituição financeira disponível para o saque no momento. Tente novamente em instantes. |
Os códigos de autenticação e de validação estão no Catálogo de erros.