开发前必读

欢迎使用本项目的对外接口与接入文档。本页面为主页（Home），简要说明文档的用途与结构，帮助开发者快速定位所需内容。

开发前准备

UAT环境: https://uat-pay.bkj.com

生产环境: 请联系工作人员获取

如果需要回调通知，请提前向我方提供商户侧回调地址

请提供贵公司IP地址，由我方工作人员添加到IP白名单

本文档集合用于对外说明并指导合作方如何安全、规范地接入本系统的 API，包含以下主要内容：

请求头（Request Headers）规范：移动端与 Web 端需携带的头部字段及含义。

接口签名（Signature）机制：HMAC-SHA256 签名流程、规范化请求体、必需头与示例代码。

错误码（Error Codes）列表：API 返回的所有错误码及含义、处理建议与重试策略。

按“接口签名”文档实现请求签名（非 GET 请求需签名），并在请求头中附带 X-Signature、X-Timestamp、X-Nonce、X-Api-Key。

使用“错误码”文档映射并处理后端返回的 code，按建议进行重试或展示友好提示。

第三方集成工程师（mobile / web / backend）

产品与 QA（用于校验接入规范）

客服与运维（定位问题时参考错误码和日志字段）

签名：使用 HMAC-SHA256，签名字符串为：Method + Path + CanonicalizedBody + Timestamp + Nonce。每个合作方拥有独立 API key。

请求体规范化：忽略 null 与数组字段，对键排序并把数字规范为字符串。

如在接入过程中遇到问题，请准备好：请求示例（含全部 headers）、时间戳、nonce、签名字符串与返回的错误码，并联系项目技术支持团队以便快速定位问题。