对接模式说明
授信模式（CREDIT_EXTENSION）
持卡人真实的资产，包括资产的充提，在商户侧系统完成闭环，所有持卡人资金由商户自己管理。 商户进行额度划转完成授信，需要充值备付金。持卡人消费时，从备付金完成资金扣除。 适用场景：- 商户自行管理持卡人资金
- 需要完整的账户体系和划转功能
- 对实时性要求相对较低
授权模式（AUTHORIZATION）
持卡人真实的资产，包括资产的充提，在商户侧系统完成闭环，所有持卡人资金由商户自己管理。 持卡人发生消费时，KeySecure 会向商户发送授权确认，需要在800毫秒之内完成授权确认，否则交易失败。 适用场景：- 需要实时授权确认的交易流程
- 对响应性能要求高
- 支持多种卡 BIN 组合
模式选择建议
| 维度 | 授信模式 | 授权模式 |
|---|---|---|
| 资金管理 | 商户管理 | 商户管理 |
| 交易确认 | 资金流水同步 | 实时授权（≤800毫秒） |
| 系统复杂度 | 中等（需要账户体系） | 高（需要实时响应） |
| 套餐管理 | 平台提供 | 商户自己维护 |
对接前准备
完成以下准备工作，确保顺利接入 API：| 事项 | 说明 | 负责方 |
|---|---|---|
| 选择对接模式 | 确认采用授信模式还是授权模式 | 商户 |
| 申请商户账号 | 联系商务获取测试账号和对应的 Api-Key 和 apiSecret | 商务团队 |
| IP 白名单配置 | 提供服务器出口 IP，在后台配置到 Api-Key 对应白名单 | 商户后台 |
| 回调地址配置 | 配置接收交易通知的 URL（用于卡变动、消费订单、授权通知等） | 商户后台 |
| 集成 SumSub KYC | 前端集成 KYC 认证组件，用户通过 Sumsub 完成 KYC 认证 | 商户前端 |
| 密钥管理 | 安全保管 apiSecret，用于加解密敏感信息（CVV/PIN）和验签 | 商户后端 |
| 测试对接 | 在沙盒环境完成全流程测试（用户认证→开卡→消费等） | 商户 |
完成API基础配置
环境说明
| 环境 | 域名 | 说明 |
|---|---|---|
| 沙盒 | https://sandbox-openplatform.keysecure.io | 测试环境，用于开发和联调 |
| 生产 | https://openplatform.keysecure.io | 正式环境，需商户上线前配置 |