PayZu Conta HubConta

Limites e tarifas


Nesta páginaConsulte os limitesRecusas por limiteReleia antes de cada saída

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

bash
curl --request GET \
  --url 'https://api.sandbox.payzu.dev/api/v1/transactions/limits' \
  --header 'Authorization: Bearer SEU_TOKEN'

Referência: Consultar os limites e as tarifas

CampoO que é
ticketMin, ticketMaxOs limites de valor de cada operação, em centavos.
feeFixed, feePercentageA 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.
dailyWithdrawTeto do dia dos saques e dos pagamentos de copia e cola, sem contar as devoluções.
dailyInternalTransferTeto do dia das transferências entre contas.
limitO teto. Com null, não há teto; com 0, a operação está travada.
usedO 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ódigoHTTPMensagem
PAYMENT_DISABLED403Pagamento desabilitado para esta conta.
REFUND_DISABLED403Estorno desabilitado para esta conta.
TRANSFER_DISABLED403Transferência entre contas desabilitada para esta conta.
WITHDRAW_DISABLED403Saque desabilitado para esta conta.
PAYMENT_ABOVE_MAXIMUM422O valor excede o máximo permitido.
PAYMENT_AMOUNT_NOT_ABOVE_FEE422O valor da cobrança precisa ser maior que a tarifa de recebimento.
PAYMENT_BELOW_MINIMUM422O valor é inferior ao mínimo permitido.
REFUND_ABOVE_TICKET_MAX422O valor do estorno está acima do limite por operação desta conta.
TRANSFER_ABOVE_TICKET_MAX422O valor excede o máximo permitido para transferência entre contas.
TRANSFER_BELOW_TICKET_MIN422O valor é inferior ao mínimo permitido para transferência entre contas.
TRANSFER_DAILY_LIMIT422O limite diário de transferência desta conta foi atingido.
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.

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.