Skip to main content
Before cards can transact, your issuing balance must have sufficient funds. How funds flow depends on the card mode:
  • Share mode — Transactions deduct directly from the issuing balance. The card’s card_limit acts as a spending cap.
  • Single mode — Funds are transferred from the issuing balance into the card at creation. The card operates on its own pre-funded balance.

​
Deposit to your issuing balance

Use the Dashboard to deposit funds from your banking account into your issuing balance.
  1. Sign in to the Dashboard and select Card Issuance.
funding your issuing balance 1
  1. Select the Deposit button.
funding your issuing balance 2
  1. Select the currency (USD or SGD) and enter the amount.
  2. Press Transfer to process.
funding your issuing balance 3

​
Transfer between main and sub-accounts

If you use sub-accounts, you can transfer funds between your main issuing account and sub-accounts. Via API: Use the Create Issuing Transfer endpoint: 
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/transfers \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "source_account_id": "main-account-uuid",
    "destination_account_id": "sub-account-uuid",
    "amount": 5000,
    "currency": "USD"
  }'
  1. Navigate to the Transfer screen.
  2. Click New transfer in the top-right corner.
  3. Fill in source account, destination account, and currency.
  4. Click Create.
funding your issuing balance 3 2funding your issuing balance 4

​
Check your issuing balance

Use the Retrieve Issuing Balance or List Issuing Balances endpoints to check your current balance. 
curl "https://api-sandbox.uqpaytech.com/api/v1/issuing/balances?page_number=1&page_size=10" \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

​
Manage card-level balances

​
Recharge a card

Add funds to a card using the Card Recharge endpoint.
  • Single mode: Transfers funds from the issuing balance into the card.
  • Share mode: Increases card_available_balance without transferring funds.
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/{card_id}/recharge \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500}'
A card.recharge.succeeded webhook fires upon completion.

​
Withdraw from a card

Remove funds from a card using the Card Withdraw endpoint.
  • Single mode: Returns funds from the card to the issuing balance.
  • Share mode: Decreases card_available_balance.
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/{card_id}/withdraw \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{"amount": 200}'
A card.withdraw.succeeded webhook fires upon completion.