Top Up Card

Moves funds from the account balance to the card balance.

POST /api/v2/accounts/{account_uuid}/cards/{card_uuid}/topup

Request body

Field	Type	Required	Description
amount	number or string	Yes	Positive
currency	string	No	Default USD
description	string	No	Max 500 chars

{
  "amount": "50.00",
  "currency": "USD",
  "description": "Monthly budget"
}

Response (200)

{
  "cardUuid": "019cd7a9-8482-708a-addc-63885bd9403c",
  "status": null,
  "message": "Card top-up accepted",
  "amount": "50.00",
  "currency": "USD",
  "transactionId": null,
  "fromTransactionId": "019d34c9-99b7-721c-af8e-d23669f27ea0",
  "toTransactionId": "019d34c9-99b7-721c-af8e-d2366a6767d5"
}

fromTransactionId — debit transaction on the account side. toTransactionId — credit transaction on the card side. Use this ID to look up the transaction in GET /api/v2/transactions/cards.

---

Withdraw From Card

Returns funds from the card to the account.

POST /api/v2/accounts/{account_uuid}/cards/{card_uuid}/withdraw

Same body shape as top-up (amount, optional currency, description).

Some operations may be processed asynchronously; poll card balance or transactions if the response indicates processing.