Limites e idempotência

Limites de requisiçõesCopiar link da seção

Os limites contam por endereço IP, a cada minuto:

Acima do limite a resposta é 429, com o header Retry-After dizendo quantos segundos esperar. Para saber se algo foi pago, prefira os webhooks a consultar a API em loop.

Precisa de mais? Fale com o comercial pelo e-mail [email protected].

IdempotênciaCopiar link da seção

Uma falha de rede pode deixar você sem saber se a cobrança (ou o saque) foi criada. Para repetir sem risco de duplicar, envie o header idempotency-key ao criar um Pix ou um saque:

curl -X POST https://api.wysepay.com.br/api/v1/charges/pix \
  -H "x-api-key: wyp_test_sua_chave" \
  -H "idempotency-key: pedido-1042" \
  -H "Content-Type: application/json" \
  -d '{ … }'

• Use um valor único por cobrança, como o id do pedido no seu sistema.
• Repetindo com a mesma chave em até 24 horas, a WysePay devolve a mesma cobrança (ou o mesmo saque), sem criar outro.
• A chave vale por conta e por modo: a mesma idempotency-key em teste e em produção são cobranças diferentes.
• Para cobrar de novo o mesmo pedido (ex.: o Pix venceu), use uma chave nova, como pedido-1042-2.