扫码支付API接口说明文档.doc
- 文档编号:105529
- 上传时间:2022-10-03
- 格式:DOC
- 页数:18
- 大小:363.50KB
扫码支付API接口说明文档.doc
《扫码支付API接口说明文档.doc》由会员分享,可在线阅读,更多相关《扫码支付API接口说明文档.doc(18页珍藏版)》请在冰豆网上搜索。
.-
扫码支付API接口开发指南
商户接口规
版本(3.0.7)
修订时间:
2017-08-01
目录
第一章文档描述3
1、文档说明3
2、阅读对象3
3、名词定义3
第二章接口定义3
1、扫码支付3
2、公众号支付3
3、支付异步通知10
4、交易查询12
5、对账查询14
第三章签名说明12
1、签名算法12
2、密钥生产12
附录1错误码说明14
第一章文档描述
1、文档说明
本说明文档用于指导商户接入扫码支付API系统进行的对接,目前支持支付宝、微信扫码。
请相关技术人员详细阅读本文档。
2、阅读对象
商户开发人员。
扫码支付API接口相关技术人员。
3、名词定义
合作方:
指对接扫码支付平台的机构。
商户:
指委托收单的营业机构,如超市、便利店等。
用户:
指在商户系统进行消费的企业或者个人。
商户ID:
指支付系统为使用外部接入接口的商户统一分配的唯一标识。
商户密钥:
指商户在和支付系统进行数据签名认证的密钥,采用RSA加密算法。
第二章接口定义
1、扫码支付
1、接入URL:
118.178.126.35:
8088/payservice/pay/smzf
2、接入方式:
POST方式均可
3、请求协议参数:
参数名
参数
数据类型
必填
说明
订单ID
orderId
VARCHAR
Y
交易订单ID
支付通道
payType
VARCHAR
Y
支付通道:
WXZF-微信支付,ZFBZF-支付宝支付
商户编码
merchantCode
VARCHAR
Y
商户编码,接入时系统分配
交易金额
totalAmount
VARCHAR
Y
交易金额,单位:
元,最小2元
交易标题
subject
VARCHAR
Y
交易标题,显示在微信或支付宝支付页面
交易描述
desc
VARCHAR
Y
交易描述
商户操作员id
operatorId
VARCHAR
N
操作员编号,如员工编码
门店编号
storeId
VARCHAR
N
商户的门店编号
商户终端编号
terminalId
VARCHAR
Y
商户机器的终端编号
支付方式
limitPay
VARCHAR
N
微信/支付宝:
1-不能使用信用卡
支付宝:
2-不适用花呗
3-不使用信用卡/花呗
来源信息
source
VARCHAR
N
支付宝分配给下游的pid识别号,2088开头的一串16位数字,对应支付宝的sys_service_provider_id字段
商品标记
goodsTag
VARCHAR
N
微信渠道可选上送,代金券或立减优惠功能参数,对应微信的goods_tag字段
支付宝目前用不到该参数。
支付有效时间
expireTime
VARCHAR
N
指定订单的支付有效时间(分钟数),超过有效时间用户将无法支付。
若不指定该参数则系统默认设置24小时支付有效时间。
参数允许设置围:
1-1440区间的整数值,超过1440默认设置1440
支付宝:
用户扫码后开始计算支付有效时间
微信:
用户下单后开始计算支付有效时间
回调通知地址
notifyurl
VARCHAR
Y
支付成功失败的通知地址
交易终端ip
createip
VARCHAR
Y
交易终端IP
备注
extend1
VARCHAR
N
备注信息,测试系统必填
签名
sign
VARCHAR
Y
RSA签名
4、返回协议参数:
参数名
参数
数据类型
必填
说明
返回状态
rspCode
VARCHAR
Y
返回的错误码,000000代表成功,其它为失败
返回信息
rspMsg
VARCHAR
Y
返回信息
二维码
qrCode
VARCHAR
Y
订单的二维码,商户生成二维码提供给用户扫码支付
签名
sign
VARCHAR
Y
RSA签名
5、接入实例:
请求提交方法:
{
"payType":
"ZFBZF",
"orderId":
"WE1124567810",
"merchantCode":
"",
"totalAmount":
"2",
"subject":
"firsttest",
"desc":
"testproduct",
"body":
"testproduct",
"terminalId":
"1213412134",
"extend1":
"test",
"notifyurl":
"118.178.126.35:
8088/payservice/pay/notifytestsucc",
"createip":
"192.168.0.1"
}
返回值:
{
"rspCode":
"000000",
"rspMsg":
"OK",
"qrCode":
"https:
//qr.alipay./bax02559bawzwz2erezj00d4",
"sign":
"Ek7H4c6f5OgechohLFrxcgPoGC/vVy0Bg5XDzYGVIReHYaFtEBfSUxhSxCf/rDMhM+DZKJaw5jhTU1mE1ijEQoguj6c6gKDSg6fXuEEwbKODlQDW9cHRFxMVki2THexox/g8KgipUiEW5HOdNNm4LcwQe8YC+8gauHcKEXSW7Rw="
}
2、公众号支付
1、接入URL:
118.178.126.35:
8088/payservice/pay/pn
2、接入方式:
POST方式均可
3、请求协议参数:
参数名
参数
数据类型
必填
说明
订单ID
orderId
VARCHAR
Y
交易订单ID
支付通道
payType
VARCHAR
Y
支付通道:
WXZF-微信支付
商户编码
merchantCode
VARCHAR
Y
商户编码,接入时系统分配
交易金额
totalAmount
VARCHAR
Y
交易金额,单位:
元,最小2元
交易标题
subject
VARCHAR
Y
交易标题,显示在微信或支付宝支付页面
交易描述
desc
VARCHAR
Y
交易描述
商户操作员id
operatorId
VARCHAR
N
操作员编号,如员工编码
门店编号
storeId
VARCHAR
N
商户的门店编号
商户终端编号
terminalId
VARCHAR
Y
商户机器的终端编号
支付方式
limitPay
VARCHAR
N
微信/支付宝:
1-不能使用信用卡
支付宝:
2-不适用花呗
3-不使用信用卡/花呗
商品标记
goodsTag
VARCHAR
N
微信渠道可选上送,代金券或立减优惠功能参数,对应微信的goods_tag字段
支付宝目前用不到该参数。
支付有效时间
expireTime
VARCHAR
N
指定订单的支付有效时间(分钟数),超过有效时间用户将无法支付。
若不指定该参数则系统默认设置24小时支付有效时间。
参数允许设置围:
1-1440区间的整数值,超过1440默认设置1440
支付宝:
用户扫码后开始计算支付有效时间
微信:
用户下单后开始计算支付有效时间
回调通知地址
notifyurl
VARCHAR
Y
支付成功失败的通知地址
交易终端ip
createip
VARCHAR
Y
交易终端IP
跳转路径
callbackUrl
VARCHAR
N
支付成功跳转路径;form表单形式提交商户后台;
子商户公众号标识
subAppId
VARCHAR
Y
子商户公众号标识
子商户公众号下关注的用户openid
subOpenId
VARCHAR
Y
子商户公众号下关注的用户openid
微信子商户号
wxSubMchId
VARCHAR
N
微信支付分配的子商户号
是否开具电子发票
receipt
VARCHAR
N
是否开具电子发票
是否原生公众号
isRaw
VARCHAR
Y
1:
原生公众号(返回json串给jsapi拉起支付)
备注
extend1
VARCHAR
N
备注信息,测试系统必填
签名
sign
VARCHAR
Y
RSA签名
4、返回协议参数:
参数名
参数
数据类型
必填
说明
返回状态
rspCode
VARCHAR
Y
返回的错误码,000000代表成功,其它为失败
返回信息
rspMsg
VARCHAR
Y
返回信息
支付码信息
payCode
VARCHAR
Y
"payCode":
"{\"sign\":
\"D9F4C32B8F20D348DDFA85C95B291E55\",\"timestamp\":
\"1476774382\",\"noncestr\":
\"368c7e90e499484e901edbbd501a8dd9\",\"partnerid\":
\"15233133\",\"prepayid\":
\"wx33454fd6f1dc\",\"package\":
\"Sign=WXPay\",\"appid\":
\"wxb5d8ad7674532882\"}")
签名
sign
VARCHAR
Y
RSA签名
5、接入实例:
请求提交方法:
{
"payType":
"ZFBZF",
"orderId":
"WE1124567810",
"merchantCode":
"",
"totalAmount":
"2",
"subject":
"firsttest",
"body":
"testproduct",
"terminalId":
"1213412134",
"extend1":
"test",
"notifyurl":
"118.178.126.35:
8088/payservice/pay/notifytestsucc",
"createip":
"192.168.0.1"
"callbackUrl":
"118.178.126.35:
8088/payservice/pay/callbackurl"
"subAppId":
"wxa3dbb6050f553164"
"subOpenId":
"9efi3dbb6050f653164"
}
返回值:
{
"rspCode":
"000000",
"rspMsg":
"OK",
"payCode":
{"timeStamp":
"74",
"signType":
"MD5",
"package":
"prepay_id=wx2657a0",
"paySign":
"6B0EEA6AE668593A6A290F8247CE46B7",
"nonceStr":
"05571626a6f6415f8cb11
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 支付 API 接口 说明 文档