Desarrolladores

Todo lo que necesitas para integrar iPagos en tu producto: APIs REST, SDKs oficiales, webhooks, ambientes de prueba y guías paso a paso.

Empezar ahora

Solicitar API key

Empezar

Idempotencia

Toda operación que crea, modifica o cobra dinero acepta el encabezado Idempotency-Key. Esto te permite reintentar peticiones sin riesgo de duplicar cargos.

Cómo funciona

Genera un identificador único (UUID v4 es ideal) y envíalo en el encabezado Idempotency-Key. Si la petición falla por timeout o error de red, reenvíala con la misma llave: iPagos devolverá exactamente la misma respuesta del primer intento.

curl https://api.ipagos.lat/v1/payments \
  -u sk_sandbox_xxxxxxxxxxxxxxxxxxxxx: \
  -H "Idempotency-Key: 1f8c8e2a-2c2b-4f7a-9d8e-7b6c5a4d3e2f" \
  -d amount=25000 -d currency=MXN -d source=tok_visa_4242

Reglas

· Las llaves expiran a las 24 horas.

· Si reusas la misma llave con un cuerpo distinto, recibes 409 idempotency_error.

· Las respuestas 4xx también se guardan: una llave que ya devolvió error seguirá haciéndolo.

· No uses idempotencia para operaciones GET (son naturalmente idempotentes).

Usar idempotencia es obligatorio en producción para evitar cobros duplicados cuando la red falla entre tu servidor y el nuestro.