切换主题
接入准备
准备应用配置
接入前请取得对应环境的 API Key 与签名密钥，并根据实际业务确定需要调用的开户、账户查询、分账或提现接口。
| 配置项 | 准备说明 |
|---|---|
| API Key | 用于标识调用应用，需与当前环境一致 |
| 签名密钥 | 用于请求签名与结果验签，由服务端安全保存 |
| 结果通知地址 | 用于接收所需业务的异步通知，按对应通知文档完成处理 |
正式环境与沙箱环境的应用配置、签名密钥和业务数据相互隔离，请勿混用。
选择调用环境
| 环境 | API 基础地址 | 用途 |
|---|---|---|
| 沙箱环境 | https://pay-test.rscygroup.com/api/open | 联调、参数校验和业务流程验证 |
| 正式环境 | https://pay.rscygroup.com/api/open | 已完成签约和生产配置后的正式业务调用 |
各接口的完整请求地址见对应 API 页面的“接口说明”。切换环境时同步核对 API Key、签名密钥和业务数据。
准备结果处理
- 为每次请求生成唯一的
reqId，并保留对应业务单号，便于查询与排查。 - 按业务需要接收开户、入金、分账或提现通知；通知可能重复发送，处理逻辑需要支持幂等。
- 响应或通知包含
sign时，先验签，再解析并处理bizData。 - 网络超时或返回结果未知时，先查询原业务状态，避免重复发起资金请求。
开始接入
准备完成后，按照接入指南组装请求并验证业务流程。开户资料和主体信息的具体要求，请查看登记簿开户的请求参数说明。
签名密钥不要出现在请求体、前端代码或日志中；日志中的账户、银行卡、手机号和身份信息应脱敏。