API开发文档简介
本文阅读对象：使用 良族支付-聚合支付多种通道-支付接口-专业的支付服务商 商户自服务系统的技术架构师、研发工程师、系统运维工程师。通过本文档，商户可了解 良族支付-聚合支付多种通道-支付接口-专业的支付服务商 接入的技术、接入的产品业务、接入的流程、接入规范等信息，以便于商户顺利完成接入工作。
接入网关
请登录商户中心，API管理 开发文档中 查看网关地址和API对接参数。
统一下单接口
提交方式：POST,GET
地址：https://pay.liangzu.cn/api/payment/submit
| 参数名称 |
参数含义 |
是否必填 |
参与签名 |
参数说明 |
| pay_memberid |
商户号 |
是 |
是 |
平台分配商户号 |
| pay_orderid |
订单号 |
是 |
是 |
上送订单号唯一, 字符长度20 |
| pay_applydate |
提交时间 |
是 |
是 |
时间格式：2016-12-26 18:18:18 |
| pay_bankcode |
银行编码 |
是 |
是 |
在商户中心查询 |
| pay_notifyurl |
服务端通知 |
是 |
是 |
服务端返回地址.（POST返回数据） |
| pay_callbackurl |
页面跳转通知 |
是 |
是 |
页面跳转返回地址 |
| pay_amount |
订单金额 |
是 |
是 |
单位：元 |
| pay_md5sign |
MD5签名 |
是 |
是 |
请查看签名算法 |
| pay_productname |
商品名称 |
是 |
否 |
|
| openid |
微信小程序openid |
否 |
否 |
当使用微信小程序支付时必填 |
| paytype |
请求模式 |
是 |
否 |
html用于直接请求收银台支付 json用于CURL异步请求返回JSON用于自己网站进行包装 |
| 字段名 |
变量名 |
示例值 |
描述 |
| 返回状态码 |
code |
200 |
200成功400失败 |
| msg |
string |
是 |
处理结果描述 |
| data |
object |
是 |
拓展数据orderid：订单号amount：订单金额QRcode：二维码pay_url：支付链接time：订单时间 |
异步通知
提交方式：POST
接收到服务器点对点通讯时，在页面输出“successful”（ 没有双引号successful) ，否则会重复5次发送点对点通知.
| 参数名称 |
参数含义 |
是否必填 |
参与签名 |
参数说明 |
| memberid |
商户编号 |
是 |
是 |
平台分配商户号 |
| orderid |
订单号 |
是 |
是 |
上送订单号唯一, 字符长度20 |
| amount |
订单金额 |
是 |
是 |
|
| transaction_id |
交易流水号 |
是 |
是 |
|
| datetime |
交易时间 |
是 |
是 |
|
| returncode |
交易状态 |
是 |
是 |
00表示成功，其它表示失败 |
| sign |
MD5签名 |
是 |
否 |
|
支付结果通知
提交方式：
| 参数名称 |
参数含义 |
是否必填 |
参与签名 |
参数说明 |
| memberid |
商户编号 |
是 |
是 |
平台分配商户号 |
| orderid |
订单号 |
是 |
是 |
上送订单号唯一, 字符长度20 |
| amount |
订单金额 |
是 |
是 |
|
| transaction_id |
交易流水号 |
是 |
是 |
|
| datetime |
交易时间 |
是 |
是 |
|
| returncode |
交易状态 |
是 |
是 |
00表示成功，其它表示失败 |
| sign |
MD5签名 |
是 |
否 |
|
签名算法
签名生成的通用步骤如下：
第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串。
第二步，在stringA最后拼接上应用key得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。
stringSignTemp="pay_amount=pay_amount&pay_applydate=pay_applydate&pay_bankcode=pay_bankcode&pay_callbackurl=pay_callbackurl&pay_memberid=pay_memberid&pay_notifyurl=pay_notifyurl&pay_orderid=pay_orderid&key=key"
sign=MD5(stringSignTemp).toUpperCase()
渠道编码
请登录商户中心，API管理 通道费率中 查看所属应用的支付通道编码。