Card-to-Card Transfers

Move money between two Migo-issued cards. Useful for wallet features: send money to a contact, split a bill, top up someone else's card.

Transfer types

Transfer types classify movements by transfer category, channel, movement direction, and processing model. Create them in a single batched call (CreateTransferTypeDto wraps an array of 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"
      }
    ]
  }'

Field	Required	Notes
type	yes	TransferType (e.g. posPurchase, ecommercePurchase, balanceTransfertoUser, topUp, ...)
channel	yes	ChannelType: financialNetwork or webService
movementType	yes	MovementType: debit or credit
model	yes	ModelType: settlement or reversed
name	no	Descriptive label for the transfer type

Execute a transfer

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"
  }'

Field	Required	Notes
fromCardId	yes	Internal numeric identifier of the source card
toCardId	yes	Internal numeric identifier of the destination card
amount	yes	Monetary amount to transfer
observations	no	Optional note describing the reason of the transfer

Query a transfer

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

List transfers on a card

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

Returns both incoming and outgoing transfers for the given month.

Errors

Code	Name	Meaning
7300	ERROR_CREATING_TRANSFER	The transfer could not be created
7301	ERROR_UPDATING_TRANSFER	The transfer could not be updated
7302	ERROR_GETTING_HISTORY	Movement/transfer history could not be retrieved
7303	INSUFFICIENT_FUNDS	Source card balance too low
7304	INVALID_TRANSFER_STATUS	Transfer is in a status that does not allow the operation
7305	ERROR_CREATING_TRANSFER_TYPE	A transfer type could not be created
7306	CARD_TRANSFER_NOT_FOUND	The referenced transfer does not exist

See the full Error Catalog for the complete list.