dpay


接入指引

1. 接入流程

  • 开始对接，获取测试参数 ，并阅读接入指引
  • 测试联调，可通过微信群与技术同学沟通，可下载开发Demo快速开始
  • 正式上线，上线前先联系商务同学获取正式商户号，然后联系技术同学获取正式机构及域名

2. 获取参数

测试环境参数名称 参数 备注
接口域名 https://test.zazpay.cn/xypay 测试环境域名，仅限http，接口路径不变
机构号inst_no 900024 测试机构号
机构秘钥key 8a9bd64e6585c6d8016585c6c8980002 测试密钥
商户号 852205070003 测试商户号
门店号 862205070002 测试门店号（非必需）
正式环境参数名称 参数 备注
接口域名 https://dpay.zazpay.cn/xypay 正式环境域名，仅限https，接口路径不变
机构号inst_no 请联系运营同学获取
机构秘钥key 请联系运营同学获取
商户号 请联系运营同学获取
门店号 请联系运营同学获取

补充说明：

  1. 对接时请使用以上参数进行测试环境调试，上线时分配正式参数；
  2. 测试环境与正式环境搭载的数据库已物理隔离，数据不互通；
  3. 接口文档中的地址均为正式环境，将协议及域名替换为上述测试域名，接口路径保持不变，即可使用测试环境参数开发。

3. 开发规范

  1. 报文规范

    1. 请求方式：POST
    2. 请求头信息：Content-Type → application/json;charset=utf-8
    3. 编码格式：UTF-8

  2. 签名规则

    • 第一步 获得请求的参数，待签名的JSON参数，参数值为空字符串参与，参数值为null不参与

      {
"inst_no": "900024",
"mch_no": "851811130002",
"pay_type": "400",
"pay_trace_no": "18588dbd1c6e4572b915a2b33fcdc62e",
"pay_time": "20190101125959",
"auth_code": "134573607383541818",
"total_amount": 1
}

    • 第二步 拼接参数，将JSON参数名首字母，按ASCII码顺序拼接，首字母相同则比较第二位，以此类推，生成字符串A

      String A = "auth_code=134573607383541818&inst_no=900024&mch_no=851811130002&pay_time=20190101125959&pay_trace_no=18588dbd1c6e4572b915a2b33fcdc62e&pay_type=400&total_amount=1";

    • 第三步 拼接密钥，在字符串尾部拼接机构密钥，生成字符串B

      String B = A + "&key=8a9bd64e6585c6d8016585c6c8980002";

    • 第四步 生成签名，对字符串B进行md5算法加密，获得的32位小写字符串即为签名结果字符串

      String sign = md5(B);
    • 第五步 获得最后的请求参数，在请求参数中加入签名参数sign即可 
      {
"inst_no": "900024",
"mch_no": "851811130002",
"pay_type": "400",
"pay_trace_no": "18588dbd1c6e4572b915a2b33fcdc62e",
"pay_time": "20190101125959",
"auth_code": "134573607383541818",
"total_amount": 1,
"sign":"841387ec9bd3ea78a580bd4629cab010"
}

      备注1 文档中的接口，未特殊说明的，均在请求参数附加一个名为sign的参数； 备注2 对于交易回调通知这类服务端发起的请求进行验签，先取出sign参数，剩下的参数按上述规则生成签名，最后与之前取出的sign参数进行比对。

4. 开发Demo

平台和语言 说明 操作
JAVA 开放平台API对应的JAVA调用示例 [下载](https://sb-soft.oss-cn-hangzhou.aliyuncs.com/sbpay/SBAPIDemoJava.zip "下载")
.NET 开放平台API对应的.NET调用示例 [下载](https://sb-soft.oss-cn-hangzhou.aliyuncs.com/sbpay/SBAPIDemoC%23.zip "下载")
PHP 开放平台API对应的PHP调用示例 [下载](https://sb-soft.oss-cn-hangzhou.aliyuncs.com/sbpay/SBAPIDemoPhp.zip "下载")

页面列表

ITEM_HTML