Saltar al contenido principal
Los fallos de red ocurren. Cuando una solicitud agota el tiempo de espera, no puede saber si PapelShip creó el pedido. Un encabezado Idempotency-Key le permite reintentar la llamada a la Store API con seguridad.

Cómo funciona

Agregue un encabezado Idempotency-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}/complete y POST /invoices/{invoiceId}/refund
  • POST /orders/{invoiceId}/shipments
  • POST /products y POST /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.