PayZu Pix

Pagar com Pix


Nesta páginaModalidadesAntes e depois de pagarRegras de toda saída

Envie um Pix para uma chave, pague um QR Code ou transfira saldo para outra conta PayZu.

Fluxo do envio: o Pix é enviado, a transação fica PENDING com o valor e a tarifa debitados e termina COMPLETED, com comprovante, ou CANCELED, com o débito desfeito

Toda saída vira uma transação WITHDRAW da sua conta e dispara os mesmos eventos de callback. O id da resposta serve para consultar o status, baixar o comprovante e localizar o callback.

Modalidades

ModalidadeQuando usarRota
Enviar um Pix para uma chaveVocê tem a chave Pix do recebedor.POST /withdraw
Pagar um QR CodeVocê tem o QR Code (estático ou dinâmico) ou o copia e cola da cobrança.POST /pix/qrcode/read e POST /withdraw/qrcode
Transferir entre contas PayZuO destino é uma conta PayZu e você tem o número dela.POST /internal-transfer

Antes e depois de pagar

O formato de cada chave está em Tipos de chave Pix.

Regras de toda saída

RegraComo funciona
ValorEm reais, com até duas casas decimais, como "amount": 150.5.
LimitesCada saída respeita o valor por operação (cashOutTicketMin e cashOutTicketMax) e o limite diário (DailyWithdrawLimit), que vêm em GET /user.
ResultadoPix para chave e pagamento de QR Code costumam voltar PENDING, com o resultado final no callback. A transferência entre contas já volta COMPLETED na resposta.
clientReferenceEnvie em toda saída. Com a mesma referência e os mesmos dados, a PayZu retorna a transação já criada; com dados diferentes, recusa com 409. Veja Idempotência.
IPPara pagar pela API, a conta precisa ter o IP de saída cadastrado. Sem IP, ou de um IP fora da lista, a resposta é 403. Veja IP cadastrado.