PayZu Conta Hub
Novidades
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
amountretorna a devolução já pedida, sem outro Pix ao pagador. A mesma chave com outroamountou 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
amountresponde 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