Saltar al contenido principal
Migo Docs

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>"
aviso

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.

No hay actualización automática de tarjetas

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​

Solo para integraciones con alcance PCI

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​