开卡申请

post

https://uat-openapi.cafinx.com/v1/cards

创建虚拟卡。前置：bin 须在 GET /card-products 可开列表内；钱包足够 openFee+creditLimit（≥ minTopup）。【KYC 按产品】先看目录 requireThirdPartyKyc：true → 控制台一键认证已通过，或本请求传 kycProvider+kycReferenceId（DIDIT/SUMSUB/MyInfo/Jumio/Shufti，请求优先）；false → 不要求 KYC，勿当作全局强制。可选 holderId/holderName 须与当前 bin 产品线匹配。成功返回卡（last4）+ openFee/topup/totalCharge；失败 42201/42202。完整 PAN：GET /cards/{cardId}/secure。成功触发 card.issued。

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

bin

string

required

卡头 BIN，必须在 GET /card-products 返回列表内

creditLimit

string

开卡首充金额（字符串 USD），缺省=目录 minTopup；须 ≥ minTopup。入账卡 loadedBalance / availableBalance

alias

string

卡别名（商户侧业务标识）

holderName

string

持卡人英文姓名；未传 holderId 时按姓名建档/匹配后开卡（须与当前 bin 产品线一致）

holderId

string

本平台持卡人 ID（可选）；须属于当前 bin 对应产品线，不可跨产品线复用

kycProvider

string

第三方身份认证服务商（当 requireThirdPartyKyc=true 时与 kycReferenceId 二选一/组合于控制台认证）。枚举：DIDIT | SUMSUB | MyInfo | Jumio | Shufti

kycReferenceId

string

第三方 KYC 会话/档案 Reference ID，由上列服务商签发；与 kycProvider 一并传入时优先于控制台落库凭证透传发卡通道

Headers

X-Idempotency-Key

string

required

Idempotency key (<=64 chars, e.g. your business order no) required for write endpoints

Response

200Success