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

# 核心概念

> 在签发卡片之前，先了解卡形态、资金模式和可配置项。

开始签发卡片之前，先熟悉决定卡片行为的几个关键概念：**形态**（虚拟或实体）、**模式**（Single 或 Share），以及创建时可以配置的**设置项**。

## 卡形态

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

### 虚拟卡

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

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

### 实体卡

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

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

### 对比

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

## 卡模式

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

### Single mode

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

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

### Share mode

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

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

### 对比

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

## 卡设置

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

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

## 下一步

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.