Limites e tarifas
Valide valores no seu sistema e mostre a tarifa ao usuário antes de confirmar, com os números que valem para a conta agora.
Consulte os limites
curl --request GET \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/limits' \
--header 'Authorization: Bearer SEU_TOKEN'{
"payment": { "ticketMin": 100, "ticketMax": 1000000, "feeFixed": 105, "feePercentage": 0 },
"withdraw": { "ticketMin": 100, "ticketMax": 1000000, "feeFixed": 100, "feePercentage": 150 },
"externalPayment": { "ticketMin": 100, "ticketMax": 1000000, "feeFixed": 100, "feePercentage": 0 },
"refund": { "ticketMin": 100, "ticketMax": 1000000, "feeFixed": 100, "feePercentage": 0 },
"internalTransfer": { "ticketMin": 100, "ticketMax": 1000000, "feeFixed": 100, "feePercentage": 0 },
"dailyWithdraw": { "limit": 1000000, "used": 12850 },
"dailyInternalTransfer": { "limit": null, "used": 0 },
"infraction": { "feeFixed": 500, "feePercentage": 0, "blocksBalance": true }
}Referência: Consultar os limites e as tarifas
| Campo | O que é |
|---|---|
ticketMin, ticketMax | Os limites de valor de cada operação, em centavos. |
feeFixed, feePercentage | A tarifa é feeFixed (centavos) mais feePercentage aplicado ao valor da operação. O percentual vem em basis points: 150 = 1,5%, ou seja, feeFixed + amount × feePercentage / 10000. |
dailyWithdraw | Teto do dia dos saques e dos pagamentos de copia e cola, sem contar as devoluções. |
dailyInternalTransfer | Teto do dia das transferências entre contas. |
limit | O teto. Com null, não há teto; com 0, a operação está travada. |
used | O consumo de hoje, no horário de Brasília. |
No saque e na transferência, amount é o que chega ao destino e a tarifa é somada por cima.
Nos exemplos da referência, o saque de 10000 com feeFixed: 100 e feePercentage: 150 tem serviceFee de 250 e totalDebited de 10250. Na cobrança, a tarifa sai do valor recebido, e netAmount é o que entra na conta.
Recusas por limite
Fora do limite, ou com a operação desabilitada para a conta, a resposta traz um código próprio.
| Código | HTTP | Mensagem |
|---|---|---|
PAYMENT_DISABLED | 403 | Pagamento desabilitado para esta conta. |
REFUND_DISABLED | 403 | Estorno desabilitado para esta conta. |
TRANSFER_DISABLED | 403 | Transferência entre contas desabilitada para esta conta. |
WITHDRAW_DISABLED | 403 | Saque desabilitado para esta conta. |
PAYMENT_ABOVE_MAXIMUM | 422 | O valor excede o máximo permitido. |
PAYMENT_AMOUNT_NOT_ABOVE_FEE | 422 | O valor da cobrança precisa ser maior que a tarifa de recebimento. |
PAYMENT_BELOW_MINIMUM | 422 | O valor é inferior ao mínimo permitido. |
REFUND_ABOVE_TICKET_MAX | 422 | O valor do estorno está acima do limite por operação desta conta. |
TRANSFER_ABOVE_TICKET_MAX | 422 | O valor excede o máximo permitido para transferência entre contas. |
TRANSFER_BELOW_TICKET_MIN | 422 | O valor é inferior ao mínimo permitido para transferência entre contas. |
TRANSFER_DAILY_LIMIT | 422 | O limite diário de transferência desta conta foi atingido. |
WITHDRAW_ABOVE_TICKET_MAX | 422 | O valor excede o máximo permitido para saque. |
WITHDRAW_BELOW_TICKET_MIN | 422 | O valor é inferior ao mínimo permitido para saque. |
WITHDRAW_DAILY_LIMIT | 422 | O limite diário de saque desta conta foi atingido. |
Os códigos de saque valem também para o pagamento de copia e cola. REFUND_ABOVE_TICKET_MAX traz o teto aplicado em details.max, e as recusas de teto diário trazem limit, used e required em details. O detalhe de cada recusa está em Erros.
Releia antes de cada saída
Não há evento de webhook para mudança de limite, tarifa ou teto usado. O PayZu Conta Hub confere os mesmos limites de novo em cada operação, e a sua validação só evita uma recusa previsível.