切换主题
接入指南
选择业务流程
先完成接入准备，再按业务场景选择下列流程。各步骤的必填参数、账户条件与状态含义，以对应接口说明为准。
| 业务场景 | 调用顺序与入口 |
|---|---|
| 开户与认证 | 提交开户 → 按需获取验证码并完成认证 → 查询开户状态；被驳回时按原因修正后重新提交 |
| 账户资料变更 | 发起变更 → 确认变更 → 查询变更结果 |
| 账户与入金查询 | 查询开户信息、查询入金记录，按需接收入金通知 |
| 分账与退款 | 发起分账 → 查询结果；需要退款时查看分账退款 |
| 提现与结算 | 发起提现 → 查询提现结果；需要重新结算时查看订单重新结算的适用条件 |
| 交易凭证 | 按获取交易凭证说明查询并留存凭证 |
组装接口请求
- 打开所需 API 页面，在“接口说明”中选择当前环境的完整请求地址。
- 根据“请求参数”填写业务字段，将其序列化为
bizDataJSON 字符串。 - 按接口要求加入应用标识、请求流水号等公共参数，并使用对应环境的签名密钥生成
sign。签名完成后，请求体中不要传入appSecret。 - 使用
POST和Content-Type: application/json发送请求。右侧代码栏提供当前接口的调用示例，可切换语言查看。
确认业务结果
先检查公共返回 code。code=000000 表示接口请求处理成功，业务是否完成仍需结合对应接口的业务状态判断。响应包含 sign 时，应先验签再解析 bizData。
开户、资料变更、分账和提现等业务可通过相应查询接口或异步通知确认最终结果。接收通知时先验签，再做幂等处理，并在处理成功后返回该通知文档要求的回执。
遇到网络超时或未知结果，先查询原业务；遇到明确报错，结合常见问题和错误码参考处理。
检查联调结果
- 请求地址、API Key、签名密钥均属于当前环境。
bizData的序列化与签名处理一致，必填字段、枚举值、金额单位和时间格式符合接口要求。- 能够区分请求受理成功、业务处理中和最终结果。
- 重复通知只处理一次；超时场景能够按原业务单号查询结果。
- 日志保留排查需要的请求流水号与业务流水号，敏感信息已脱敏。