文档说明

一、登录商户后台

  • 联系运营获取 商户后台链接登录账号密码(仅供测试使用)。

  • 登录后,点击右上角 「API接口设置」

二、设置AccessKey

  • 点击 重新生成 AccessKey

  • 填写谷歌验证码

  • 点击 提交 后生效。

⚠️ 注意事项:

  • 如果有填写回调地址,提交时,系统会POST回调地址,发送内容为文本“Test”,回调响应HTTP状态必须为200,否则提交失败!

三、接口调用说明

V1

  • 请求时,在 Header 中设置:

    Content-Type: application/json
    Authorization: {AccessKey}
  • 示例:

    Content-Type: application/json
    Authorization: ecb797f9e9feab0a92ab283978d33711

V2

  • 请求时,在 Header 中设置:

    Content-Type: application/json
    Authorization: {商户ID}
  • 示例:

    Content-Type: application/json
    Authorization: 1514639549140992

四、回调说明

  • 只有成功的订单才会触发回调。

  • 回调地址可以在拉单的时候单独设置,如果拉单的时候没有设置,会使用后台设置的回调地址进行回调。

  • 回调IP来自:65.20.91.228

  • 回调失败会自动重试3次。

  • 回调请求方式:POST

  • 回调内容:AES 加密的 JSON 字符串

示例:渠道代收回调

{
    "sourceNo": "商户订单号"
    "data": "加密后的代收订单详情(具体参数参考get返回值)字符串"
}

示例:解密后的代收订单详情(具体参数参考get返回值)

{
    "channelCreditOrderSimpleInfo": {
      "id": 1,
      "merchantId": 1,
      "merchantSourceNo": "text",
      "fiatAmount": 1,
      "tokenAmount": 1,
      "processCode": 0,
      "createdTime": 1,
      "updatedTime": 1,
      "cashierLink": "text",
      "payerAccountDetailList": [
        {
          "accountName": "text",
          "bankNo": "text",
          "bankAccount": "text"
        }
      ],
      "payeeAccountDetail": {
        "accountName": "text",
        "bankNo": "text",
        "bankAccount": "text"
      },
      "paid": true,
      "callbackCode": 0,
      "closedTime": 1
    }
  }

五、AES 加密说明

  • 运算模式:ECB

  • 填充模式:PKCS7

  • 秘钥长度:256 bits

  • 秘钥:同 AccessKey

  • 字符编码:UTF-8

  • 输出格式:Base64

🔑 示例

  • 原始值:Test

  • 秘钥:ecb797f9e9feab0a92ab283978d33711

  • 加密结果:M2SwiX1fxQ5aJ34scDi0zA==

👉 在线测试工具:AES 加密工具

六、接口文档与环境说明

  • 测试环境 Endpoint: https://api-beta.bharatpay.cc

  • 生产环境 Endpoint: https://api.bharatpay.cc

⚠️ 在正式上线前,请务必联系运营人员获取 生产环境商户后台链接,并完成以下事项:

  1. 重新申请并配置 AccessKey

  2. 设置并验证 回调地址(代收、代付);

  3. 确认回调接口能正常响应200(OK)状态。

以上配置完成并通过测试后,方可切换至生产环境进行业务操作。

最后更新于