Vinculación de Tarjetas de Terceros

Asocia a la cuenta Migo de un usuario una tarjeta que otro titular ya posee. 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 un AssignThirdPartyCardPayloadDto:

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

Vincular una tarjeta (CMS)

Para flujos de backoffice (operador actuando en representación del titular), POST .../cards/association usa el mismo cuerpo email/suffix/alias:

curl -X POST "https://api.ali.app/cms/rest/app/partners/{partnerId}/cardholders/{cardholderId}/cards/association" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: <cms-user-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "owner@example.com",
    "suffix": "1234",
    "alias": "Family Card"
  }'

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 (UpdateThirdPartyCardDto):

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.