77范文网 - 专业文章范例文档资料分享平台

微信公众号支付接口文档(结算中心-受理机构)v0.0 - 图文(7)

来源:网络收集 时间:2019-04-14 下载这篇文档 手机版
说明:文章内容仅供预览,部分内容可能不全,需要完整文档或者需要复制内容,请下载word后使用。下载word有问题请添加微信号:或QQ: 处理(尽可能给您提供完整文档),感谢您的支持与谅解。点击这里给我发消息

微信公众号支付接口文档 (结算中心-受理机构)V0.0 商户订单号 out_trade_no 否 String(32) 商户系统 内部的订单号 ,商 户可以在上报时提供相关商 户订单号方便微信支付更好 的提高服务质量。 发起接口调用时的机器 IP 商户调用该接口时商户自己 系 统 的 时 间 , 格 式 为 访问接口 IP 商户上报时间 user_ip time 是 否 String(16) String(14) 微信被扫支付接口文档(结算中心-受理机构)V0.0

31

微信公众号支付接口文档 (结算中心-受理机构)V0.0

yyyyMMddHHmmss,如 2009 年 12 月 27 日 9 点 10 分 10 秒表 示为 20091227091010。时区 为 GMT+8 beijing。该时间取 自商户服务器

返回参数:

字段名 返回状态码 变量名 return_code 必填 是 类型 String(16) 说明 SUCCESS/FAIL 此字段是通信标识,非交易 标识,交易是否成功需要查 看 result_code 来判断 返回信息 return_msg 否 String(128) 返回信息,如非空,为错误 原因 签名失败 参数格式校验错误 以下字段在 return_code 为 SUCCESS 的时候有返回 业务结果 result_code 是 String(16) 错误代码 错误代码描述

SUCCESS/FAIL err_code err_code_des 否 否 String(32) String(128) 结果信息描述

5.企业红包使用说明

5.1 创建批次企业红包

