PayZu Conta Hub

Novidades


Nesta página03 nov 202623 out 202607 out 2026

03 nov 2026

Novidades

  • POST /transactions/payment/{paymentId}/refund e POST /transactions/deposit/{depositId}/refund aceitam o header Idempotency-Key, de 1 a 255 caracteres visíveis. Repetir com a mesma chave e o mesmo amount retorna a devolução já pedida, sem outro Pix ao pagador. A mesma chave com outro amount ou em outra operação responde 409 REFUND_IDEMPOTENCY_KEY_REUSED, e chave fora do formato responde 400 REFUND_INVALID_IDEMPOTENCY_KEY. Solicitar a devolução de uma cobrança
  • Na devolução de cobrança e na devolução de depósito, só o corpo vazio ou {} devolve o que resta. Corpo que não é JSON responde 400 SCHEMA_MALFORMED_BODY, e campo diferente de amount responde 400 SCHEMA_INVALID. Nos dois casos nada é devolvido; antes, esses corpos devolviam o valor inteiro. Solicitar a devolução de um depósito

23 out 2026

Novidades

  • Saque e pagamento de QR Code passam a ter só PROCESSING, CONFIRMED e FAILED: PROCESSING substitui REQUESTED, CREATED e APPROVED. Vale também para o filtro status de GET /transactions/withdraw e para os webhooks WITHDRAW_*. Na devolução, PROCESSING substitui RESERVED e SENT. Consultar o status de um saque
  • No saque e na transferência entre contas, providerRejectedReason passa a se chamar failureReason, e sentAt e approvedAt saem do saque. A listagem de saques traz operation e leva bank e pixKey para destination, como o detalhe; failureReason e callbackUrl ficam só em GET /transactions/withdraw/{withdrawId}. Listar os saques e pagamentos
  • paymentId, withdrawId e transferId dos webhooks passam a ser o mesmo id no formato PAAAAMMDDhhmmss que a API retorna, nos dois lados da transferência. O PAYMENT_REFUNDED deixa de trazer serviceFeeReturned, e ACCOUNT_BLOCKED e ACCOUNT_UNBLOCKED deixam de trazer blockings e seguem com blockedOperations. Webhooks e callbacks
  • Saem qrCodeUrl e qrCodeBase64 da cobrança, que vinham sempre nulos, o status da chave Pix, o id e o origin.id da contestação MED e o trilho de cartão das métricas, com o campo available. No extrato saem entryId, originId, trigger e statusDetail, e os filtros trigger e originId. Listar os lançamentos do extrato
  • Com o recebimento de depósitos desabilitado na conta, o Pix entra, mas o líquido fica retido até a liberação pela PayZu. O detalhe do depósito traz blockedAmount, blockedAt e releasedAt, refundableAmount fica em 0 e a devolução responde 422 DEPOSIT_BLOCKED enquanto durar a retenção. Consultar um depósito

07 out 2026

Novidades

  • Nova API da conta de cada loja: cobranças Pix, saques, pagamento de copia e cola, transferências entre contas, extrato e infrações MED. Sobre o PayZu Conta Hub