# 欢迎您成为壹收银支付平台的开发者

# 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到接口进行请求。

  1. 先对参数名进行英文字母的顺序排列,参数与参数之间使用“&”符号连接,得一串字符串,以上的例子所得字符串为:
nickname=tom&password=123&user=abc 
  1. 将该拼接后的字符串与mch_key值重新组合一个新字符串,假设应用的mch_key值为“ifenqi”,新的字符串为:
nickname=tom&password=123&user=abcifenqi 

  1. 最后将该新的字符串再进行一次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数组