Saltar al contenido principal
Migo Docs

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 planQué controla
dailyAttemptsCuántas veces se reintenta
intervalAttemptCuánto se espera entre intentos (24 h por defecto)
graceDaysVentana 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 }
]
}'
CampoRequeridoNotas
clientSíTu slug de comercio
dataSíArreglo no vacío, máximo 5000 ítems
data[].subscriptionIdSíSuscripción a cobrar
data[].amountSíNúmero
data[].metadataNoFormato 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 cobrado

El 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​