Idempotency-Key le permite reintentar la llamada a la Store API con seguridad.
Cómo funciona
Agregue un encabezadoIdempotency-Key (hasta 255 caracteres) a una solicitud de creación o de acción. PapelShip guarda la primera respuesta durante 24 horas. Un reintento con la misma clave y el mismo cuerpo recibe esa respuesta guardada en lugar de volver a ejecutar la solicitud.
Endpoints que la aceptan
La clave funciona en los endpoints de creación y de acción de la Store API, entre ellos:POST /invoices(crear un pedido)POST /invoices/{invoiceId}/papelpay(iniciar el pago con tarjeta)POST /invoices/{invoiceId}/completeyPOST /invoices/{invoiceId}/refundPOST /orders/{invoiceId}/shipmentsPOST /productsyPOST /coupons
Buenas prácticas
- Genere una clave por pedido, no por solicitud. Su propio ID de pedido funciona bien.
- Guarde la clave junto con su pedido para que cada reintento la reutilice.
- Nunca reutilice una clave para un pedido o un importe diferente.