PayZu Conta HubPagar com Pix

Pagar um Pix copia e cola


Nesta páginaAntes de pagarPague o códigoConfirme a entregaErros desta operação

Quite com o saldo da conta um código Pix copia e cola, estático ou dinâmico. Valem os limites e o teto diário do saque, com a tarifa própria que aparece em Consultar os limites e as tarifas.

Antes de pagar

Pague o código

  • brCode: o código exatamente como o usuário colou.
  • Idempotency-Key: uma nova por pagamento.
  • amount: obrigatório quando o código não fixa o valor. No código dinâmico, mande também quando o código fixar o valor, com o valor que o usuário conferiu na consulta do recebedor.
  • comment: o texto que o recebedor vai ver.
bash
IDEMPOTENCY_KEY=$(uuidgen)

curl --request POST \
  --url 'https://api.sandbox.payzu.dev/api/v1/transactions/pix/qr-payments' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "brCode": "00020126400014br.gov.bcb.pix0118fulano@exemplo.com520400005303986540525.005802BR5913FULANO DE TAL6009SAO PAULO62140510PEDIDO482163048572",
    "comment": "Pedido 4821"
  }'

Referência: Pagar um Pix copia e cola

O valor de um código dinâmico pode mudar depois da leitura.

Um valor diferente no pagamento é recusado, sem débito.

Para repetir, use a mesma Idempotency-Key e o mesmo código; trocar o código mantendo a chave dá 409. A cota, de 5 por minuto por credencial e 10 por conta, é a mesma do saque e da devolução.

Confirme a entrega

Dê o pagamento como feito só quando chegar WITHDRAW_COMPLETED. Os avisos são os do saque, com operation igual a EXTERNAL_PAYMENT, e os corpos estão em Saque criado, Saque concluído e Saque falhou.

Para conferir, use Consultar um saque ou pagamento. Com o pagamento CONFIRMED, o PDF sai em Comprovante do saque.

O pagamento não tem externalRef.

Guarde o id da resposta com o seu pedido para casar os avisos: ele é o mesmo withdrawId dos webhooks.

Erros desta operação

CódigoHTTPMensagem
QR_CRC400O código PIX está corrompido — copie novamente do recebedor.
QR_MALFORMED400Este código PIX não está num formato válido.
QR_NOT_PIX400Este código não é um QR code de PIX.
WITHDRAW_DISABLED403Saque desabilitado para esta conta.
PIX_DEST_PIX_KEY404Não encontramos essa chave PIX. Confira se ela está correta.
QR_AMOUNT_DISAGREES422O valor impresso no QR code é diferente do que o banco do recebedor informa. Confirme o valor com quem cobrou.
QR_AMOUNT_MISMATCH422O valor deste QR code é diferente do que foi informado. Se o código é dinâmico, quem cobrou pode tê-lo alterado depois da leitura — leia o código de novo.
QR_AMOUNT_REQUIRED422Este QR code não fixa valor — informe quanto pagar.
WITHDRAW_ABOVE_TICKET_MAX422O valor excede o máximo permitido para saque.
WITHDRAW_BELOW_TICKET_MIN422O valor é inferior ao mínimo permitido para saque.
WITHDRAW_DAILY_LIMIT422O limite diário de saque desta conta foi atingido.
WITHDRAW_INSUFFICIENT_BALANCE422Saldo insuficiente para este saque.
WITHDRAW_INSUFFICIENT_PROVIDER_BALANCE422O saldo desta conta não cobre este saque agora.
WITHDRAW_PIX_KEY_REFUSED_BY_PROVIDER422A chave PIX de destino foi recusada.

Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.