Card Modes:

UQPAY provides two modes of cards: SINGLE mode and SHARE mode.

Single Mode: Cards must be pre-funded before use. Cards support recharge and withdraw. You can add funds to your card using the recharge function or withdraw available balances using the withdrawal function.
Share Mode: Share the funds in issuing account and you can set specific card limits for each card. Please note that the share mode cards do not support recharging or withdrawals.

Card Recharge

Card recharge allows you to fund a single mode card directly from your issuing account. This ensures that the card has sufficient funds to be used for transactions.

Card Recharge in the Dashboard

Navigate to Cards>My Cards page.
In the Action menu, click Card Recharge.
Enter the amount you wish to top up.
Click Confirm to complete the recharge.

Card Recharge Using the API

Request example

curl --request POST \
     --url https://api.sandbox.uqpay.tech/api/v1/issuing/cards/f3703ef0-f9cb-429c-93fe-5cb435cc1d96/recharge \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-auth-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtYXN0ZXJfaWQiOiIwIiwiY3VzdG9tZXJfaWQiOiJjZWRjYjE0MS0xM2IwLTRlMzItOTlkZC00MzQ1NWI1M2Q3MzciLCJhY2NvdW50X2lkIjoiY2VkY2IxNDEtMTNiMC00ZTMyLTk5ZGQtNDM0NTViNTNkNzM3IiwiYXBpX3ZlcnNpb24iOiJWMS4wIiwiY2xpZW50X2lkIjoiQ2tDNDNtUG84c1Fmb0RzZmk3dXluciIsInVzZXJfaWQiOiJDa0M0M21QbzhzUWZvRHNmaTd1eW5yIiwiZW1haWwiOiIiLCJzY29wZSI6IiIsInVzZXJfbmFtZSI6IlRlc3QiLCJkaXJlY3RfaWQiOiIwIiwib25fYmVoYWxmX2lkIjoiIiwib25fYmVoYWxmX25hbWUiOiIiLCJidXNfdHlwZSI6MCwiaXAiOiIxOC4xNjIuMTMzLjI0MSIsImV4cCI6MTczNjE1Mzc0NywiaXNzIjoidXFwYXkifQ.DViJJDOW4WT3xwgbApnChBvZLO3nfNXumdmTROOROzE' \
     --header 'x-idempotency-key: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be' \
     --data '{"amount":100}'

Response example

{
  "amount": 100,
  "card_currency": "USD",
  "card_id": "f3703ef0-f9cb-429c-93fe-5cb435cc1d96",
  "card_order_id": "291db670-66a2-4d75-9373-a935dbadba26",
  "complete_time": "",
  "create_time": "2025-01-06T13:58:38.41530115+08:00",
  "order_status": "PROCESSING",
  "order_type": "CARD_RECHARGE",
  "update_time": "2025-01-06T13:58:38.415301208+08:00"
}

Card Withdraw

If you want to cancel a single mode card, card withdrawal will be needed. The money withdrawn from the card will be transferred to the issuing account directly.

Card Withdraw in the Dashboard

Navigate to Cards>My Cards page.
In the Action menu, click Card Withdraw.
Enter the amount you wish to withdraw.
Click Confirm.

Card Withdraw Using the API

Request example

curl --request POST \
     --url https://api.sandbox.uqpay.tech/api/v1/issuing/cards/f3703ef0-f9cb-429c-93fe-5cb435cc1d96/withdraw \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-auth-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtYXN0ZXJfaWQiOiIwIiwiY3VzdG9tZXJfaWQiOiJjZWRjYjE0MS0xM2IwLTRlMzItOTlkZC00MzQ1NWI1M2Q3MzciLCJhY2NvdW50X2lkIjoiY2VkY2IxNDEtMTNiMC00ZTMyLTk5ZGQtNDM0NTViNTNkNzM3IiwiYXBpX3ZlcnNpb24iOiJWMS4wIiwiY2xpZW50X2lkIjoiQ2tDNDNtUG84c1Fmb0RzZmk3dXluciIsInVzZXJfaWQiOiJDa0M0M21QbzhzUWZvRHNmaTd1eW5yIiwiZW1haWwiOiIiLCJzY29wZSI6IiIsInVzZXJfbmFtZSI6IlRlc3QiLCJkaXJlY3RfaWQiOiIwIiwib25fYmVoYWxmX2lkIjoiIiwib25fYmVoYWxmX25hbWUiOiIiLCJidXNfdHlwZSI6MCwiaXAiOiIxOC4xNjIuMTMzLjI0MSIsImV4cCI6MTczNjE1Mzc0NywiaXNzIjoidXFwYXkifQ.DViJJDOW4WT3xwgbApnChBvZLO3nfNXumdmTROOROzE' \
     --header 'x-idempotency-key: 18520f72-f4de-4f9c-bb8e-ec7d1c4f32be' \
     --data '{"amount":50}'

Response example

{
  "amount": 50,
  "card_currency": "USD",
  "card_id": "f3703ef0-f9cb-429c-93fe-5cb435cc1d96",
  "card_order_id": "59d1c790-beb1-4f74-90b3-b5caebf265ec",
  "complete_time": "",
  "create_time": "2025-01-06T14:00:53.24508523+08:00",
  "order_status": "PROCESSING",
  "order_type": "CARD_WITHDRAW",
  "update_time": "2025-01-06T14:00:53.245085288+08:00"
}