【微信支付】微信被扫支付接口文档V2.5.6
合集下载
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
接口调用时序图 1.2 1.2接口调用时序图
微信被扫支付接口文档 V2.5 3
1.3 免密额度
用户使用每单免密额度（用户不可调整） ； � � � � � � 每单小于300元的消费都免密； 每天10次免密刷卡限制； 大于300元的消费需要验证密码； 当天满10次免密，后续交易均验证密码，第二天自动恢复免密次数； 用户行为异常需要验证密码； 用户可以停用此功能；
2. API 说明
2.1 提交被扫支付 API
URL: https:///pay/micropay
具体的post数据格式如： <xml> <appid>wx2421b1c4370ec43b</appid> <attach><![CDATA[att]]></attach> <auth_code>100000000749880164</auth_code> <body><![CDATA[交易说明]]></body> <device_info>1000</device_info> <goods_tag></goods_tag> <mch_id>10000100</mch_id> <nonce_str>58ef9df15219a07d73b176b3e664d735</nonce_str> <out_trade_no>1404470527</out_trade_no> <spbill_create_ip>127.0.0.1</spbill_create_ip> <time_expire></time_expire> <time_start></time_start> <total_fee>1</total_fee> <sign><![CDATA[F06C8D0D931B360AB6DEFB886F8E9FC5]]></sign> </xml> 提交参数说明：
Sign 签名生成方法 由于数据中携带了生成订单的详细信息， 因此在微信将对数据里面的内容进行鉴权， 确定携带的信息是真实、有效、合理的。因此，这里将定义生成 sign 字符串的方法。 a.对所有传入参数按照字段名的 ASCII 码从小到大排序（字典序）后，使用 URL 键 ：值为空的 值对的格式（即 key1=value1&key2=value2…）拼接成字符串 string1，注意 注意： 参数不参与签名； b. 在 string1 最 后 拼 接 上 key=paternerKey 得 到 stringSignTemp 字 符 串 ， 并对 stringSignTemp 进行 md5 运算，再将得到的字符串所有字符转换为大写，得到 sign 值 signValue。 下面定义了一段生成 sign 字符串的示范过程： 假设以下为 package 传入参数： appid=wxd930ea5d5a258f4f auth_code=123456 body=test device_info=123 mch_id=1900000109 nonce_str=960f228109051b9969f76c82bde183ac out_trade_no=1400755861 spbill_create_ip=127.0.0.1 sub_mch_id=124 total_fee=1 key=8934e7d15453e97507ef794cf7b0519d i：经过 a 过程 URL 键值对字典序排序后的字符串 string1 为： appid=wxd930ea5d5a258f4f&auth_code=123456&body=test&device_info=123&m ch_id=1900000109&nonce_str=960f228109051b9969f76c82bde183ac&out_trade_no= 1400755861&spbill_create_ip=127.0.0.1&sub_mch_id=124&total_fee=1 ii：经过 b 过程后得到 sign 为： sign =md5(string1&key=8934e7d15453e97507ef794cf7b0519d).toUpperCase =md5(appid=wxd930ea5d5a258f4f&auth_code=123456&body=test&device_info=1
微信被扫支付接口文档 V2.5 5
23&mch_id=1900000109&nonce_str=960f228109051b9969f76c82bde183ac&out_trad e_no=1400755861&spbill_create_ip=127.0.0.1&sub_mch_id=124&total_fee=1&key=893 4e7d15453e97507ef794cf7b0519d).toUpperCase() ="c380bec2bfd727a4b6845133519f3ad6".toUpperCase() ="C380BEC2BFD727A4B6845133519F3AD6"
1.4 接口调用方式
API调用方式与说明： � � � � � 采用HTTPS方式访问 提交方法为POST 提交和返回的数据格式为XML 编码为UTF-8 提交和返回数据都需要验证签名。
注意：撤销和退款接口需要双向证书（商户证书） ，支付和查询不需要。
微信被扫被扫支付接口文档 (版本 2.5.6)
微信被扫支付接口文档 V2.5
1
目录
微信被扫支付接口文档............................................................................................................ 1 1. 被扫支付介绍...................................................................................................................... 3 1.1 交互细节..................................................................................................................... 3 1.3 免密额度..................................................................................................................... 4 1.4 接口调用方式............................................................................................................. 4 1.5 签名方式..................................................................................................................... 5 2. API 说明.................................................................................................................................6 2.1 提交被扫支付 API......................................................................................................6 2.2 被扫订单查询 API......................................................................................................9 2.3 退款申请接口........................................................................................................... 12 2.4 退款查询接口........................................................................................................... 13 2.5 撤销接口................................................................................................................... 15 2.6 对账单接口............................................................................................................... 16 2.7 授权码查询 OPENID 接口..................................................................................... 18 3.企业红包使用说明.............................................................................................................. 19 3.1 创建批次企业红包................................................................................................... 19 3.2 提交支付使用企业红包........................................................................................... 19 3.3 查询使用企业红包金额........................................................................................... 19 3.4 企业红包对账单....................................................................................................... 20 4.错误码列表.......................................................................................................................... 20
->
->
(6)步骤4提交请求后会同步返回支付结果。如果需要密码验证，支付结果返回 USERPAYING (用户支付中)的状态。当支付结果为系统错误，需要商户收银系统调用 订单查询API(详见2.2节)查询支付实际交易结果； 当返回USERPAYING时等待用户输入 密码，系统可设置间隔时间(建议10秒)重新查询支付结果，直到支付成功或超时(建议 30秒)； (4)在交易状况不明晰的情况下调用撤销接口(详见2.5节)，如果交易失败则关闭订单， 该单不能再支付成功；如果交易成功，则将扣款退回到用户账户。当撤销无返回或错误 时，请再次调用。
微信被扫支付接口文档 V2.5
2
1. 被扫支付介绍
1.1 交互细节
根据微信被扫支付场景，设计商家支付逻辑。 (1)商户收银系统生成订单，进入微信支付流程； (2)用户打开微信刷卡界面，收银系统扫描到用户二维码或条码(见下左图)； (3)组装支付交易需要的数据，并生成签名(签名方式见1.5节); (4)调用微信被扫API(详见2.1节)，提交支付请求； (5)用户使用微信被扫支付未超过免密限额(详见1.3节)，微信直接扣款成功，否则用户 端微信会弹出输入密码提示(见下中图)， 支付成功后用户微信侧会弹出交易结果(见下右 图)；