Limites e regras
Limites de requisição, de valores e as regras de segurança para saques e split.
Requisições
| Limite | Valor | Resposta |
|---|---|---|
| Por conta (client ID) | 600 requisições por minuto | 429, code: "RATE_LIMITED" |
| Credenciais inválidas por IP | 30 erros em 5 minutos bloqueiam o IP por um tempo | 429, code: "RATE_LIMITED" |
Ao receber 429, espere alguns segundos e repita com espera crescente. Para acompanhar pagamentos, use callbacks em vez de consultas em loop.
Valores
- Valores sempre em reais, com até 2 casas decimais (
49.9,"49.90"ou"49,90"). - Cobranças e saques têm mínimo e máximo por operação definidos pela WeetPay; saques têm também limite diário (janela móvel de 24 h). Quando um limite é ultrapassado, a mensagem de erro informa o valor permitido.
- A validade do QR Code é definida pela plataforma (padrão: 1 hora). Depois disso a cobrança fica
EXPIRED. - Tarifas de recebimento e de saque são as do seu contrato e aparecem no painel. Recebimentos entram no saldo já líquidos; a tarifa de saque é debitada junto com o valor.
Saques pela API
Liberação pelo cliente. O saque pela API vem desligado. Ligue em Desenvolvedores no painel (exige o PIN de transação). Desligado, pix-payment responde 403.
Destino. Sem liberação da WeetPay, o saque só vai para a chave CPF/CNPJ do titular da conta. Para pagar terceiros (fornecedores, afiliados, clientes), peça a liberação ao suporte.
Aprovação. Saques acima do valor de aprovação automática da plataforma passam por análise da operação antes do envio. Enquanto isso o saque continua PROCESSING e o valor fica reservado.
Resultado. Pago ou não, o resultado chega no callbackUrl. Não pago (recusado na análise, chave inexistente, falha no banco) tem valor e tarifa estornados automaticamente.
Split
O campo split de Gerar cobrança PIX divide o valor recebido com outra conta WeetPay. Ele move dinheiro entre contas, por isso só funciona em contas liberadas pelo Compliance. A conta de destino precisa estar ativa e com a verificação aprovada; o percentual é um inteiro de 1 a 100.
Verificação de identidade
A API só responde para contas com a verificação de identidade (KYC) aprovada e não bloqueadas. Até lá, todas as chamadas retornam 403 com code: "KYC_REQUIRED".