PayZu PixPagar com Pix

Enviar um Pix para uma chave


Nesta páginaEnvie o PixConfirme o envioErros desta operação

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.

bash
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"
  }'

Referência: Enviar um Pix para uma chave

CampoRegra
amountEntre cashOutTicketMin e cashOutTicketMax da sua conta, dentro do que resta do DailyWithdrawLimit. Os três vêm em GET /user.
pixKey, pixTypeA chave e o tipo dela, no formato de Tipos de chave Pix.
clientReferenceO id do pagamento no seu sistema.
callbackUrlOnde 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 finalO que traz
COMPLETEDendToEndId, paidAt e os dados do recebedor preenchidos.
CANCELED ou ERRORO 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ódigoHTTPMensagem
PZS600400O valor mínimo do saque é R$ 1,00.
PZS601400O valor máximo do saque é R$ 50.000,00.
PZS602400O valor do saque está fora dos limites da instituição financeira.
PZS200422Saque não permitido para esta conta no momento.
PZS202422Limite diário de saque excedido.
PZS206422Limite diário não configurado para esta conta.
PZS500424Nenhuma 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.