Métodos de pago
Cada suscripción tiene una tarjeta predeterminada y, opcionalmente, otras tarjetas registradas. Los cobros intentan primero con la predeterminada y, si falla, recorren las demás.
La tarjeta se guarda sola cuando tu cliente paga el link de pago — no tienes que registrarla ni verla nunca.
Todas las rutas de esta página usan Authorization: Bearer <tu-token-de-comercio>.
Cambiar la tarjeta predeterminada
curl -X PUT https://sb-mw.migopayments.com/api/v1/subscriptions/payment-methods/set-default \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"userId": "<userId>",
"clientId": "<clientId>",
"subscriptionId": "sub_000001",
"paymentMethodId": "<payment-method-id>"
}'
Los cuatro campos son obligatorios.
Eliminar un método de pago
Requiere ambos parámetros de query, methodId y subId (400 si falta cualquiera):
curl -X DELETE "https://sb-mw.migopayments.com/api/v1/subscriptions/payment-methods?methodId=<id>&subId=sub_000001" \
-H "Authorization: Bearer <token>"
No puedes eliminar la tarjeta predeterminada de una suscripción activa. Define primero otra como predeterminada y luego elimina la anterior.
Tarjetas por vencer
El motor emite un aviso por email al tarjetahabiente antes de que su tarjeta venza. La antelación se
configura por plan con daysNotifyExpiringCard.
Migo no rota el número ni la fecha de vencimiento por ti (no hay Account Updater). Cuando una
tarjeta vence, el cobro falla, se agotan los reintentos y la suscripción pasa a inactive. La
recuperación es que tu cliente vuelva a pagar un link nuevo.
Verificar una tarjeta
Si cobras con tu propio formulario de tarjeta en lugar del checkout hospedado, la tarjeta se verifica
con POST /api/v1/subscriptions/verify-card, ligada a una transacción existente. Requiere
transactionUid, processor y cardInfo; tokeniza la tarjeta, la preautoriza, revierte esa
autorización y —con shouldCreateSubscription: true y planUid— crea la suscripción.
Si usas el link de pago, no necesitas este endpoint: el checkout hospedado ya hace todo esto.
curl -X POST https://sb-mw.migopayments.com/api/v1/subscriptions/verify-card \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"uid": "<transaction-uid>",
"processor": "<processor-slug>",
"cardInfo": { "...": "datos de tarjeta tokenizados por el procesador" },
"shouldCreateSubscription": true,
"planUid": "<plan-uid>"
}'
También existe POST /api/v1/subscriptions/payment-methods, que se invoca normalmente de forma interna
después de verify-card, con los datos de la tarjeta anidados bajo tokenizeData.
Relacionado
- Cobros → Reintentos — el orden en que se prueban las tarjetas
- Suscripciones