Cobros
Una vez creada la suscripción, Migo cobra sola. Esta página explica cuándo lo hace, qué pasa si falla, y cómo lanzar cobros fuera del calendario cuando tu negocio los necesita.
Cobro automático
No tienes que hacer nada: el motor de recurrencia revisa periódicamente qué suscripciones vencen y las cobra.
cada corrida ──► por cada suscripción que vence:
1. toma la tarjeta predeterminada
2. cobra a través del procesador
3. si aprueba → avanza la próxima fecha de renovación
4. si falla → entra al calendario de reintentos
Se seleccionan las suscripciones cuya próxima renovación cae en el día actual según la zona horaria
del comercio (por defecto America/Guatemala).
Cada cobro exitoso te llega como un subsCallback con status: active y la nueva
nextRenewalDate. Ver Callback de suscripciones.
Reintentos
Se configuran por plan, no con un calendario global:
| Campo del plan | Qué controla |
|---|---|
dailyAttempts | Cuántas veces se reintenta |
intervalAttempt | Cuánto se espera entre intentos (24 h por defecto) |
graceDays | Ventana de gracia opcional antes de dar la suscripción por fallida |
Si el cobro falla con la tarjeta predeterminada, Migo prueba las demás tarjetas registradas de esa
suscripción. Agotados todos los intentos, la suscripción pasa a inactive y recibes el callback
correspondiente: ahí es donde revocas el acceso.
3-D Secure
Los cobros recurrentes se ejecutan sin nadie delante de la pantalla, así que el motor no pide desafío 3DS. Solo aparece si la configuración de tu comercio o del procesador lo fuerza.
Cobros de monto variable
Cuando el importe no es fijo —consumo medido, add-ons, recargas— puedes cobrar una suscripción fuera de su calendario. Son endpoints de ingesta por lote: aceptan muchos cobros en una llamada y los procesan de forma asíncrona.
Por JSON
curl -X POST https://sb-mw.migopayments.com/api/v1/subscriptions/charges \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"client": "<tu-client-slug>",
"data": [
{ "subscriptionId": "sub_000001", "amount": 15.00, "metadata": { "nota": "consumo julio" } },
{ "subscriptionId": "sub_000002", "amount": 49.99 }
]
}'
| Campo | Requerido | Notas |
|---|---|---|
client | Sí | Tu slug de comercio |
data | Sí | Arreglo no vacío, máximo 5000 ítems |
data[].subscriptionId | Sí | Suscripción a cobrar |
data[].amount | Sí | Número |
data[].metadata | No | Formato libre, para tu conciliación |
Responde 202 Accepted con los totales del lote:
{
"success": true,
"message": "Batch received",
"data": { "clientId": "<client-id>", "batchId": "<batch-id>", "totals": {}, "errorsSample": [] }
}
202 significa recibido, no cobradoEl resultado de cada cobro no viene en esta respuesta: llega después por callback. No hay identificador de cobro individual.
Por CSV
Para volúmenes grandes o cargas operativas, sube el lote como archivo (máximo 10 MB):
curl -X POST "https://sb-mw.migopayments.com/api/v1/subscriptions/charges/upload-csv?clientId=<client-id>" \
-H "Authorization: Bearer <token>" \
-F "file=@cobros.csv"
{ "success": true, "message": "File received...", "trackingId": "V1StGXR8_Z5jdHi6B-myT" }
La respuesta trae solo el trackingId. El detalle por fila lo procesa un consumidor asíncrono:
confirma con Migo el formato exacto de columnas y el reporte de resultados antes de depender de él.
Cuándo NO usarlos
- Para la facturación de cadencia normal — de eso ya se encarga el cobro automático.
- Para un cobro puntual a alguien que no tiene suscripción — usa un link de pago.
Historial de pagos
curl "https://sb-mw.migopayments.com/api/v1/subscriptions/payment-history?subscriptionId=sub_000001" \
-H "Authorization: Bearer <token>"
El parámetro subscriptionId es obligatorio (400 si falta). La respuesta es un arreglo plano
de transacciones, sin paginación ni filtros por fecha:
{ "success": true, "message": "Payment history found", "data": [] }
Si necesitas reportes por rango de fechas o por comercio completo, constrúyelos sobre los callbacks que ya recibiste y almacenaste.
Relacionado
- Callback de suscripciones — el resultado de cada cobro
- Métodos de pago — qué tarjeta se usa y en qué orden