商户需要使用该功能,请先登录商户系统(地址:https://mch.weixin.qq.com)建新批次。 注意:【商品标识】字段对应被扫支付接口中的参数 goods_tag,该值配置为空时,提交支付 接口不需要传 goods_tag 字段;多个批次使用相同的商品标识,则扣款时会使用有效的批次 企业红包(使用企业红包金额小于订单金额)。

5.2 提交支付使用企业红包

被扫支付 API 中提交 goods_tag 参数值为 5.1 节中配置的【商品标识】,微信后台会判断, 如果存在有效代金券即交易符合代金券扣减规则,用户实际支付金额=总扣款-有效企业红包 金额。

微信被扫支付接口文档(结算中心-受理机构)V0.0

32

5.3 查询使用企业红包金额

微信公众号支付接口文档 (结算中心-受理机构)V0.0

被扫支付扣款成功或查询接口会返回用户使用企业红包金额。接口返回字段 coupon_fee 为使用企业红包金额,total_fee 为订单总金额,用户实际支付金额=total_fee-coupon_fee,商户如需提供发票给用户,发票额与用户实际支付金额相等。

5.4 企业红包对账单

对账单中有企业红包金额字段和订单总金额,用于对账。后续会提供查询某个用户订单 使用对应的批次的对账单。

6. 返回状态码列表

返回状态码 (return_code)

返回状态码 SUCCESS FAIL TIMEOUT FAIL_NOT_ENOUGH FAIL_NOT_EXIST FAIL_STATUS FAIL_SIGN FAIL_SZFS 返回状态码描述 签名失败、参数格式校验错误 超时 头寸不足 原订单不存在 受理机构状态异常 结算中心验签失败 失败 支付 Y Y Y Y Y 查单 Y Y Y Y Y 关单 Y Y Y Y Y Y 退款 Y Y Y Y Y Y Y Y 退款 查询 Y Y Y Y Y

超时:结算中心转发给微信支付后,超时未收到响应。

头寸不足:受理机构的正交易不足以支持退款或撤销。 原订单不支持撤销:微信主扫支付不支持撤销。

结算中心验签失败:受理机构向结算中心发起撤销或退款时,“结算中心签名”验证失败。 失败:结算中心处理请求失败。

7.错误码列表

错误代码(err_code)

错误码 SYSTEMERROR INVALID_TRANSACTIONID PARAM_ERROR ORDERPAID OUT_TRADE_NO_USED NOAUTH 错误描述 接口后台错误 无效 transaction_id 提交参数错误 订单已支付 商户订单号重复 商户无权限 支付 Y Y Y Y Y Y 查单 Y Y Y 关单 Y Y Y Y 退款 Y Y Y 退款 查询 Y Y Y 33

微信被扫支付接口文档(结算中心-受理机构)V0.0

NOTENOUGH NOTSUPORTCARD ORDERCLOSED BANKERROR REFUND_FEE_INVALID ORDERNOTEXIST

余额不足 不支持卡类型 订单已关闭 银行系统异常 微信公众号支付接口文档 (结算中心-受理机构)V0.0 Y Y Y Y 退款金额大于支付金额 订单不存在 Y Y Y Y Y

8.常见问题和注意事项

8.1.常见基本概念疑惑

(1) 还没拿到正式号,如何调试测试?

答:只有在“商户功能”审核通过以后,收到了微信和财付通的相关邮件,才可以进行开发。

(2) 支付授权目录如何使用? 答:支付授权目录是支付功能正式上线后,商户后台发起支付请求的页面所在的目录。这个目录在注册填写时,需要精确到最细一级的目录,且在使用时,目录名称后直接加文件名,不可再增加 or 删减目录。

举例:发起请求的页面 url 为 http://pay.weixin.com/weixin/pay/payment.php?XXXXX,则 填写的目录应该为 http://pay.weixin.com/weixin/pay/。 (3) 支付测试目录和支付授权目录?

答:支付授权目录将会在产品上线审核时,以及上线后长期使用的正式目录。支付测试目录是提供给开发者,在开发测试期间使用的临时目录。这两个目录都是发起支付请求的页面文件所在的位置。

8.2.常见错误现象及解决方法

(1) 点击支付按钮,调用 JS API 没反应?

答:尝试发起支付的页面 url,不在支付授权目录下,请检查 url 与支付授权目录是否对

微信被扫支付接口文档(结算中心-受理机构)V0.0

34

微信公众号支付接口文档 (结算中心-受理机构)V0.0

应。

(2) 点击支付按钮,提示“access_not_allow” 答:参与测试人员的微信号没有在白名单中,将测试用户加入白名单。操作在 “mp.weixin.qq.com——微信支付——支付测试”。 (3) 点击支付按钮,提示“access_denied”

答:尝试发起支付的页面 url,不在支付授权目录下,请检查 url 与支付授权目录是否对应。

(4) 点击支付页面链接后,没有反应?

答:在开发调试阶段,测试链接需要在公众号内点击打开。操作方法可以是:白名单用 户在公众号内向公众号发一条消息,消息内容即为测试链接,然后点击打开。 (5) 点击支付按钮,提示“当前公众号没有权限支付本次交易”

答:请确认使用的 APPID 是否正确,确认在 MP 平台前三项审核结果均为“审核通过”。

(6) 点击支付按钮,提示“众账号支付使用了无效的商户号,无法发起该笔交易”

答:请检查是否使用了正确的商户号,确认 MP 平台前三项审核结果均为“审核通过”。

(7) 点击支付按钮,提示“该公众号支付签名无效,无法发起该笔交易”

答:调起支付的签名错误,请检查相关签名。

(8) 用户成功支付,点击“完成”,又再次跳转至输入密码页面,仍可支付并二次扣费

答:用户在商户的 H5 页面点击了两次“微信支付”,生成了两笔订单,需要在 H5 页面 微信支付按钮上增加防二次点击的机制。 (9) Notify url 无法接收通知

答:需要外网地址,直接打开 Notify url 正常,否则需要商户自己检查错误,同时注意 不要被防火墙拦截。

微信被扫支付接口文档(结算中心-受理机构)V0.0

35

微信公众号支付接口文档 (结算中心-受理机构)V0.0

8.3.常见注意事项

(1) 参数大小写问题

请留意文档中要求的字符大小写问题,如“md5运算后,字符串的字符要转换为大写”。

(2) 参数格式问题

所有传入参数,均为字符串类型,请注意文档中各处的具体要求。

(3) 时间戳问题

请使用 Linux 时间戳,注意为字符串格式。精确到秒,不需要到毫秒,即 10 位数字。

(4) 同一商户订单号支付问题

商户的 out trade no 必须全局唯一,调试和生产环境,都需要使用唯一的订单号。、 注意: 当商户的同一个商户号绑定了公众号支付、小额刷卡、APP 支付也需要加标识来区分, 不能出现重复。当发起支付返回失败时,一定要用原订单的 out trade no 而不能重新生 成新的订单号发起支付,避免同一单重复支付。

微信被扫支付接口文档(结算中心-受理机构)V0.0

36

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读,免费范文网,提供经典小说综合文库微信公众号支付接口文档(结算中心-受理机构)v0.0 - 图文(7)在线全文阅读。

微信公众号支付接口文档(结算中心-受理机构)v0.0 - 图文(7).doc 将本文的Word文档下载到电脑,方便复制、编辑、收藏和打印 下载失败或者文档不完整,请联系客服人员解决!
本文链接:https://www.77cn.com.cn/wenku/zonghe/591326.html(转载请注明文章来源)
Copyright © 2008-2022 免费范文网 版权所有
声明 :本网站尊重并保护知识产权,根据《信息网络传播权保护条例》,如果我们转载的作品侵犯了您的权利,请在一个月内通知我们,我们会及时删除。
客服QQ: 邮箱:tiandhx2@hotmail.com
苏ICP备16052595号-18
× 注册会员免费下载(下载后可以自由复制和排版)
注册会员下载
全站内容免费自由复制
注册会员下载
全站内容免费自由复制
注:下载文档有可能“只有目录或者内容不全”等情况,请下载之前注意辨别,如果您已付费且无法下载或内容有问题,请联系我们协助你处理。
微信: QQ: