> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 为发卡账户余额充值

> 为发卡账户余额充值，并管理 Single 和 Share 模式下的卡级余额。

卡片可以交易之前，你的发卡账户余额必须有充足资金。资金流向取决于卡模式：

* **Share mode** —— 交易直接从发卡账户余额扣款。卡片的 `card_limit` 作为消费上限。
* **Single mode** —— 创建卡片时，资金从发卡账户余额转入卡片。卡片使用自己独立的预付余额。

<h2 id="deposit-to-your-issuing-balance">为发卡账户余额充值</h2>

在控制台中，把资金从你的银行账户充值到发卡账户余额。

<Accordion title="控制台：为主发卡账户充值">
  1. 登录控制台，选择 **Card Issuance**。

  <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/card-issuance/funding-your-issuing-balance-1.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=c178db47b86e210425fe25067706ee4f" alt="funding your issuing balance 1" width="1352" height="734" data-path="images/card-issuance/funding-your-issuing-balance-1.png" />

  2. 点击 **Deposit** 按钮。

  <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/card-issuance/funding-your-issuing-balance-2.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=9416c569894f3ae325d4ba5934834118" alt="funding your issuing balance 2" width="1350" height="729" data-path="images/card-issuance/funding-your-issuing-balance-2.png" />

  3. 选择币种（USD 或 SGD），输入金额。
  4. 点击 **Transfer** 执行。

  <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/card-issuance/funding-your-issuing-balance-3.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=94aa1355174e6f100be3b6ddcd4c79fd" alt="funding your issuing balance 3" width="1352" height="735" data-path="images/card-issuance/funding-your-issuing-balance-3.png" />
</Accordion>

<h2 id="transfer-between-main-and-sub-accounts">主账户与子账户之间的转账</h2>

如果你使用了子账户，可以在主发卡账户和子账户之间转账。

**通过 API：** 使用 [Create Issuing Transfer](/zh/card-issuance/v1.6/api-reference/create-issuing-transfer) 接口：

```bash theme={null}
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"
  }'
```

<Accordion title="控制台：账户间转账">
  1. 进入 **Transfer** 页面。
  2. 点击右上角的 **New transfer**。
  3. 填写源账户、目标账户和币种。
  4. 点击 **Create**。

  <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/card-issuance/funding-your-issuing-balance-3-2.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=b3bef9f6613b4d49cd8ddd41cd8ad463" alt="funding your issuing balance 3 2" width="1907" height="687" data-path="images/card-issuance/funding-your-issuing-balance-3-2.png" />

  <img src="https://mintcdn.com/uqpay-0838527a/ynKaMDHkJfeg6L8y/images/card-issuance/funding-your-issuing-balance-4.png?fit=max&auto=format&n=ynKaMDHkJfeg6L8y&q=85&s=955b21b963186e882babe42ebca8570d" alt="funding your issuing balance 4" width="511" height="490" data-path="images/card-issuance/funding-your-issuing-balance-4.png" />
</Accordion>

<h2 id="check-your-issuing-balance">查询发卡账户余额</h2>

使用 [Retrieve Issuing Balance](/zh/card-issuance/v1.6/api-reference/retrieve-issuing-balance) 或 [List Issuing Balances](/zh/card-issuance/v1.6/api-reference/list-issuing-balances) 接口查询当前余额。

```bash theme={null}
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"
```

<h2 id="manage-card-level-balances">管理卡级余额</h2>

<h3 id="recharge-a-card">卡片充值</h3>

使用 [Card Recharge](/zh/card-issuance/v1.6/api-reference/card-recharge) 接口为卡片充值。

* **Single mode**：把资金从发卡账户余额转入卡片。
* **Share mode**：增加 `card_available_balance`，但不实际转移资金。

```bash theme={null}
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}'
```

完成后会触发一次 `card.recharge.succeeded` [webhook](/zh/card-issuance/v1.6/webhooks/card-recharged)。

<h3 id="withdraw-from-a-card">从卡片提现</h3>

使用 [Card Withdraw](/zh/card-issuance/v1.6/api-reference/card-withdraw) 接口从卡片提现。

* **Single mode**：把资金从卡片退回发卡账户余额。
* **Share mode**：减少 `card_available_balance`。

```bash theme={null}
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}'
```

完成后会触发一次 `card.withdraw.succeeded` [webhook](/zh/card-issuance/v1.6/webhooks/card-withdraw)。

<h2 id="related">相关链接</h2>

* [核心概念](/zh/card-issuance/v1.6/guide/core-concepts) —— Single 与 Share 模式的资金差异
* [Card Recharged webhook](/zh/card-issuance/v1.6/webhooks/card-recharged)
* [Card Withdraw webhook](/zh/card-issuance/v1.6/webhooks/card-withdraw)
* [List Issuing Balances API](/zh/card-issuance/v1.6/api-reference/list-issuing-balances)