Idempotencia - Onflay Docs

Las operaciones mutantes aceptan Idempotency-Key. Úsala especialmente al crear sesiones de checkout.

Con SDK

await onflay.checkoutSessions.create(
  {
    listingId: 'lst_...',
    customerEmail: 'comprador@ejemplo.com',
    successUrl: 'https://tu-app.com/gracias',
    cancelUrl: 'https://tu-app.com/cancelado',
  },
  { idempotencyKey: 'checkout:user_123:lst_456' }
);

Con HTTP

curl -X POST https://sandbox-api.onflay.com/v1/checkout-sessions \
  --header 'Authorization: <tu-secret-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: checkout:user_123:lst_456' \
  --data '{
    "listingId": "lst_...",
    "customerEmail": "comprador@ejemplo.com",
    "successUrl": "https://tu-app.com/gracias",
    "cancelUrl": "https://tu-app.com/cancelado"
  }'

Cómo elegir una key

Usa una key estable para la operación lógica, no una key nueva por cada retry. Buenos ejemplos:

checkout:user_123:listing_456
checkout:order_789
refund:transaction_123

Si reutilizas la misma key con un body distinto, la API puede devolver 409 idempotency_error.