对接说明

Download OpenAPI(postman) specification下载

阅读对象

贵公司的技术部门开发、维护及管理人员。他们应具备以下基本知识：
(1)了解网站设置和页制作方法；
(2)了解 HTML语言以及ASP、.NET 、PHP或JAVA 等开发语言；
(3)了解信息安全的基本概念`

名词解释

渠道商：指已注册成为用户，并使用产品实现其收、付费功能的企业。
通道：指支付第三方。
用户：指实际发起支付的终端用户。

接口设计

交互编码统一使用UTF-8。

请求方式：

数据交互时，统一采用POST方式进行交互与同步。返回数据均为JSON格式。

签名方法

我们采用了MD5的签名方法

参与签名的参数

*请参照各个接口文档， 除特别备注为不需要参与签名的参数，其余不为空的参数均参与签名。1. *

签名规则

1.签名数据由除sign之外的所有请求参数和合作密钥按以下规则拼接而成
a) 所有参与签名的请求参数都按照名称字符升序排列(ascii 参数名称不允许相同)
b) 某些请求参数的值是允许包含中文的,为了避免中文的编码问题,我们规定所有带中文的参数的值必须按照UTF-8格式进行编码。
c) 如果参数值为空，那么则该参数不参与签名
d) 将合作密钥作为最后一个参数,参数名为: key,参数值就是合作密钥本身(商户进件时获得)
e) 将请求参数按上述顺序用 & 拼接起来
2.用MD5对签名数据进行加密并转大写,生成签名字符串(32位大写字符),作为附加的请求参数sign的值。

请求示例

那么生成的待签名字符串为：
merchantId=16782297&transTime=20180815101212&key=Sasdjas557855as
签名结果为:
sign=bfd51ef41a3d71de72c38a6581ffe882

返回示例

{
    "resCode": "0",
    "resMsg": "获取成功",
    "jData": {
        "status": "00"
    }
}

• 更多返回错误代码请看首页的错误代码描述