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

API Reference

Suscripciones

Las Subscriptions automatizan cobros recurrentes. Definen un plan, un cliente, una cadencia y manejan reintentos, prorrateos y cancelaciones.

El objeto Subscription

{
  "id": "sub_5T2pK9LqRxNm",
  "object": "subscription",
  "customer": "cus_8B2nM1Q9TfYr",
  "plan": "plan_pro_monthly_mxn",
  "status": "active",
  "current_period_start": "2026-06-01T00:00:00Z",
  "current_period_end":   "2026-07-01T00:00:00Z",
  "cancel_at_period_end": false,
  "metadata": { "tenant": "acme" },
  "created_at": "2026-06-01T00:00:00Z"
}

Endpoints

POST

/v1/subscriptions

Crea una suscripción para un cliente.

GET

/v1/subscriptions/:id

Recupera una suscripción.

POST

/v1/subscriptions/:id

Actualiza el plan, cantidad o método de pago.

DEL

/v1/subscriptions/:id

Cancela la suscripción inmediatamente o al fin del periodo.

Estados

trialing — periodo de prueba activo, sin cobros aún.

active — cobros al día.

past_due — un cobro falló, reintentando según política.

unpaid — se agotaron los reintentos.

canceled — cancelada.