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ágina | Qué resuelve |
|---|---|
| Planes | Crear, listar, consultar y actualizar planes — el precio y la cadencia |
| Link de pago de suscripción | Convertir un plan en una URL de checkout que puedes enviar por email, WhatsApp o SMS |
| Suscripciones | Consultar, listar, actualizar y cancelar; los cuatro estados y sus transiciones |
| Callback de suscripciones | Cómo te avisa Migo de cada alta, cobro y baja; es tu fuente de verdad |
| Cobros | El cobro automático en cada vencimiento, los cobros de monto variable (JSON y CSV) y el historial |
| Métodos de pago | Tarjetas registradas: agregar, cambiar la predeterminada, eliminar |
| Preguntas frecuentes | Los 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:
| Dato | Para qué |
|---|---|
| Token de comercio | Autenticar todas las llamadas |
client (slug) | Identifica tu comercio en cada request |
| URL y secreto de callback | Dó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.