> ## 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），以及创建时可以配置的**设置项**。

<h2 id="card-forms">卡形态</h2>

每张卡要么是**虚拟卡**，要么是**实体卡**。形态在创建或绑定卡片时确定 —— 之后无法修改。

<h3 id="virtual-cards">虚拟卡</h3>

虚拟卡没有实体载体。它包含用于线上交易的 PAN、过期日期和 CVV，创建后立即可用。

* 通过 [Create Card](/zh/card-issuance/v1.6/api-reference/create-card) 接口创建。
* 无需激活 —— `card.create.succeeded` webhook 触发后卡片即可使用。
* 不支持 ATM 取现。

<h3 id="physical-cards">实体卡</h3>

实体卡是预制的卡片，使用前必须绑定给持卡人并激活。

* 通过 [Assign Card](/zh/card-issuance/v1.6/api-reference/assign-card) 接口绑定。
* 首次使用前需要[激活](/zh/card-issuance/v1.6/guide/issue-physical-cards)。
* 支持 ATM 取现（仅限特定 BIN）。

<h3 id="comparison">对比</h3>

| 特性     | 虚拟卡                                                             | 实体卡                                                             |
| ------ | --------------------------------------------------------------- | --------------------------------------------------------------- |
| 签发方式   | [Create Card](/zh/card-issuance/v1.6/api-reference/create-card) | [Assign Card](/zh/card-issuance/v1.6/api-reference/assign-card) |
| 是否需要激活 | 否                                                               | 是                                                               |
| ATM 取现 | 不支持                                                             | 支持                                                              |
| 首次使用时间 | 立即                                                              | 激活后                                                             |

<h2 id="card-modes">卡模式</h2>

每张卡运行在两种资金模式之一：**Single** 或 **Share**。模式决定资金如何在你的发卡账户余额和卡片之间流动。

<h3 id="single-mode">Single mode</h3>

Single mode 类似于预付卡。创建卡片时，资金从发卡账户余额转入卡片。

* 创建时发卡账户余额必须大于或等于 `card_limit`，否则请求失败。
* 支持 [充值](/zh/card-issuance/v1.6/api-reference/card-recharge)和 [提现](/zh/card-issuance/v1.6/api-reference/card-withdraw)。
* **不**支持创建后修改卡限额。
* 卡片注销时，剩余余额自动退回发卡账户余额。

<h3 id="share-mode">Share mode</h3>

Share mode 类似于借记卡。卡片直接从发卡账户余额扣款，消费实时扣除。

* 无需预先充值 —— 即使发卡账户余额小于 `card_limit` 也能创建卡片。
* `card_limit` 作为消费上限，而不是预先充入的金额。
* 支持创建后修改卡限额。
* 支持 [充值](/zh/card-issuance/v1.6/api-reference/card-recharge)（增加 `card_available_balance` 但不实际转移资金）和 [提现](/zh/card-issuance/v1.6/api-reference/card-withdraw)。
* 注销时无需退款，因为没有资金转入过卡片。

<h3 id="comparison">对比</h3>

| 特性        | Single mode                                | Share mode                           |
| --------- | ------------------------------------------ | ------------------------------------ |
| 资金机制      | 从发卡账户余额预先充入                                | 从发卡账户余额实时扣款                          |
| 创建时的余额要求  | 发卡账户余额 ≥ `card_limit`                      | 无要求                                  |
| 是否支持修改卡限额 | 不支持                                        | 支持                                   |
| 充值        | 将资金从发卡账户余额转入卡片；增加 `card_available_balance` | 增加 `card_available_balance` 但不实际转移资金 |
| 提现        | 将资金从卡片退回发卡账户余额；减少 `card_available_balance` | 减少 `card_available_balance` 但不实际退款   |
| 注销退款      | 剩余余额自动退回                                   | 无需退款                                 |

<h2 id="card-settings">卡设置</h2>

创建或绑定卡片时需要配置以下设置项：

| 设置项        | 说明                     | 创建后是否可改                                                                       |
| ---------- | ---------------------- | ----------------------------------------------------------------------------- |
| **卡形态**    | `VIRTUAL` 或 `PHYSICAL` | 否                                                                             |
| **卡模式**    | `SINGLE` 或 `SHARE`     | 否                                                                             |
| **结算币种**   | `USD` 或 `SGD`          | 否                                                                             |
| **卡限额**    | 卡片的最大消费金额              | 仅 Share mode 支持                                                               |
| **消费限额**   | 单笔消费限额                 | 是 —— 参见 [消费限额](/zh/card-issuance/v1.6/guide/spending-controls)                |
| **MCC 限制** | 允许或禁止的商户类别代码           | 是 —— 参见 [MCC 限制](/zh/card-issuance/v1.6/guide/spending-controls#mcc-controls) |

<h2 id="next-steps">下一步</h2>

* [快速开始](/zh/card-issuance/v1.6/guide/quickstart) —— 签发你的第一张虚拟卡
* [创建持卡人](/zh/card-issuance/v1.6/guide/create-and-manage-cardholders) —— 在发卡前先注册持卡人身份