Tema: stripe
-
Paginación y claves de idempotencia en la API de Stripe: starting_after, has_more y la ventana de 24 horas
Los endpoints de listado de la API v1 de Stripe paginan con los parámetros de cursor mutuamente excluyentes starting_after/ending_before (limit de 1 a 100, por defecto 10) y un indicador has_more; las bibliotecas cliente incluyen auxiliares de autopaginación para recorrer todas las páginas. Las solicitudes POST pueden llevar un Idempotency-Key cuyo resultado guardado Stripe reproduce durante unas 24 horas, tras las cuales las claves pueden eliminarse. Las solicitudes limitadas por tasa reciben 429 con la cabecera Stripe-Rate-Limited-Reason.
-
Verificación de firmas de webhooks de Stripe: Stripe-Signature, tolerancia de marca de tiempo y rotación de secretos
Stripe envía un encabezado Stripe-Signature con la forma t=<timestamp>,v1=<firma hex>, calculado como HMAC-SHA256 sobre la cadena "{timestamp}.{raw body}" con el secreto completo del endpoint whsec_ como clave. Por defecto, las bibliotecas de Stripe rechazan las firmas cuya marca de tiempo tenga más de cinco minutos (300 segundos) de antigüedad y, mientras un secreto rotado sigue activo (hasta 24 horas), el encabezado incluye un valor v1 por cada secreto activo.
Legible por máquina: JSON