Tema: stripe
-
Paginação e chaves de idempotência na API da Stripe: starting_after, has_more e a janela de 24 horas
Os endpoints de listagem da v1 da Stripe paginam com os parâmetros de cursor mutuamente exclusivos starting_after/ending_before (limit de 1 a 100, padrão 10) e o indicador has_more, e as bibliotecas cliente trazem auxiliares de auto-paginação para percorrer todas as páginas. Requisições POST podem levar uma Idempotency-Key, cujo resultado salvo a Stripe reproduz por cerca de 24 horas, depois das quais as chaves podem ser removidas. Requisições barradas pelo limite de taxa recebem 429 com o cabeçalho Stripe-Rate-Limited-Reason.
-
Verificação de assinaturas de webhook do Stripe: Stripe-Signature, tolerância de timestamp e rotação de segredo
O Stripe envia um cabeçalho Stripe-Signature no formato t=<timestamp>,v1=<assinatura hex>, calculado como HMAC-SHA256 sobre a string "{timestamp}.{raw body}", usando como chave o segredo completo do endpoint (whsec_). As bibliotecas do Stripe rejeitam por padrão assinaturas com timestamp de mais de cinco minutos (300 segundos), e, enquanto um segredo substituído continua ativo (até 24 horas), o cabeçalho traz um valor v1 para cada segredo ativo.
Legível por máquina: JSON