Saltar al contenido principal
Migo Docs

Suscripciones

Migo ejecuta el cobro recurrente de tu comercio. Tú defines el precio y la cadencia; Migo hospeda el checkout, guarda la tarjeta, crea la suscripción cuando el cliente paga y ejecuta el cobro en cada vencimiento, avisando a tu backend por callback en cada evento.

No tocas datos de tarjeta en ningún momento y no necesitas alcance PCI.

El recorrido completo, en cuatro pasos​

1. Creas el PLAN POST /api/v1/plans
(cuánto, cada cuánto) │
▼
2. Generas el LINK DE PAGO POST /transactions
a partir de ese plan (customKeys.plan.uid)
│ ← devuelve la URL del checkout
▼
3. Tu cliente PAGA en el checkout (webview hospedado por Migo)
→ Migo crea la SUSCRIPCIÓN automáticamente
│ → callback a tu backend
▼
4. Migo COBRA en cada vencimiento (automático, sin código tuyo)
→ callback en cada cobro

Solo haces una llamada por venta (paso 2). Los pasos 3 y 4 los ejecuta Migo.

Rutas de integración​

Guía para agentes de IA

Un documento autocontenido que le entregas a tu asistente de IA para que implemente la integración —pago único y suscripciones— con una verificación por cada paso.

Integración en 4 pasos

El mismo recorrido, escrito para una persona: las cuatro llamadas en orden, con curl reales y qué verificar en cada una antes de avanzar.

Referencia​

PáginaQué resuelve
PlanesCrear, listar, consultar y actualizar planes — el precio y la cadencia
Link de pago de suscripciónConvertir un plan en una URL de checkout que puedes enviar por email, WhatsApp o SMS
SuscripcionesConsultar, listar, actualizar y cancelar; los cuatro estados y sus transiciones
Callback de suscripcionesCómo te avisa Migo de cada alta, cobro y baja; es tu fuente de verdad
CobrosEl cobro automático en cada vencimiento, los cobros de monto variable (JSON y CSV) y el historial
Métodos de pagoTarjetas registradas: agregar, cambiar la predeterminada, eliminar
Preguntas frecuentesLos límites reales de la API: qué se puede hacer, qué no, y cuál es la alternativa

Antes de empezar​

Necesitas tres datos de tu cuenta, que te entrega Migo:

DatoPara qué
Token de comercioAutenticar todas las llamadas
client (slug)Identifica tu comercio en cada request
URL y secreto de callbackDónde te avisa Migo y cómo verificas que el aviso es suyo

Los entornos y sus URLs base están en Entornos y URLs base. Empieza siempre en sandbox.