Pular para o conteúdo
LeonaPayLeonaPayDevelopers
Primeiros passosReferenciais da APIIntegraçõesv2
Produção

Boas práticas

Padrões para operar pagamentos de forma segura, resiliente e auditável.

Rede e retentativas

Use timeouts, retentativa exponencial somente para erros transitórios e a mesma idempotência em todas as tentativas da mesma operação.

Webhooks confiáveis

Valide HMAC antes do JSON, rejeite assinatura inválida, deduplique pelo ID e processe fora do request.

Observabilidade

Correlacione referência, ID LeonaPay, idempotency-key e RequestId. Nunca registre chaves, segredos, PAN, CVV ou documentos completos.
MétricaAlerta
Erros 5xxAcima da linha de base
Latência p95Acima do timeout
Webhook pendenteFila crescendo
Conciliação divergenteQualquer divergência
LeonaPay Developers · API v2