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"
}'
| Campo | Requerido | Notas |
|---|---|---|
email | sí | Email del titular dueño de la tarjeta de terceros |
suffix | sí | Últimos cuatro dígitos de la tarjeta |
alias | sí | 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ódigo | Nombre | Significado |
|---|---|---|
7220 | THIRD_PARTY_CARD_NOT_FOUND | Ninguna tarjeta coincide con el email del propietario + sufijo proporcionados |
7221 | ERROR_CREATING_THIRD_PARTY_CARD | No se pudo crear la asociación |
7222 | THIRD_PARTY_CARD_ALREADY_ASSIGNED | La tarjeta ya está vinculada |
7223 | CARD_ASSOCIATED_BELONGS_TO_THE_USER_WHO_MADE_THE_REQUEST | La tarjeta pertenece al usuario solicitante |
Consulta el Catálogo de errores completo para la lista total.