1. 开发指南
GlobalPay
  • 开发指南
    • 开发前必读
    • 申请API Key 与 API Secret
    • 签名认证
    • 错误码参考
    • 订单状态
    • 常见问题
    • 支付回调通知
  • Api使用指南
    • 查询⽀持的资产
      GET
    • 创建订单
      POST
    • 查询订单
      GET
    • 取消订单
      POST
  1. 开发指南

开发前必读

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

开发前准备#

UAT环境: https://uat-pay.bkj.com
生产环境: 请联系工作人员获取
如果需要回调通知,请提前向我方提供商户侧回调地址
请提供贵公司IP地址,由我方工作人员添加到IP白名单

文档用途#

本文档集合用于对外说明并指导合作方如何安全、规范地接入本系统的 API,包含以下主要内容:
请求头(Request Headers)规范:移动端与 Web 端需携带的头部字段及含义。
接口签名(Signature)机制:HMAC-SHA256 签名流程、规范化请求体、必需头与示例代码。
错误码(Error Codes)列表:API 返回的所有错误码及含义、处理建议与重试策略。

快速上手(3 步)#

1.
按“接口签名”文档实现请求签名(非 GET 请求需签名),并在请求头中附带 X-Signature、X-Timestamp、X-Nonce、X-Api-Key。
2.
使用“错误码”文档映射并处理后端返回的 code,按建议进行重试或展示友好提示。

目标读者#

第三方集成工程师(mobile / web / backend)
产品与 QA(用于校验接入规范)
客服与运维(定位问题时参考错误码和日志字段)

重要规范速览#

签名:使用 HMAC-SHA256,签名字符串为:Method + Path + CanonicalizedBody + Timestamp + Nonce。每个合作方拥有独立 API key。
请求体规范化:忽略 null 与数组字段,对键排序并把数字规范为字符串。

联系与支持#

如在接入过程中遇到问题,请准备好:请求示例(含全部 headers)、时间戳、nonce、签名字符串与返回的错误码,并联系项目技术支持团队以便快速定位问题。
修改于 2026-05-13 03:34:35
下一页
申请API Key 与 API Secret
Built with