Saltearse al contenido

La búsqueda solo está disponible en las versiones de producción. Intenta construir y previsualizar el sitio para probarlo localmente.

Idempotencia

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 cuerpoSe devuelve el resultado original. Nada ocurre dos veces.
El mismo identificador y un cuerpo distinto409. 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, 503Sí, con el mismo identificador y el mismo cuerpo.
422 de validaciónNo: corrige la petición.
409No: lee el código y la transacción.
429Sí, después de los segundos de Retry-After.