Z Zise Developers
/
账户中心 › 指南

平台资料池独占绑定到某个会员，只用来向开卡行建用卡人。不是实名，也不能做速汇。

快捷 KYC

这不是下面三件事中的任何一件：

那件事它做什么和快捷 KYC 的差别
托管屏 L1会员自己填资料，通过后 level 变成 1快捷 KYC 不抬 level
POST /v1/kyc/applications复用该会员自己已过审的基础 KYC那条路会让速汇也能走
发卡「快捷申请」从库存盲发实体卡不管虚拟卡，也不独占一份身份

快捷 KYC 是：平台维护一批已通过的身份包 → 独占绑到你名下的某个会员 → 用这份资料向开卡行提交用卡人 → 只开卡。

L0 会员可以使用快捷资料开卡，不必先通过本人 L1。 前提是商户已开通快捷资料、会员绑定有效且资料符合目标产品要求。要求 L2 的卡产品不能使用快捷资料绕过认证。

开卡资格与本人认证等级独立：快捷绑定不会建立或覆盖本人实名档案，也不会把 level 从 0 改成 1。已通过真实 L1 / L2 的会员也可显式选择快捷资料，原认证等级保持不变。

读已绑列表


GET /v1/kyc/quick


{
  "bindings": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "identity_type": "passport",
      "identity_issue_country": "HK",
      "nationality": "HK",
      "address_country": "HK",
      "created_at": "2026-09-05T06:12:00.000Z"
    }
  ],
  "remaining": 4
}

identity_issue_country 是绑定的快捷资料的证件签发国家，返回两位国家代码（如 HK），不取会员本人实名资料。它与 nationality（国籍）、address_country（居住国家）分别返回；历史快捷资料未填写签发国家时返回空字符串。查询列表、GET /v1/kyc 的 quick_kyc.bindings，以及首次绑定或复用的 binding 都包含此字段。

⚠ 不下发证件号与影像。

⚠ GET /v1/kyc 也带同样一段 quick_kyc。不要把 bindings.length > 0 当成 level >= 1。

显式绑定


POST /v1/kyc/quick

传 card_product_id（按该卡产品的国家、证件及持卡人姓名要求匹配），或 country + identity_type。按国家选择的资料，后续仍需通过目标卡产品的开卡校验。普通 KYC 和快捷 KYC 的中文姓名、地址等文本均在提交服务方前统一转为无声调拼音；姓名按转换结果检查产品要求。原始档案保留，邮箱、证件号、电话、国家代码和附件标识不参与转换。新分配还必须传 email，且这个邮箱从未用于任何普通 KYC、快捷资料池或历史档案，包含自己的已实名记录、被驳回、删除或停用的记录。比较时去除首尾空格、忽略大小写，保留 Gmail +别名。建议邮箱含别名在内不超过 50 个字符，以满足限制最严格的卡产品。按产品申请时，超过该产品邮箱长度上限会在分配和扣费前拒绝。


{"card_product_id":"cpd_42","email":"member+quick20260906@gmail.com"}

缺失或格式错误返回 invalid_fields，邮箱已用过返回 request_rejected；均不会扣费或占用资料。复用已有绑定不需要新邮箱，也不会修改已绑定邮箱。

平台自营扣会员可用余额；下游 merchant_hosted 扣你的预付。钱不够整笔失败，资料不会被占住。

会员已经通过真实 L1 / L2 也可以绑定快捷 KYC。两者独立保存，绑定不会覆盖真实实名档案，也不会改变原有实名等级与业务权限。

L0 绑定、报价、开卡

以下请求使用同一商户凭据和同一 x-on-behalf-of（会员的 external_member_id 或 mem_…）。需要 kyc:write、cards:read、cards:write 权限；POST 按开放 API 签名规则携带 x-idempotency-key。每个独立操作使用不同的请求幂等键，重试原操作时保留原键和原请求体。

  1. 从 GET /v1/cards/products 选择已开放的产品，将其 id 作为上文显式绑定的 card_product_id。
  2. 调用 POST /v1/kyc/quick，保存响应中的 binding.id。
  3. 使用该绑定报价：

GET /v1/cards/products/{id}/quote?quick_kyc_binding_id=7c9e6679-7425-40de-944b-e07fc1f90ae7

把路径中的 {id} 替换为所选产品 ID，例如 cpd_42。can_apply: true 表示该会员使用所选资料通过准入检查。它不会扣费，也不保证提交时余额足够；申请时仍会重新检查账户、产品、额度与资金。

  1. 在申请体中传入同一个 quick_kyc_binding_id：

{
  "product_id": "cpd_42",
  "quick_kyc_binding_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "source_asset": "USDT",
  "first_topup": "0",
  "funding_source": "merchant",
  "client_key": "member-42-card-order-001"
}

以上示例用于允许不首充的产品；其他产品按目录中的首充下限传值。funding_source: merchant 仅供 merchant_hosted 商户使用，开卡批发成本与首充扣商户预付，不扣会员钱包。默认 member 模式要求会员钱包足够支付开卡费及首充，同时商户预付也必须满足批发成本要求。快捷资料费与开卡费分别记账，复用绑定不再收资料费。

  1. 保存返回的申请 id，通过 GET /v1/cards/applications/{id} 回查并处理开卡事件通知。201 只表示已受理，不代表已出卡；人工审核产品会先返回 pending_review，自动审核产品先返回 submitted，发卡成功后详情才为 issued。

client_key 是开卡业务幂等键：同一笔业务重试时保持不变，即使请求头幂等窗口已过期，也不会重复开卡或收开卡费。不要为网络重试生成新的 client_key。

报价与申请使用的绑定必须属于当前商户、当前会员。绑定无效或属于他人时返回 invalid_fields；所选资料不满足产品要求时，先根据报价中的 reason 处理，不能靠切换会员绕过。

自动复用或分配

POST /v1/cards/applications 在会员没有真实 L1 时，会自动复用或分配。新分配须传 quick_kyc_email。不必先调 POST /v1/kyc/quick。

已有普通实名档案但尚未通过审核时，不会自动改用快捷资料。需要使用快捷资料开卡的会员（包括 L0、L1 和 L2），都可以按上面的流程显式选择 quick_kyc_binding_id。

已有一份资料的国家及证件满足该卡产品，优先复用，不再收资料费。

开卡失败不退已收取的资料费、不释放资料。同一条绑定可以换符合条件的产品再开。开卡费按开卡结果另行处理，不要把这两笔费用混为一笔。

速汇仍然要真实 L1

仅有快捷 KYC 的会员，GET /v1/kyc 的 level 仍是 0。快捷绑定不能替代速汇及其他业务所需的本人认证；L0 创建个人速汇账户返回 kyc_required，创建 L2 认证 session 返回 state_invalid。

要做这些业务，先走 托管屏 L1，再按业务要求完成 L2。使用过快捷资料不会阻止会员以后完成真实 L1 并继续申请 L2。

相关端点