Las peticiones que mueven dinero se pueden reintentar con seguridad: Cashela nunca ejecuta dos veces la misma operación para el mismo identificador.
Las reglas
- Cada operación lleva tu propio identificador único,
external_identifier. Guárdalo antes de llamar a la API.
- También puedes enviar la cabecera
Idempotency-Key. Usa un valor estable por operación.
- Las claves son propias de tus credenciales y de tu entorno.
| Repites la petición con… | Resultado |
|---|
| El mismo identificador y el mismo cuerpo | Se devuelve el resultado original. Nada ocurre dos veces. |
| El mismo identificador y un cuerpo distinto | 409. Pay-In añade code: PARTNER_PAYIN_IDEMPOTENCY_CONFLICT; Pay-Out responde solo con message. |
Por producto
- Pay-In: sin
Idempotency-Key, la clave es el external_identifier; una creación fallida se repite con la misma respuesta. Ver Idempotencia y reintentos seguros.
- Pay-Out: la clave es tu
external_identifier (la cabecera Idempotency-Key se guarda y se devuelve). Repetir la misma cotización con el mismo external_identifier devuelve la cotización existente; repetir la misma transacción devuelve la transacción existente. Una cotización vencida no se vuelve a ejecutar. Ver la guía de Pay-Out.
Cuándo reintentar
| Situación | ¿Reintentar? |
|---|
Timeout, error de conexión, 500, 503 | Sí, con el mismo identificador y el mismo cuerpo. |
422 de validación | No: corrige la petición. |
409 | No: lee el código y la transacción. |
429 | Sí, después de los segundos de Retry-After. |