支付请求API
简要描述:
- 支付请求接口
请求URL(网关地址):
http://www.haochuang123.com/API/Bank/
(请在“商户后台-接口文档”获取网关地址)
请求方式:
- POST
请求参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
LinkID | 是 | string | 商户订单流水号,必须唯一 |
ForUserId | 是 | string | 商户编号,即商户会员ID |
Channelid | 否 | string | 通道编号,为空时进入收银台 |
Moneys | 是 | string | 支付金额,单位:元 |
AssistStr | 否 | string | 附加信息,将原样返回,不支持中文和特殊符号 |
ReturnUrl | 是 | string | 回调通知地址 |
NotifyUrl | 否 | string | 异步通知地址(不参与签名),如果为空则由ReturnUrl地址异步通知,此时bType=2判断是异步 |
format | 否 | string | 数据返回方式(不参与签名),当format="json"时,返回JSON格式数据,否则直接跳转。(有些通道可能不支持JSON返回,请使用直接跳转) |
Sign | 是 | string | 32位MD5签名 |
签名字符串:
LinkID=&ForUserId=&Channelid=&Moneys=&AssistStr=&ReturnUrl=&Key=商户密钥
说明:Key的K是大写的K,按照该顺序签名,参数名区分大小写,大小写与参数表对应。
注意:参数名区分大小写,大小写与参数表对应;通过MD5(32位)方式签名(编码必须是gb2312,加密后转换为小写)。
签名举例:
> 待签名字符串:LinkID=20190109092948709836&ForUserId=162553&Channelid=888&Moneys=10&AssistStr=daqianpay&ReturnUrl=http://192.168.10.57&key=vtstvnh7SmFDAywWHmQfEtMGbiQlBpco
> 签名结果: d8c8fa98761bc71588c566b8a01b49f6
当format="json"时,返回JSON格式数据(format为空时直接跳转不返回数据) 返回示例:
{
"errcode":0,
"msg":"ok",
"Channelid":"7772",
"LinkID":"2019121623482316671",
"OrderId":"2019121623482322510316671",
"transAmt":"88.00",
"qrcodeurl":"weixin://wxpay/bizpayurl?pr=2JABYPy",
"sign":"6edaccd9cc7424d0f9d935300a7be9ba"
}
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
errcode | int | 为0表示没有错误,为1表示有错误 |
msg | string | 返回错误提示 |
errcode为0时才会有以下数据 | ||
Channelid | string | 通道编号 |
LinkID | string | 商户订单流水号 |
OrderId | string | 平台生成的订单号 |
transAmt | string | 金额,单位:元 |
qrcodeurl | string | 二维码字符串或支付Url |
sign | string | MD5签名 |
签名字符串:
Channelid=&errcode=&LinkID=&OrderId=&qrcodeurl=&transAmt=&key=商户密钥
(msg不参与签名,errcode不为0时不返回签名)
注意:参数名区分大小写,大小写与参数表对应;通过MD5(32位)方式签名(编码必须是gb2312,加密后转换为小写)。
签名举例:
> 待签名字符串:Channelid=7772&errcode=0&LinkID=2019121623482316671&OrderId=2019121623482322510316671&qrcodeurl=weixin://wxpay/bizpayurl?pr=2JABYPy&transAmt=88.00&key=vtstvnh7SmFDAywWHmQfEtMGbiQlBpco
> 签名结果: 6edaccd9cc7424d0f9d935300a7be9ba