Saltar al contenido principal
Migo Docs

Vinculación de tarjetas de terceros

Asocia a la cuenta Migo de un usuario una tarjeta que otro titular ya posee. Dentro de tu ecosistema, esto te permite relacionar tarjetas de otros usuarios al cardholder. Una tarjeta de terceros se vincula mediante el email del propietario y el sufijo de los últimos 4 dígitos de la tarjeta — no hay tokenización por SDK ni intercambio de token temporal.

Vincular una tarjeta (Wallet Gateway)​

POST /users/{userId}/linked-cards toma el siguiente cuerpo:

curl -X POST https://api.ali.app/rest/users/{userId}/linked-cards \
-H "Authorization: Bearer <token>" \
-H "x-application-id: YOUR_APP_ID" \
-H "Content-Type: application/json" \
-d '{
"email": "owner@example.com",
"suffix": "1234",
"alias": "Family Card"
}'
CampoRequeridoNotas
emailsíEmail del titular dueño de la tarjeta de terceros
suffixsíÚltimos cuatro dígitos de la tarjeta
aliassíAlias usado para identificar la tarjeta en la cuenta

Listar tarjetas vinculadas​

curl https://api.ali.app/rest/users/{userId}/linked-cards \
-H "Authorization: Bearer <token>"

Actualizar asociación (alias)​

PATCH /users/{userId}/linked-cards/{associationId} actualiza únicamente el alias:

curl -X PATCH https://api.ali.app/rest/users/{userId}/linked-cards/{associationId} \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{ "alias": "BAC (primary)" }'

Eliminar una asociación​

curl -X DELETE https://api.ali.app/rest/users/{userId}/linked-cards/{associationId} \
-H "Authorization: Bearer <token>"

Errores​

CódigoNombreSignificado
7220THIRD_PARTY_CARD_NOT_FOUNDNinguna tarjeta coincide con el email del propietario + sufijo proporcionados
7221ERROR_CREATING_THIRD_PARTY_CARDNo se pudo crear la asociación
7222THIRD_PARTY_CARD_ALREADY_ASSIGNEDLa tarjeta ya está vinculada
7223CARD_ASSOCIATED_BELONGS_TO_THE_USER_WHO_MADE_THE_REQUESTLa tarjeta pertenece al usuario solicitante

Consulta el Catálogo de errores completo para la lista total.