原创力文档- 1、原创力文档（book118）网站文档一经付费（服务费），不意味着购买了该文档的版权，仅供个人/单位学习、研究之用，不得用于商业用途，未经授权，严禁复制、发行、汇编、翻译或者网络传播等，侵权必究。。
- 2、本站所有内容均由合作方或网友上传，本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺！文档内容仅供研究参考，付费前请自行鉴别。如您付费，意味着您自己接受本站规则且自行承担风险，本站不退款、不进行额外附加服务；查看《如何避免下载的几个坑》。如果您已付费下载过本站文档，您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等，请点击“版权申诉”（推荐），也可以打举报电话：400-050-0827(电话支持时间：9:00-18:30)。
- 4、该文档为VIP文档，如果想要下载，成为VIP会员后，下载免费。
- 5、成为VIP后，下载本文档将扣除1次下载权益。下载后，不支持退款、换文档。如有疑问请联系我们。
- 6、成为VIP后，您将拥有八大权益，权益包括：VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 7、VIP文档为合作方或网友上传，每下载1次， 网站将根据用户上传文档的质量评分、类型等，对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
.-
.
-
.可修编
.
可修编.
扫码支付API接口开发指南
商户接口规
版本(3.0.7)
修订时间：2017-08-01
目录
第一章文档描述31、文档说明3
2、阅读对象3
3、名词定义3第二章接口定义41、扫码支付4
2、公众号支付4
3、支付异步通知10
4、交易查询12
5、对账查询14第三章签名说明161、签名算法16
2、密钥生产16附录1错误码说明17
第一章文档描述
1、 文档说明
本说明文档用于指导商户接入扫码支付API系统进行的对接，目前支持支付宝、微信扫码。请相关技术人员详细阅读本文档。
2、 阅读对象
商户开发人员。
扫码支付API接口相关技术人员。
3、 名词定义
合作方：指对接扫码支付平台的机构。
商户：指委托收单的营业机构，如超市、便利店等。用户：指在商户系统进行消费的企业或者个人。
商户ID：指支付系统为使用外部接入接口的商户统一分配的唯一标识。
商户密钥：指商户在和支付系统进行数据签名认证的密钥，采用RSA加密算法。
第二章接口定义
1、扫码支付
1、接入URL：5:8088/payservice/pay/smzf
2、接入方式：POST方式均可
说明交易订单ID
说明
交易订单ID
支付通道：WXZF-微信支付，ZFBZF-支付宝支付
商户编码，接入时系统分配交易金额，单位：元，最小2元
交易标题，显示在微信或支付宝支付页面
交易描述
操作员编号，如员工编码
商户的门店编号
商户机器的终端编号
微信/支付宝：
1-不能使用信用卡
支付方式
limitPay
VARCHAR
N
支付宝：
2-不适用花呗
3-不使用信用卡/花呗
参数名
参数
数据类型
必填
订单ID
orderId
VARCHAR
Y
支付通道
payType
VARCHAR
Y
商户编码
merchantCode
VARCHAR
Y
交易金额
totalAmount
VARCHAR
Y
交易标题
subject
VARCHAR
Y
交易描述
desc
VARCHAR
Y
商户操作员id
operatorId
VARCHAR
N
门店编号
storeId
VARCHAR
N
商户终端编号
terminalId
VARCHAR
Y
支付宝分配给下游的pid识别
来源信息
source
VARCHAR
N
号，2088开头的一串16位数字,
对应支付宝的
sys_service_provider_id字段
微信渠道可选上送，代金券或
商品标记
goodsTag
VARCHAR
N
立减优惠功能参数，对应微信
的goods_tag字段
支付宝目前用不到该参数。
指定订单的支付有效时间（分
钟数），超过有效时间用户将
无法支付。若不指定该参数则
系统默认设置24小时支付有效
时间。参数允许设置围：1-1440
支付有效时间
expireTime
VARCHAR
N
区间的整数值，超过1440默认
设置1440
支付宝：用户扫码后开始计算
支付有效时间
微信：用户下单后开始计算支
付有效时间
回调通知地址
notifyurl
VARCHAR
Y
支付成功失败的通知地址
交易终端ip
createip
VARCHAR
Y
交易终端IP
备注
extend1
VARCHAR
N
备注信息，测试系统必填
签名
sign
VARCHAR
Y
RSA签名
4、返回协议参数：
参数名
参数
数据类型
必填 说明
返回状态
rspCode
VARCHAR
返回的错误码，000000代表成
Y
功，其它为失败
返回信息
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:5:8088/payservice/pay/notifytestsucc,createip:
}
返回值：
{
rspCode:000000,
rspMsg:OK,
qrCode:https://qr.alipay./bax02559bawzwz2erezj00d4,sign:
文档评论（0）