开始签发卡片之前，先熟悉决定卡片行为的几个关键概念：形态（虚拟或实体）、模式（Single 或 Share），以及创建时可以配置的设置项。Documentation Index
Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt
Use this file to discover all available pages before exploring further.
卡形态
每张卡要么是虚拟卡，要么是实体卡。形态在创建或绑定卡片时确定 —— 之后无法修改。虚拟卡
虚拟卡没有实体载体。它包含用于线上交易的 PAN、过期日期和 CVV，创建后立即可用。- 通过 Create Card 接口创建。
- 无需激活 ——
card.create.succeededwebhook 触发后卡片即可使用。 - 不支持 ATM 取现。
实体卡
实体卡是预制的卡片，使用前必须绑定给持卡人并激活。- 通过 Assign Card 接口绑定。
- 首次使用前需要激活。
- 支持 ATM 取现（仅限特定 BIN）。
对比
| 特性 | 虚拟卡 | 实体卡 |
|---|---|---|
| 签发方式 | Create Card | Assign Card |
| 是否需要激活 | 否 | 是 |
| ATM 取现 | 不支持 | 支持 |
| 首次使用时间 | 立即 | 激活后 |
卡模式
每张卡运行在两种资金模式之一：Single 或 Share。模式决定资金如何在你的发卡账户余额和卡片之间流动。Single mode
Single mode 类似于预付卡。创建卡片时，资金从发卡账户余额转入卡片。Share mode
Share mode 类似于借记卡。卡片直接从发卡账户余额扣款，消费实时扣除。- 无需预先充值 —— 即使发卡账户余额小于
card_limit也能创建卡片。 card_limit作为消费上限，而不是预先充入的金额。- 支持创建后修改卡限额。
- 支持 充值（增加
card_available_balance但不实际转移资金）和 提现。 - 注销时无需退款，因为没有资金转入过卡片。
对比
| 特性 | Single mode | Share mode |
|---|---|---|
| 资金机制 | 从发卡账户余额预先充入 | 从发卡账户余额实时扣款 |
| 创建时的余额要求 | 发卡账户余额 ≥ card_limit | 无要求 |
| 是否支持修改卡限额 | 不支持 | 支持 |
| 充值 | 将资金从发卡账户余额转入卡片；增加 card_available_balance | 增加 card_available_balance 但不实际转移资金 |
| 提现 | 将资金从卡片退回发卡账户余额；减少 card_available_balance | 减少 card_available_balance 但不实际退款 |
| 注销退款 | 剩余余额自动退回 | 无需退款 |