Transferencias Tarjeta a Tarjeta

Mueve dinero entre dos tarjetas emitidas por Migo. Útil para funciones de wallet: enviar dinero a un contacto, dividir una cuenta, recargar la tarjeta de alguien más.

Tipos de transferencia

Los tipos de transferencia clasifican los movimientos por categoría de transferencia, canal, dirección del movimiento y modelo de procesamiento. Créalos en una sola llamada por lotes (CreateTransferTypeDto envuelve un arreglo de TransferTypeDto):

curl -X POST https://api.ali.app/rest/card-transfers/types \
  -H "Authorization: Bearer <token>" \
  -H "x-application-id: YOUR_APP_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "types": [
      {
        "name": "POS Purchase",
        "type": "posPurchase",
        "channel": "financialNetwork",
        "movementType": "debit",
        "model": "settlement"
      }
    ]
  }'

Campo	Requerido	Notas
type	sí	TransferType (p. ej. posPurchase, ecommercePurchase, balanceTransfertoUser, topUp, ...)
channel	sí	ChannelType: financialNetwork o webService
movementType	sí	MovementType: debit o credit
model	sí	ModelType: settlement o reversed
name	no	Etiqueta descriptiva para el tipo de transferencia

Ejecutar una transferencia

curl -X POST https://api.ali.app/rest/cards/transfer \
  -H "Authorization: Bearer <token>" \
  -H "x-application-id: YOUR_APP_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "fromCardId": 12345,
    "toCardId": 67890,
    "amount": 50.00,
    "observations": "Lunch split"
  }'

Campo	Requerido	Notas
fromCardId	sí	Identificador numérico interno de la tarjeta origen
toCardId	sí	Identificador numérico interno de la tarjeta destino
amount	sí	Monto monetario a transferir
observations	no	Nota opcional que describe el motivo de la transferencia

Consultar una transferencia

curl https://api.ali.app/rest/card-transfers/{id} \
  -H "Authorization: Bearer <token>"

Listar las transferencias de una tarjeta

curl "https://api.ali.app/rest/cards/{cardId}/transfers/{month}/{year}" \
  -H "Authorization: Bearer <token>"

Devuelve tanto las transferencias entrantes como las salientes del mes indicado.

Errores

Código	Nombre	Significado
7300	ERROR_CREATING_TRANSFER	No se pudo crear la transferencia
7301	ERROR_UPDATING_TRANSFER	No se pudo actualizar la transferencia
7302	ERROR_GETTING_HISTORY	No se pudo obtener el historial de movimientos/transferencias
7303	INSUFFICIENT_FUNDS	Saldo de la tarjeta origen demasiado bajo
7304	INVALID_TRANSFER_STATUS	La transferencia está en un estado que no permite la operación
7305	ERROR_CREATING_TRANSFER_TYPE	No se pudo crear un tipo de transferencia
7306	CARD_TRANSFER_NOT_FOUND	La transferencia referenciada no existe

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