# 欢迎您成为壹收银支付平台的开发者
# 1. 壹收银是什么?
壹收银支付平台旨在提供一站式的移动支付解决方案。壹收银内部集成了支付宝,微信等众多支付通道。
# 2.对接准备
# 2.1 申请平台帐户
联系平台商务人员(联系Q:28897292),根据要求提供开户所需要的资料;并与工作人员沟通具体需要开通哪些支付渠道(微信、支付宝);
# 2.2 开通平台商户
商户人员会免费帮助您,开通平台商户,支付渠道审核需要1-5工作间时间,需耐心等待;
# 2.3 获取商户编号及密钥
支付渠道开通成功,平台工作人员会提供给您相应的资料,用于对接和开发使用;资料包括如下:
资料 | 说明 |
---|---|
商户编号(mch_no) | 每个商户分配的商户编号 |
客户端密钥(client_key) | 签名使用,用于App支付,放于app客户端内 |
服务器端密钥(secret_key) | 签名使用,功能权限比较大,放于服务器端 |
对接文档 | sdk demo和使用文档 |
# 3.参数签名说明
请求参数接口统一使用http|https协议,每次请求要求对参数进行签名,请求统一编码为UTF-8,签名算法如下:
# 以举例进行说明:
假设有参数值为 user=abc,password=123,nickname=tom;这些需要POST到接口进行请求。
- 先对参数名进行英文字母的顺序排列,参数与参数之间使用“&”符号连接,得一串字符串,以上的例子所得字符串为:
nickname=tom&password=123&user=abc
- 将该拼接后的字符串与mch_key值重新组合一个新字符串,假设应用的mch_key值为“ifenqi”,新的字符串为:
nickname=tom&password=123&user=abcifenqi
- 最后将该新的字符串再进行一次md5加密,即为最后的签名值:
65f8154791882a0d31025d45c209c527
该签名值用参数sign提交服务端其中mch_no和sign对所有访问接口都是必传的,除非接口有另外说明;
# 4.接口定义说明
# 每个接口需要传输的参数说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
mch_no | string | Y | 壹收银平台商户编号 |
request_time | string | Y | 接口请求时间,格式yyyy-mm-dd hh:MM:ss,用于判断接口超时 |
sign | string | Y | 参数签名,用于安全认证 |
.... | N | 根据具体接口实际定义的参数 |
接口统一使用JSON格式作为数据响应格式。接口访问Json响应格式定义及说明如下:
# 响应内容示例:
{
"is_success": true,
"message": “ok",
"data": {}
}
字段 | 类型 | 说明 |
---|---|---|
is_success | boolean | true/false,表示成功或失败 |
error_code | Integer | 错误码 |
error_message | String | 返回提示信息,错误返回错误信息 |
data | String | 返回的数据,可值:null,json对象,json数组 |
术语 →