> ## 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. # List Cards > 返回签发卡片对象的列表。对象按创建时间降序排列，最近创建的对象排在最前。 ## OpenAPI ````yaml /zh/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards openapi: 3.0.2 info: title: Issuing API version: 0.0.1 x-source-en-commit: 6841624 x-source-en-path: card-issuance/v1.6/issuing.yaml description: > UQPAY Issuing API 让你签发虚拟卡、管理持卡人，并监控卡交易。 ## 功能概览 - 创建并管理虚拟卡（签发、激活、冻结、注销） - 通过 KYC 完成持卡人入驻与验证 - 设置消费限额与卡控制 - 为卡余额充值与提现 - 查询卡交易与账户余额 - 在发卡账户之间转账 - 生成并下载报表 ## 身份认证 所有请求都需要携带有效的鉴权 Token，Token 通过 [Access Token](/zh/account-center/v1.6/api-reference/access-token) 接口获取。请在 `x-auth-token` 请求头中携带该 Token。 ## 幂等性 POST 请求支持 `x-idempotency-key` 请求头，可安全重试而不会创建重复资源。 contact: name: UQPAY Support Team url: https://www.uqpay.com/support email: support@uqpay.com license: name: Proprietary url: https://www.uqpay.com/legal/api-terms termsOfService: https://www.uqpay.com/legal/terms x-api-id: uqpay-issuing-api-v1.6.0 x-categories: - Card Issuing - Transaction Processing x-features: - Virtual Card Issuance - Real-time Processing - Webhook Notifications - Comprehensive Reporting - Transaction Monitoring servers: - url: https://api-sandbox.uqpaytech.com/api description: 沙盒环境基础 URL。 - url: https://api.uqpay.com/api description: 生产环境基础 URL。 security: [] tags: - name: Card Lifecycle description: 创建卡片并管理其完整生命周期——签发、查询、更新、激活、绑定与变更状态。 - name: Card Secure Data description: 通过 PCI 合规接口或令牌化 iframe 访问敏感卡数据（PAN、CVV）。是否可用取决于你的 PCI 状态，而非卡产品。 - name: Card Funding description: 为预付类卡片充值或提取其卡内储值余额。 - name: Card PIN description: 设置并管理卡片 PIN 码。`reset-pin` 用于实体卡，`manage-card-pin` 用于虚拟卡。 - name: Card Add-ons description: >- 产品专属的卡功能。每个操作仅适用于特定卡产品——参见 [卡产品](/zh/card-issuance/v1.6/guide/card-products)。 - name: Card Arts description: >- 管理发卡账户可用的视觉设计（卡面）。可设置账户级默认卡面，或在签发/更新卡片时传入 `card_art_id` 以按卡覆盖。仅 Personal Visa 支持。 - name: Cardholders description: 你可以创建持卡人。持卡人是你企业的授权代表，可被签发卡片。 - name: Transactions description: 这些接口用于查询在你用户卡片上发生的交易信息。 - name: Products description: 通过这组接口，你可以为客户创建卡订单。 - name: Balances description: 各币种的可用金额与待处理金额会进一步按资金来源类型细分。你可以查询它，查看发卡账户当前的余额。 - name: Transfers description: 在发卡账户之间转账。 - name: Reports description: 生成并下载发卡报表。 - name: Simulator description: 在沙盒环境中模拟卡交易。 paths: /v1/issuing/cards: get: tags: - Card Lifecycle summary: List Cards description: 返回签发卡片对象的列表。对象按创建时间降序排列，最近创建的对象排在最前。 operationId: list-cards parameters: - $ref: '#/components/parameters/XOnBehalfOf' - $ref: '#/components/parameters/CardListPageSize' - $ref: '#/components/parameters/PageNumber' - $ref: '#/components/parameters/PathCardNumber' - $ref: '#/components/parameters/PathCardStatus' - $ref: '#/components/parameters/PathCardholderId' responses: '200': description: 成功获取卡片列表。 headers: x-response-id: $ref: '#/components/headers/XResponseId' content: application/json: examples: sandbox: summary: Sandbox response value: data: - available_balance: '0.00' card_bin: '40963608' card_currency: SGD card_id: bee452a7-1da0-495d-afe3-8181c9a00a77 card_limit: '0.00' card_name: Marshall Hu's card card_number: '****************' card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: PENDING cardholder: cardholder_id: 3a1d3ce4-977b-4f1d-8076-8d2dd59e942c cardholder_status: SUCCESS create_time: '2025-10-11T11:52:27+08:00' email: updated-1784890576736@example.com first_name: Marshall last_name: Hu consumed_amount: '0.00' create_time: '2025-10-15T14:19:55+08:00' form_factor: PHYSICAL metadata: '' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' - available_balance: '0.00' card_bin: '40963608' card_currency: SGD card_id: f10ec927-9edb-4c95-973e-07508285fcdf card_limit: '0.00' card_name: John Doe's card card_number: '****************' card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: PENDING cardholder: cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 cardholder_status: SUCCESS create_time: '2025-10-11T11:54:16+08:00' email: johndoe@uqpay.com first_name: John last_name: Doe consumed_amount: '0.00' create_time: '2025-10-15T14:18:33+08:00' form_factor: PHYSICAL metadata: '' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' - available_balance: '0.00' card_bin: '40963608' card_currency: USD card_id: 340610dd-451b-4ed5-a12c-0d64267b2cd1 card_limit: '0.00' card_name: John Doe's card card_number: 40963608****9025 card_product_id: 467e993f-317a-49fc-9ea0-bf49de7d1f76 card_scheme: VISA card_status: CANCELLED cardholder: cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 cardholder_status: SUCCESS create_time: '2025-10-11T11:54:16+08:00' email: johndoe@uqpay.com first_name: John last_name: Doe consumed_amount: '0.00' create_time: '2025-10-15T14:15:47+08:00' form_factor: VIRTUAL metadata: '' mode_type: SHARE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: test - available_balance: '81.39' card_bin: '40963608' card_currency: SGD card_id: 63da6f07-83b8-4b8c-ba71-e2b955275af6 card_limit: '0.00' card_name: John Doe's card card_number: 40963608****9587 card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 cardholder_status: SUCCESS create_time: '2025-10-11T11:54:16+08:00' email: johndoe@uqpay.com first_name: John last_name: Doe consumed_amount: '28.61' create_time: '2025-10-14T15:53:59+08:00' form_factor: VIRTUAL metadata: '{"":""}' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' blocked_mcc: - '6011' update_reason: '' - available_balance: '20.00' card_bin: '40963608' card_currency: USD card_id: 2f04dc5c-16dd-401a-90c2-e74390f46692 card_limit: '0.00' card_name: Marshall Hu's card card_number: 40963608****3820 card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 3a1d3ce4-977b-4f1d-8076-8d2dd59e942c cardholder_status: SUCCESS create_time: '2025-10-11T11:52:27+08:00' email: updated-1784890576736@example.com first_name: Marshall last_name: Hu consumed_amount: '60.00' create_time: '2025-10-13T18:22:27+08:00' form_factor: PHYSICAL metadata: '' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' - available_balance: '-14.45' card_bin: '40963608' card_currency: USD card_id: 42a3f607-8a2f-473a-a8b9-e2f7693383c0 card_limit: '0.00' card_name: Marshall Hu's card card_number: 40963608****1576 card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 3a1d3ce4-977b-4f1d-8076-8d2dd59e942c cardholder_status: SUCCESS create_time: '2025-10-11T11:52:27+08:00' email: updated-1784890576736@example.com first_name: Marshall last_name: Hu consumed_amount: '60.01' create_time: '2025-10-11T14:13:16+08:00' form_factor: PHYSICAL metadata: '{"":""}' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' allowed_mcc: - '6011' update_reason: '' - available_balance: '-10.00' card_bin: '40963608' card_currency: USD card_id: 34410dcb-b648-4f1c-9e52-c9ac234ac028 card_limit: '0.00' card_name: John Doe's card card_number: 40963608****2004 card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 9efdc467-ec15-4d7b-bdb9-61f375f809f6 cardholder_status: SUCCESS create_time: '2025-10-11T11:54:16+08:00' email: johndoe@uqpay.com first_name: John last_name: Doe consumed_amount: '60.00' create_time: '2025-10-11T14:04:03+08:00' form_factor: PHYSICAL metadata: '{"":""}' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' - available_balance: '90074.50' card_bin: '40963608' card_currency: USD card_id: b3dd7e47-f8b7-4790-aa47-a0e37bae7757 card_limit: '0.00' card_name: Marshall Hu's card card_number: 40963608****9637 card_product_id: d7443616-219c-4ccb-baab-e8ed837f1755 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 3a1d3ce4-977b-4f1d-8076-8d2dd59e942c cardholder_status: SUCCESS create_time: '2025-10-11T11:52:27+08:00' email: updated-1784890576736@example.com first_name: Marshall last_name: Hu consumed_amount: '25.50' create_time: '2025-10-11T13:55:21+08:00' form_factor: VIRTUAL metadata: '' mode_type: SINGLE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' - available_balance: '97.93' card_bin: '40963608' card_currency: USD card_id: c91af40d-1b5f-4593-ac7e-114c1c31295d card_limit: '110.00' card_name: Marshall Hu's card card_number: 40963608****9769 card_product_id: 467e993f-317a-49fc-9ea0-bf49de7d1f76 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 3a1d3ce4-977b-4f1d-8076-8d2dd59e942c cardholder_status: SUCCESS create_time: '2025-10-11T11:52:27+08:00' email: updated-1784890576736@example.com first_name: Marshall last_name: Hu consumed_amount: '12.07' create_time: '2025-10-11T13:53:12+08:00' form_factor: VIRTUAL metadata: '' mode_type: SHARE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' - available_balance: '1759.20' card_bin: '40963608' card_currency: SGD card_id: e3577e62-5526-4284-a5b7-f718d83654ee card_limit: '2099.02' card_name: Marshall Hu's card card_number: 40963608****9892 card_product_id: 467e993f-317a-49fc-9ea0-bf49de7d1f76 card_scheme: VISA card_status: ACTIVE cardholder: cardholder_id: 3a1d3ce4-977b-4f1d-8076-8d2dd59e942c cardholder_status: SUCCESS create_time: '2025-10-11T11:52:27+08:00' email: updated-1784890576736@example.com first_name: Marshall last_name: Hu consumed_amount: '339.82' create_time: '2025-10-11T13:36:30+08:00' form_factor: VIRTUAL metadata: >- {"contract_regression_run":"f9182c18-9377-4b32-ad53-18e8b1763d0b"} mode_type: SHARE network_protection: enabled: false status: NOT_ENROLLED risk_controls: allow_3ds_transactions: 'Y' update_reason: '' total_items: 210 total_pages: 3 schema: title: ListCardsResponse properties: total_pages: $ref: '#/components/schemas/TotalPages' total_items: $ref: '#/components/schemas/TotalItems' data: type: array items: $ref: '#/components/schemas/ListCardsResponse' security: - XAuthToken: [] components: parameters: XOnBehalfOf: in: header name: x-on-behalf-of schema: type: string required: false description: > 指定代表哪个子账户发起请求。应设置为 `account_id`，该值可通过 [List Connected Accounts](/zh/account-center/v1.6/api-reference/list-connected-accounts) 接口获取。若省略或为空，则请求以主账户身份执行。 更多信息参见 [关联账户](/zh/account-center/v1.6/guide/connected-accounts)。 example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be CardListPageSize: name: page_size description: 每页返回的最大条目数。取值范围为 1 - 100，默认为 10。 in: query required: true schema: type: integer minimum: 1 maximum: 100 default: 10 example: 10 PageNumber: name: page_number description: 用于获取下一组条目的页码。取值必须大于 1，默认为 1。 in: query required: true schema: type: integer minimum: 1 default: 1 example: 1 PathCardNumber: name: card_number description: 完整卡号。 in: query required: false schema: type: string example: '4096360811214526' PathCardStatus: name: card_status description: 按指定卡片状态检索条目。未指定时匹配任意卡片状态。 in: query required: false schema: $ref: '#/components/schemas/CardStatus' PathCardholderId: name: cardholder_id in: query required: false schema: $ref: '#/components/schemas/CardholderId' headers: XResponseId: description: 响应的全局唯一标识符（UUID v4）。在联系 UQPAY 支持团队时有助于定位某次请求。 schema: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde schemas: TotalPages: type: integer example: 1 description: 可用条目的总页数。 TotalItems: type: integer example: 10 description: 可用条目的总数。 ListCardsResponse: type: object required: - card_id - card_bin - mode_type - card_scheme - card_number - form_factor - card_limit - available_balance - cardholder - card_status properties: card_id: $ref: '#/components/schemas/CardId' card_bin: $ref: '#/components/schemas/CardBin' card_scheme: $ref: '#/components/schemas/CardScheme' card_currency: $ref: '#/components/schemas/CardCurrency' card_number: $ref: '#/components/schemas/CardNumber' form_factor: $ref: '#/components/schemas/FormFactor' mode_type: $ref: '#/components/schemas/ModeType' card_product_id: $ref: '#/components/schemas/CardProductId' card_limit: type: string description: 分配给卡片的总信用额度，币种为 `card_currency`。 available_balance: type: string example: 2000.05 description: 可用余额，币种参见 `card_currency`。 cardholder: $ref: '#/components/schemas/CardholderListCardsResponse' risk_controls: description: 卡级风控配置；未返回该卡的风控配置时为 null。 oneOf: - $ref: '#/components/schemas/RiskControls' title: Card risk controls - title: No card risk controls type: object nullable: true enum: - null network_protection: $ref: '#/components/schemas/NetworkProtection' metadata: type: string description: 以 JSON 字符串编码的卡片元数据。未设置元数据时返回空字符串。 card_status: $ref: '#/components/schemas/CardStatus' update_reason: $ref: '#/components/schemas/UpdateReason' consumed_amount: $ref: '#/components/schemas/ConsumedAmount' CardStatus: type: string description: > 卡片状态枚举。更多信息参见卡生命周期与状态指南。 - `PENDING`：创建卡片的请求已收到，正在审核中。 - `ACTIVE`：创建卡片的请求成功，卡片可以使用。 - `FROZEN`：所有进入的授权请求都将被拒绝。卡片可以重新激活以接受新的授权。 - `BLOCKED`：因可疑活动，卡片被 UQPAY 锁定。 - `PRE_CANCEL`：卡片已被安排注销，处于等待期，期间所有进入的授权请求都将被拒绝。等待期结束后转为 `CANCELLED`。 - `CANCELLED`：卡片无法再从此状态重新激活，所有进入的授权请求都将被永久拒绝。 - `LOST`：卡片已向 UQPAY 报失。 - `STOLEN`：卡片已向 UQPAY 报被盗。 - `FAILED`：使用 [创建卡片](/zh/card-issuance/v1.6/api-reference/create-card) 创建卡片的请求失败。 example: ACTIVE enum: - PENDING - ACTIVE - FROZEN - BLOCKED - PRE_CANCEL - CANCELLED - LOST - STOLEN - FAILED CardholderId: type: string description: 持卡人的唯一标识符。 example: 7c4ff2cd-1bf6-4aaa-bf16-266771425011 format: uuid CardId: type: string example: c0cef051-29c5-4796-b86a-cd5b684bfad7 description: 卡片的唯一标识符。 CardBin: type: string example: '40963608' description: 卡号前缀（BIN）。 CardScheme: type: string example: VISA description: 卡组织。 CardCurrency: type: string example: USD description: 卡币种。 enum: - SGD - USD - XUSD CardNumber: type: string example: '************5668' description: 脱敏卡号 FormFactor: type: string example: VIRTUAL description: 卡片形态——`VIRTUAL` 或 `PHYSICAL`，目前仅支持虚拟卡。 enum: - VIRTUAL - PHYSICAL ModeType: type: string example: SHARE enum: - SHARE - SINGLE description: | 模式类型枚举 - SINGLE 或 SHARE。 * `SINGLE` - 单卡仅支持预付模式。 * `SHARE` - 共享卡可支持借记模式，即关联借记产品和账户。 CardProductId: type: string description: 卡产品的唯一标识符。 example: 3bd1656b-e691-4aab-a76a-3ead39e7a6f6 format: uuid CardholderListCardsResponse: type: object properties: cardholder_id: $ref: '#/components/schemas/CardholderId' cardholder_status: $ref: '#/components/schemas/CardholderStatus' create_time: description: 对象的创建时间。 type: string example: '2024-05-09 15:52:23' email: $ref: '#/components/schemas/CardholderEmail' first_name: description: 该持卡人的名字。激活卡片前必填。此字段不能包含任何数字、特殊字符（句点、逗号、连字符、空格和撇号除外）或非拉丁字母。 type: string example: Emily last_name: description: 该持卡人的姓氏。激活卡片前必填。此字段不能包含任何数字、特殊字符（句点、逗号、连字符、空格和撇号除外）或非拉丁字母。 type: string example: Toy RiskControls: type: object description: | 用户自定义的风控设置。 支持的配置取决于卡产品。能力矩阵参见 [卡产品](/zh/card-issuance/v1.6/guide/card-products)。 properties: enable_3ds: $ref: '#/components/schemas/Enable3ds' allow_3ds_transactions: $ref: '#/components/schemas/Allow3dsTransactions' allowed_mcc: $ref: '#/components/schemas/AllowedMcc' blocked_mcc: $ref: '#/components/schemas/BlockedMcc' allowed_merchants: $ref: '#/components/schemas/AllowedMerchants' blocked_merchants: $ref: '#/components/schemas/BlockedMerchants' NetworkProtection: type: object description: 嵌入在卡片响应对象中的 ASAF Network Protection 状态。仅 Visa 卡片返回。 properties: enabled: type: boolean example: true description: 该卡片当前是否启用了 Network Protection。 card_scheme: type: string nullable: true example: VISA action_code: $ref: '#/components/schemas/NetworkProtectionActionCode' definition: type: string nullable: true example: Lost card, pickup description: '`action_code` 的可读描述。' status: $ref: '#/components/schemas/NetworkProtectionStatus' submitted_time: type: string format: date-time nullable: true example: '2026-05-14T09:00:00Z' description: 最近一次注册或移除请求提交的时间。 UpdateReason: type: string description: 更新卡片状态的原因。 maxLength: 100 minLength: 0 ConsumedAmount: type: string description: 反映卡限额中已使用的累计金额。 example: '51.00' CardholderStatus: description: 持卡人的状态。 type: string default: SUCCESS enum: - FAILED - PENDING - SUCCESS - INCOMPLETE CardholderEmail: type: string description: 持卡人的电子邮箱地址。 example: demo@example.com Enable3ds: type: string description: > 控制是否为该卡片注册 [3D Secure](https://en.wikipedia.org/wiki/3-D_Secure)。 - `Y` —— 注册 3DS。交易时的验证行为随后由 `allow_3ds_transactions` 决定。 - `N` —— 不注册 3DS。线上交易完全跳过 3DS 验证。 仅 **Business Visa** 和 **Personal Visa** 支持；Business Mastercard 上忽略此字段。参见 [卡产品](/zh/card-issuance/v1.6/guide/card-products)。 仅当卡片上显式设置时才返回。未设置时，卡片遵循账户级 3DS 配置。 仅当卡片处于 `PENDING` 或 `ACTIVE` 状态时可修改。 enum: - 'Y' - 'N' example: 'Y' Allow3dsTransactions: type: string description: > 决定当交易触发 3DS 时，是否允许 [3D Secure](https://en.wikipedia.org/wiki/3-D_Secure) 验证流程。 - **创建卡片时：** 未提供则默认为 `Y`。 - **更新卡片时：** 无默认值。未提供则保持现有值不变。 仅 **Business Visa** 支持。参见 [卡产品](/zh/card-issuance/v1.6/guide/card-products)。 > **注意：** 此字段仅在 `enable_3ds` 为 `Y` 时生效。若 `enable_3ds` 为 `N`，卡片完全跳过 3DS，此字段不起作用。 > **重要：** 当设为 `N` 时，你的卡片使用无摩擦 3DS 验证机制——交易无需输入 OTP 即可完成，并被视为已通过持卡人验证。因此，此类交易无法基于欺诈或未授权使用发起争议。为增强安全性，建议保持设为 `Y`。 - `Y`：可能需要 OTP 验证。 - `N`：不需要 OTP。 enum: - 'Y' - 'N' example: 'Y' AllowedMcc: type: array items: type: string description: | 指定允许交易的商户类别代码（MCC）白名单。 所有不在此列表中的 MCC 下的交易都将被拒绝。 **注意：** 每张卡只能配置 `allowed_mcc` 或 `blocked_mcc` 之一。若两者都未提供，交易将遵循默认风控逻辑。 example: null BlockedMcc: type: array items: type: string description: | 指定限制交易的商户类别代码（MCC）黑名单。 这些 MCC 下的交易将被拒绝，其他所有交易则按 UQPAY 标准风控评估流程处理。 **注意：** 每张卡只能配置 `allowed_mcc` 或 `blocked_mcc` 之一。若两者都未提供，交易将遵循默认风控逻辑。 example: - '5999' - '6011' AllowedMerchants: type: array items: type: string description: > 允许交易的商户编码白名单。与其他任何商户的交易都会被拒绝。 商户编码通过 [List Merchant Brands](/zh/card-issuance/v1.6/api-reference/list-merchant-brands) 查询。传入不存在的编码会被拒绝。 仅 **Business Visa** 支持。参见[卡产品](/zh/card-issuance/v1.6/guide/card-products)。 **注意：** 每张卡只能配置 `allowed_merchants` 或 `blocked_merchants` 之一，且列表不得超过 20 条。商户风控与 `allowed_mcc` / `blocked_mcc` 相互独立，因此同一张卡可以同时配置 MCC 规则和商户规则。 **更新卡片时：** 不传该字段表示保持当前值不变；传空数组表示清空。 example: - '10000668' - '10000418' BlockedMerchants: type: array items: type: string description: > 限制交易的商户编码黑名单。与这些商户的交易将被拒绝，其他所有交易则按 UQPAY 标准风控评估流程处理。 商户编码通过 [List Merchant Brands](/zh/card-issuance/v1.6/api-reference/list-merchant-brands) 查询。传入不存在的编码会被拒绝。 仅 **Business Visa** 支持。参见[卡产品](/zh/card-issuance/v1.6/guide/card-products)。 **注意：** 每张卡只能配置 `allowed_merchants` 或 `blocked_merchants` 之一，且列表不得超过 20 条。商户风控与 `allowed_mcc` / `blocked_mcc` 相互独立，因此同一张卡可以同时配置 MCC 规则和商户规则。 **更新卡片时：** 不传该字段表示保持当前值不变；传空数组表示清空。 example: - '10000668' - '10000418' NetworkProtectionActionCode: type: string description: > ASAF 操作码，表示卡片被注册到 Network Protection 的原因。以下定义沿用 ASAF 英文术语，与 API 返回的 `definition` 一致。 - `04` — Pickup card - `41` — Lost card, pickup - `43` — Stolen card, pickup - `46` — Closed account - `54` — Expired card enum: - '04' - '41' - '43' - '46' - '54' example: '41' NetworkProtectionStatus: type: string description: ASAF Network Protection 注册的生命周期状态。 enum: - NOT_ENROLLED - ENROLL_PENDING - ENROLL_FAILED - ENROLLED - REMOVAL_PENDING example: ENROLL_PENDING securitySchemes: XAuthToken: type: apiKey in: header name: x-auth-token description: 由 UQPAY 提供的登录 API Token。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.