Fund your issuing balance

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.

Dashboard: Deposit to main issuing account

In the merchant portal, open Cards and remain on the Overview tab.
Select Deposit. The button is available when your account has an active issuing balance and the required permission.
Choose the source account: Banking or Crypto. The portal shows only currencies available in both the source and issuing balances.
Enter the amount, review the fee and total debit, then confirm the transfer.

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

Dashboard: Transfer between accounts

Open Cards and select Transfer from Quick actions. This entry appears only when internal issuing transfers are enabled for your account.
Select the source and destination accounts and choose a currency supported by both.
Enter the amount and create the transfer.

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.

Core concepts — Single vs. Share mode funding differences
Card Recharged webhook
Card Withdraw webhook
List Issuing Balances API

Getting Started

Cardholders

Cards

Funding

Controls & Security

Integration

Reference

Deposit to your issuing balance

Transfer between main and sub-accounts

Check your issuing balance

Manage card-level balances

Recharge a card

Withdraw from a card

​Deposit to your issuing balance

​Transfer between main and sub-accounts

​Check your issuing balance

​Manage card-level balances

​Recharge a card

​Withdraw from a card

​Related

Deposit to your issuing balance

Transfer between main and sub-accounts

Check your issuing balance

Manage card-level balances

Recharge a card

Withdraw from a card

Related