Uma conta por loja, operada pela API: cobranças Pix, saques, pagamento de Pix copia e cola, transferências e extrato.
Cada credencial opera uma conta só: nenhuma rota recebe accountId. Para operar duas contas, use duas credenciais.
| Item | Regra |
|---|
| Base URL | https://api.hub.payzu.com.br/api/v1 |
| Valores | Inteiros, em centavos: 1500 é R$ 15,00. |
| Percentuais | Em basis points: 150 é 1,5%. |
| Datas | ISO 8601 em UTC, como 2026-10-05T14:32:05.123Z. |
| Listagens | Paginam por cursor: mande o nextCursor da resposta no parâmetro cursor da próxima chamada. Na última página ele não vem. |
| Erros | { "message", "code", "details" }. Trate pelo code; a message é um texto para exibir. |
| Operação | O saldo muda |
|---|
| Cobrança | Quando o cliente paga. Chega o webhook PAYMENT_PAID. |
| Saque e pagamento de Pix copia e cola | Na hora do pedido: o valor e a tarifa saem do saldo disponível. Se a operação falhar, voltam. |
| Transferência entre contas | Na hora: a resposta já traz o resultado. |
| Pix recebido sem cobrança | Quando o Pix cai. Chega o webhook DEPOSIT_RECEIVED. |
| Estorno e devolução de depósito | Na hora do pedido: o valor e a tarifa saem do saldo disponível. Se o estorno falhar, voltam. |
- Boleto e cartão. A API não emite boleto nem cobra cartão. Para cartão, veja a API de Cartões.
- Responder contestação MED. A API mostra a contestação; a resposta é dada no painel.
- Criar ou trocar credencial. Feito pelo titular, no painel hub.payzu.com.br.
