术语表

术语	说明
Access Key	以 `ak_` 开头的商户 API 凭证标识，放在请求头 `X-Access-Key`
Base URL	环境根地址。沙箱 `https://uat-openapi.cafinx.com/v1`；生产 `https://openapi.cafinx.com/v1`
BIN / 卡头	卡号前缀对应的产品段；开卡时 `bin` 必须来自 `GET /card-products`
requireThirdPartyKyc	目录布尔字段。`true`＝该产品开卡须身份认证 Reference；`false`＝不要求。非全站强制
kycProvider	开卡可选：第三方认证服务商枚举 `DIDIT` / `SUMSUB` / `MyInfo` / `Jumio` / `Shufti`
kycReferenceId	开卡可选：上列服务商签发的会话/档案 Reference ID；与 `kycProvider` 一并透传
productLabel	产品线角标文案（展示用）
feeNotes	费率补充说明字符串数组（展示用）
kind=standard	常规独立卡（一卡一余额）
kind=shared	共享卡段；需先建额度池再开附属卡
共享卡组 / 额度池	多张附属卡共用一个余额池（`balance` / `totalAuthMoney`）
loadedBalance	卡上预付可用余额（字符串金额）
资金模型	消费只扣 USD 钱包；不足时自动将数字货币兑成 USD 补足
swap	钱包流水类型：自动/手动兑换
X-Idempotency-Key	写接口幂等键；同键 24h 内回放首次结果
Webhook	平台向商户回调 URL 推送的异步事件通知
eventId	Webhook 幂等键；商户侧须去重
3DS OTP	3DS 验证码（短时有效，勿长期明文存储）
chargeback_fee	钱包流水类型：拒付费（交易拒绝后可能从钱包扣除，可记负）
auth_fee	钱包流水类型：授权相关费用（按平台/商户费率从钱包扣除，可记负）
ACTIVE	卡状态：正常可用
FROZEN	卡状态：已冻结
CLOSED	卡状态：已销卡（不可恢复）
userNo	商户号，如 `CFX-XXXX`
RSA 签名	商户私钥加签、平台公钥验签的请求认证方式

更多错误码见错误码；事件列表见 Webhook。