收藏
评论

境外支付FAQ官方

(目录)1常见问题 2退款 3风控 4小程序 5普通支付(v2接口)6支付测试 7商户平台问题 8公众平台和开放平台问题

9营销和代金券 10结算、对账单和换汇 11服务器和IP 12回调和域名 13证书和秘钥 14文档和字段

15香港钱包和V3接口 16合单、代扣和分账 17报关 18刷脸 19小微商户 20入驻和子商户进件


1、常见问题

Q:香港商户默认结算币种为港币,需要添加其他的结算币种作为结算,请问怎么添加?

A:现在香港商户都是固定必须走港币结算,如果要走美元或者其他币种得经过特批,然后产品这边开通相应的入口


Q:推荐关注配置方法?

A:现在在商户平台可以直接配置推荐关注


Q:App秘钥是什么,修改App秘钥对交易有没有影响?

A:App秘钥在获取openid的时候需要用到,如果有需要获取openid的交易还是会有影响的


Q:香港商户请求微信支付时对应的接口域名是什么?

A:香港商户一般使用apihk.mch.weixin.qq.com。注意和境内的api.mch.weixin.qq.com的不同


Q:支付后推荐关注这个功能在国内钱包和香港钱包都能用吗?

A: 跨境钱包已支持、香港钱包待支持


Q:商户权限处罚申诉方法?

A:商户被处罚后,如对处罚有争议,可以进行申诉。1、 标准申诉流程:发送邮件到 weixinpay@tencent.com:邮件标题为【申诉/Appeal】+机构 MID+子商户 MID,邮件内容:提供商户注册资质文件、业务模式证明材料(门店照片(线下)、网站/app 截图(线上))、交易详情及凭证,交易详情及凭证说明:如果商户是调单后被处罚,则提交被调订单的交易详情及凭证。如果商户未被调单即处罚,则商户可以选近一个月内的任意三笔交易提供交易详情说明及交易凭证


Q:下单的时候报受理关系不存在?

A:可以检查一下统一下单的sub mchid和机构号是否匹配


Q:境外公众号支付支持支付后跳转吗,需要配置什么关联的权限吗?

A:支持,可以直接跳转不需要配置权限


Q:APP支付报特约子商户商户号未授权服务商的产品权限?

A:需要线下授权,需要发邮件给对接的BD运营申请


Q:不能够正常检测到用户输入密码错误或者取消支付的信息,就报空指针异常了是什么原因?

A:输入密码错误无法检测是商户key错了


Q:微信支付时,能设置只能用某一类的卡才能支付的吗?就是设置一个银行卡的白名单,白名单内的银行卡或卡BIN才能支付?

A:这个功能没有对外, 目前对外的只有限制信用卡


Q:服务商模式支付怎么设置支付后推荐关注的公众号头像为子商户头像?

A:服务商模式支付,如果统一下单传了子商户APPID,就会显示子商户绑定的公众号账户头像。如果没有传子商户APPID,默认就显示服务商绑定的公众号账户头像


Q:不同地区的付款码有什么特征和区别?

A:付款码是按照code128标准,一般是18位纯数字,15开头的一般是香港地区的 其他大部分是13开头。The WeChat barcodes are constructed with 18 numbers, with the start value of 10, 11, 12, 13, 14 or 15. Barcodes with 10-14 are for the China mainland users, while barcodes with 15 are for the China Hong Kong users, who cannot use WeChat cross-border pay

Q:申请绑定主体不一致的APPID(限定资格开放),这种情况说限定资格开放,哪些商户有这样的资格?

A:费率千六及以上且为直连商户 公众号、小程序可以网上自助绑定,可参考以下链接:http://kf.qq.com/faq/1801116VJfua1801113QVNVz.html 其他费率或者子商户号,找运营申请


Q:刷卡支付PAYERROR原因是用户没有输入支付密码,但是用户侧为什么没有输入密码的界面?

A:可能用户侧超时,导致没能拉起收银台。目前境外商户开通了卡包功能后,会成为卡包的子商户。上述情况主要会影响:在系统查单时,系统识别出它有父商户,就会带着父商户信息一起查,但实际上,大单系统里是没有这个父的,最终会导致这笔单查不出来。 解决办法:把上述两个号码列入 “不带父商户号查询”名单,就可解决


Q:APP支付输入密码的时限是多久?

A:正常是2个小时


Q:怎样关闭自动提现,或者设置预留固定金额后提现?

A:老资金流没有这个功能,都是前一天的交易全部自动提现。如果你想账户里留一定的金额。你也可以充值进去,因为充值的资金不会被自动提现


Q:请问下境外的appid如何能得到境内公司的微信支付授权?

A:不可以绑定境内的


Q:刷卡支付用户手机的付款码的有效时间是多久呢?

A:一般来说6分钟后会失效


Q:刷卡支付多久之内可以被支付?

A:刷卡支付如果45s内没有支付,订单就会自动被撤销


Q:支付失效时间设置有什么规则?

A:刷卡至少1分钟,其他5分钟


Q:有没有为商户公众号支付设置静态二维码的API?

A:There is no such kind of direct APIs, you can generate the static qr based on a h5 page developed by you and integrate Official account payment


Q:对于不同地区的商户,香港钱包和大陆钱包用户付款有什么规定呢?

A:1.大陆钱包,分身份证实名用户,和非身份证(港澳回乡证,台胞证,护照)实名用户,前者可以在境内,以及任何已支持微信跨境支付的境外区域付款,后者只支持在大陆付款。2.香港钱包,都是香港实名用户,只支持在香港本地或大陆消费,其他区域都不支持。(境内商户开通香港钱包收款权限,需要找BD评估,然后找橘子申请开通)


Q:商户父子授权产品权限被冻结,该如何申请恢复?

A:请商户提供注册证书,说明实际业务范围,若为线上业务:请提供商户官方网址或(售卖商品链接)/APP在第三方应用市场的下载链接等;若为线下业务:请提供门店外景照片(店名、地址、悬挂于店内的注册证书需清晰可见)、店内商品陈列照片、收银台照片、第三方地图定位截图等。Please provide the merchant with the registration certificate, indicating the actual business scope. For online business, please provide the merchant's official website or (product selling link) /APP download link in the third-party application market, etc.;For offline business: please provide store location photos (store name, address, registration certificate hanging in the store should be clearly visible), store product display photos, cashier photos, third-party map location screenshots, etc.


Q:查询汇率接口查到的汇率和支付页面展示的汇率是不一样的吗?

A:是的,查询汇率接口返回的只是一个参考汇率,具体的汇率,还是需要以查询订单返回的汇率为准


Q:目前境外是否开放微信支付成功页面关联小程序?

A:这个是需要特殊申请的,而且非常难。QA之前提供的appid是我们内部的appid,是方便你们接入刷卡支付,不适用于公众号支付


Q:服务商可以同时是子商户吗?

A:不可以


Q:微信的user agent是什么?

A:MicroMessenger,但user agent本身有一个风险,就是它其实并不唯一,有时候可能两个完全不相关的app可能useragent是一样的,虽然这种情况出现的几率非常非常低


Q:商户已经开通了香港钱包,双开机构商,进件的商户既可以在大陆钱包里面收单,也可以在香港钱包收单,但是实际中使用内地钱包可以成功支付,但是使用香港钱包就失败了?

A:可以按照以下几点逐一检查:

1 国内商户仅直连和服务商模式下的商户支持香港钱包。 银行和机构下的子商户不支持香港钱包。

2 用户的下单接口中,传了limit_pay等参数时,且用户是香港钱包的时候,就会报这个错误,具体要看看商户的下单参数(除了limit_pay外,也有可能是合单,或者有要发票,反洗钱等特殊标记)


Q:限额问题?

A:通过绑定的银行卡支付的,按银行自己设定的限额为主,

——》通过绑定的银行卡支付的,根据不同用户支付的银行卡不同而不同,基本在3万元-5万元/单笔限额为主。

零钱支付限额另外有相关的文档可以参考


Q:境外可以申请渠道号吗?

A:暂时还没开放


2、退款

Q:有一笔交易要退款但商戶法务不同意签退款授权书?

A:每一次都要做退款授权是不可能的,退款授权一般都是机构给子商户只授权一次权限


Q:境外退款的规则是什么,退款的有效期是多久,为什么退款会被关闭了?

A:主要有两个资金池,人民币池和结算币种池,T日交易资金都在前者,T+1都会到后者且不可逆,达到结算起点,就会从后者到商户银行账户。退款都用前者即未结算的人民币的资金。如果商户的未结算人民币资金一直余额不足,超过8天没钱退款就自动关闭了


Q:退款关闭之后再发起退款需要使用什么退款单号?

A:需要使用新的退款单号


Q:退款使用什么汇率?

A:如果是外币标价,退款用交易日汇率,那当时给商户结算多少,退款时也就扣除多少,用户当时支付了多少,也就会返回多少;

人民币标价的情况,正向结算还是用交易日汇率,负向结算用的是退款日的汇率


Q:融合商户的退款规则是什么样的?

A:融合商户有三个资金池,CNY收款资金池,港币收款资金池,结算资金池,大陆用户的交易T日进CNY收款池,香港钱包的用户直接进港币收款池,T+1日全部进结算资金池。如果T+1日做退款,需要对应的收款资金池里有新进的交易资金,比如大陆人退款,就要求CNY收款池有资金,香港人退款,就要求港币收款池有资金,但是注意这里不能使用结算池的资金用作香港用户的退款


Q:境外商户支持商户平台余额退款吗?

A:支持。只要有人民币资金,就可以在商户平台退款


Q:非交易日当天发起的退款,系统在什么时候发起处理?

A: 如果不是交易日当天的退款,在当天中午12点以前发起的退款系统都会在中午12点后再处理


Q:境外退款的资金是用机构还是用子商户的资金来退呢?

A:以机构的维度,资金池从来不会以子商户做划分,都是机构层级的


Q:Query Order API发起request时、trade_status是・NOTPAY ・CLOSED ・REVOKED ・PAYERROR时、都作为失败处理、没有再实施Revoke Order API的必要了对吗?

A:所有的交易都要完成闭环,最终状态保证为close或revoke,也就是必须对刷卡订单调撤销,其他支付订单调关闭


Q:退款报交易未结算资金不足?

A:退款只能使用当天商户平台的所有交易的特定该币种的订单的总资金,而且需要原路退回,用户支付的是港币退款也需要用港币 用户支付的是人民币退款也需要用人民币,你们累加一下今天商户平台该币种所有的交易的总资金看看是否满足退款所需金额


Q:申请退款报金额错误?

A:可以检查一下申请退款的金额兑换为结算币种的金额后是否满足结算币种的最小单位,比如说订单金额是1CNY,退款金额是0.04,商户结算币种是AUD,0.04CNY兑换成AUD后不足0.01AUD,所以这里会报金额错误


Q:香港商户按照港币标价的订单退款的时候怎么计算汇率?

A:港币标价是我们承担汇损,商户测和用户侧都是按比例退,没有汇差。需要退多少HKD订单金额,就按照比例退多少CNY给用户


Q:退款发起通知是通过什么接口配置的呢?

A:这是我们默认带的服务,不需要配置


Q:由于余额不足导致的退款单关闭后,原单重试不成功怎么办?

A:现在是关单时没有修改退款的幂等(商户退款单号与微信退款单号的映射)。所以部分情况下,退款关闭之后,用原来的退款单号重试是可以成功的;但是,由于余额不足导致的退款单关闭后,原单重试一定不成功。在明确退款关闭的情况下是可以更换退款单号的。通过查询订单接口确定退款已经关闭了之后,可以更换退款单号重试


3、风控

Q:你已在当前商户支付过一笔相同金额的订单,请确认是否继续支付?

A:这是最近产品侧上的一个策略,重复支付提示(弹框版本)

商业支付1分钟内,同用户同商户同金额无回调和查单判断


Q:什么是疑似重复支付?

A:商业支付,1分钟内 同用户同商户同金额,有回调判断

(重复支付提示:在重复支付提示的基础上,若满足无回调无查单,则出现全页面提示(否则还是弹框)

此外,预埋刷卡能力,刷卡相关报表建设OK后再规划放量)


Q:同一个交易调用统一下单去分别得到qrcode,jsapi和ios/android对应的order,但是最终只会使用其中一个。这个会被当做支付成功率太低的异常支付行为来处理吗?

A:同一个订单,按照不同渠道支付业务上是可以的,从订单转换率上来说肯定是有一定的影响,不过你们业务系统能够辨识并接受就可以


4、小程序

Q :小程序A获取openID,并生成支付连接,在小程序B里用这个支付连接,可以成功支付吗?

A :不能实现,小程序B里一定要用自己的参数才能下单,别的小程序的参数是不能支付的


Q:小程序可以内嵌H5支付吗?

A: 不可以,小程序内嵌的h5完全无法拉起支付


Q:小程序支付需要设置支付目录吗?

A:不需要的,只有JSAPI支付需要设置支付目录


Q:小程序调起微信支付就闪退是什么情况?

A:检查下是不是参数有问题, 可能是造成内存溢出了。小程序被封也有可能造成这个情况


Q:机构模式下小程序拉起付款码失败是什么原因?

A:原因是目前还不支持机构模式


5、普通支付(V2接口)

Q:境外APP支付和刷卡支付调起支付请求报系统繁忙?

A:可以先检查一下统一下单中传的参数“fee_type”是否正确填写,大小写也要填对,一般只能使用大写的字母表示货币类型


Q:支付目录是如何配置的,有什么规则?

A:支付目录配到二级或三级是不行的,一定要配到最后一级 支付授权目录是网站发起请求的页面所在目录,并且必须是能通过url地址访问的(与真实物理目录路径无关)。注意这个目录在注册填写时,需要精确到最细一级的且使用名称后直接加文件名,不可再增加 or 删减目录。

支付目录的设置,首先要看你支付的当前页面URL,严格区分大小写。

比如当前页面是:http://www.taidupa.com/wxpay/js_api_call.php

那么就必须填写支付授权目录为: http://www.taidupa.com/wxpay/


Q:服务商公众号支付商户没有配置支付目录,也能支付成功 ,查到服务商子商户下都没有和商户提供的支付页面url一样的支付目录,这个怎么解决?

A:那可能是服务商的公众号 , 一定要配置子商户自己的 才行 (子商户的公众号支付才需要配置支付目录url 服务商的不需要配置)


Q,签名错误怎么排查?

A:可以按照以下几点排查:

1,参数格式大小写可能不对。

2,参数的长度也需要满足文档要求。

3,商户的key是否正确。

4,需要确认接口是否有特殊签名类型要求


Q:境外商户标价币种支持什么类型?

A:支持人民币或者结算币种。每个机构号或直联商户号只能有一个结算币种


Q:APP支付报:服务商商户号未开通该产品的受理权限?

A:机构模式下 子商户需要申请授权APP支付权限才行


Q:H5支付域名和JSAPI分别怎么配置,H5支付域名可以和JSAPI支付目录一样吗?

A:可以相同,也可以不同,但h5支付只需要配置到域名,jsapi则是需要配置到目录


Q:支付成功返回的sub_openid与统一下单传的sub_openid不一致?

A:1,传了错误的sub_openid没有报错,这个是内部历史遗留问题,后续会逐步修复

2,现阶段,商户按照文档要求,正确上传就好

3,如果商户传的字段是openid,并不是sub_openid,是强校验的


Q:APP支付报-1错误,其他原因都检查过了,还是查不出原因怎么办?

A:可以使用ios调试看看,安卓的可能会有不稳定


Q:JSAPI支付QR code怎么生成?

A:静态二维码需要商户基于JSAPI支付的h5页面url用随意一个生成二维码的工具或类生成

(please try to create the QR CODE based on the H5 page of the JS API payment with any tool or class on your program system.)


Q:关闭订单最多可以关闭多久以前的交易呢?

A:主要是未支付的订单都可以关闭 ,没严格的时间限制


Q:APP支付成功无法收到回调,改了一个回调地址就可以接收到是怎么回事?

A:回调URL的设置有限制

不支持类似xxx.xxx.org.cn, 这样的三级域名。

只支持xxx.org.cn这样的二级域名


Q:境外NATIVE支付请求报系统繁忙?

A:请按照以下几点检查:

1)xml格式是否正确。

2)没用的字段不传,不能传null,比如err_code_des。

3)签名出问题也会显示系统繁忙的,注意要设置完所有参数后才进行签名。

4)是否有在对应的商户平台设置扫码支付回调url


Q:公众号支付报此公众号并没有这些scope的权限,错误码:10005?

你好, 请按照以几点检查:1)建议检查一下公众号的功能。比如是不是在订阅号/未认证的公众号里面尝试调用认证服务号的功能。2)微信支付认证过期或者APPID填写错误。3)请使用snsapi_userinfo的授权登录方式即可解决 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_9&index=8


6、支付测试

Q:境外支付的测试商户号是什么样的,测试商户号可以下载对账单吗?

A:测试商户号是1900开头的,测试商户号不支持下载对账单,因为测试商户号没有结算功能


Q:境外的测试用户号是什么样的,有什么作用?

A:测试用户号只能配合测试商户号使用


Q:小程序支付支持使用测试商户号吗?

A:测试商户号不能用在小程序支付上


Q:测试的商户号账号可以登录微信支付商户平台吗?

A:测试商户号不提供登录credential,无法登录商户平台


Q:测试商户号需要设置扫码支付回调url吗?

A:不需要,测试商户号这个参数无效,可以不用设置


Q:这个测试商户号, 和真正的production的商户号,是不是有完全一样的支付功能权限?

A:只能测试quick pay和native pay。 In-App Web-based Payment (Official Account Payment) 和 In-App Payment 不能使用。测试商户号都是多家共用的,且互不影响


Q:境外商户只有一个正式商户号,如何进行支付测试?

A:可以申请一个sub_ mchid 专门用于测试

7、商户平台问题

Q:子商户的个数现在有限制吗?

A:没有


Q:商户平台提示安装安全控件但是始终无法安装成功怎么办?

A:You can use the Chrome browser, and do the following setting:  1:log on to: chrome://flags/#enable-nacl

2: try to find the Native Client, and change the status into Enable


8、公众平台和开放平台问题

Q:公众号文章里怎么放置公众平台外部链接?

A:微信公众号文章有时候会有添加超链接的需求,这些超链接一般是公众号平台内部的链接,当然如果想要添加外部平台的链接也可以,但是会有条件限制:首先进入微信公众平台编辑页面,选中要添加超链接的文字或者图片,然后点击菜单栏中的超链接按钮;

境外的商户不支持在公众号文章中放置外部链接


Q:公众号主体支持修改吗?

A:你好,账号主体不支持修改,除非符合链接中的几种特殊情况才能支持修改,http://kf.qq.com/faq/171212aAfIRb171212q2MJ7J.html

1.若符合上面链接中的特殊情况,可重新发起认证来申请修改(在认证环节提供新的主体证件等材料);

2.如果主体有工商变更证明,可在公众号后台,主体详情入口页提交材料申请纠正


Q:境外商户支持开通订阅号吗?

A:不支持。根据相关政策规定,境外商户主体不支持开通订阅号相关服务


Q:已经有openid了,如何获取用户的union ID?

A:可以通过授权登陆获取


Q:开放平台的app拉起小程序权限已获得,但是没有绑定选项,是怎么回事?

A:这个功能调整过了,不需要app去绑定小程序。可以点详情进去看新调整后的内容


Q:一个公众号可以设置几个网络授权域名?

A:目前可以设置2个


Q:公众号授权第三方如何操作?

A:公众号授权第三方平台参考文档:https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/Authorization_Process_Technical_Description.html

9、营销和代金券

Q:境外可以自己创建代金券吗?

A:现在境外不支持自己创建活动


Q:商户怎么发券?

A:只能公众号和小程序的appid去发券,不能用app的


Q:之前接口是升级到支持单品优惠退款的V2接口了,在境外使用单品优惠和指定金额退款失败,是什么问题?

A:单品优惠和指定金额退款的接口, 目前还不支持境外,需要商户切换回原来版本的退款接口


10、结算 对账单和换汇

Q:怎么查询商户未结算的人民币资金是否充足?

A:只能看当天的订单的人民币总金额


Q:换汇时间?

A:一般在凌晨,3-9点都可能


Q:换汇的时候人民币换成外币是四舍五入吗?

A:RMB转外币,不四舍五入



Q:结算给商户时间?

A:日切是0点,从0点到早上10点之间出账。具体到账时间根据结算银行的处理情况,可能会有延迟。

(满足800美金等值外币起结算点后 T+1日结算银行会处理打款给商户 日切是0点 从0点到早上10点之间出账)


Q:商户平台提现手续费?

A:商户平台提现无需支付手续费,交易时会按照商户申请入驻时选择的类目按笔收取手续费,类目请参考:http://kf.qq.com/faq/140225MveaUz1501077rEfqI.html


Q:微信支付收费方式?

A:开通微信支付商户不需要付费,但通过微信商户平台交易时,微信支付会按照商户的费率按笔收取手续费。结算时扣除相应的费率再结余下的资金,结算费率计算方式可参考:http://kf.qq.com/faq/140225MveaUz1504092YFjeM.html温馨提示:充值提现、红包、企业付款到零钱等营销功能均不收取手续费


Q:手续费扣费规则,商家得到的结算外币是如何计算的?

A:结算的时候扣手续费。单笔外币结算手续费,并且进行四舍五入


Q:境外支持手动提现吗?

A:境外不支持手动提现。商户需要临时暂停支付或结算功能请【<a data-miniprogram-appid="d3hmNzVjZmNiYjU0MTJkYjE1" data-miniprogram-path="cGFnZXMvc3VibWl0L3N0ZXAyL3N0ZXAyLmh0bWw/YmlsbGlkPTE3MTIyMnNlbGZxYTYzZTg0ZGZjJnNjZW5lX2lkPWtmNTQ1MyZhY3Rpb25faWQ9MTU1MzY4NDc0NDEwMDc3" href=" ">点击此处</ a>】提交资料申请,提交后请在3个工作日内留意审核结果。

商户注销请【<a data-miniprogram-appid="d3hmNzVjZmNiYjU0MTJkYjE1" data-miniprogram-path="cGFnZXMvc3VibWl0L3N0ZXAyL3N0ZXAyLmh0bWw/YmlsbGlkPTE3MTIyMnNlbGZxYTFlMDEzYjVhJnNjZW5lX2lkPWtmNTQ1NCZhY3Rpb25faWQ9MTU1MzY4NDc0NDMwMDk0" href="https://kf.qq.com/touch/bill/170622selfqa9669d101.html?action_id=155368474440018">点击此处</ a>】提交资料,注销申请提交成功,不可撤销或修改。若账户内有未结算资金,注销后会将资金结算至可用余额内,请自行登录平台手动提现。温馨提示:新资金流模式商户,暂不支持注销,可关闭支付;小微商户、服务商不支持注销


Q:微信支付可不可以把商户的营业额直接付给商户?手续费单独付给日本机构?

A:没办法哦,日本地区暂不支持这种模式,这是日本合规管控要求的 没法这么操作


Q:对账单是什么时候生成的?

A:10点以后陆续生成昨天的账单


Q:对账单是以appid为维度还是商户号为维度?

A:以商户号为维度


Q:换汇的汇率?

A:换汇使用的是交易日的汇率


Q:在23点59分以后的订单有可能出现在下一天的对账单中,即临近凌晨0点的账单有时候不出现在当天的对账单中,这种情况怎么处理?

A:建议增加挂账机制


Q:下单回调失败,假如查询也没收到应答的情况怎么办?

A:如果确系网络问题导致交易无法正常完成,可以选择其他方式再次支付,当前支付订单通过第二天对账后,进行处理(支付成功的退款)


Q:结算是否会对机构维度进行冻结?

A:结算权限不会对机构进行冻结,只会对子商户进行冻结


Q:对账单接口在机构模式下,子商户号的作用是什么?

A:子商户号的作用是请求特定的子商户号的所有账单,假如不传子商户号,则返回该机构下的所有子商户的对账单


11、服务器和ip

Q:服务器是否可以在外国?

A:目前这么搞的就adyen一家机构,因为他们是国际gateway,然后又不想在国内去租服务器。其实这样不是很稳定,毕竟国际网络环境很复杂,网络出了问题很难定位而且没法容灾。境内现在因为就两大运营商,而且有完备的容灾体系,所以如果做境内业务,最好还是服务器部署在境内,毕竟境内业务体量要大很多,对服务稳定性要求也高很多


Q: host ip是指交易中的哪个参数?

A: 不是,正常请求微信支付接口,都是通过dns解析ip来访问,可以查看下你们是否绑定了固定ip来访问的


Q:香港的接入ip什么调整?

A:香港的接入ip有调整,请大家知悉。

https://pay.weixin.qq.com/index.php/public/cms/content_detail?lang=zh&id=74001


Q:打算做监测,判断到微信的连接是否正常,可以掌握和追踪跟微信系接连接出现的问题。用telnet的方法去测试,每隔一分钟连一下,这样做可以吗不会被判定为危险操作吧?

A:可以这样做


Q:境外的进出口IP是什么?

A:Hello, team,

If your request domain is apihk.mch.weixin.qq.com, the entrance IP are 203.205.234.247, 203.205.254.189.

And for the exit IP, they are 101.226.103.0/25,140.207.54.0/25, 103.7.30.0/25, 203.205.219.128/25, 183.3.234.0/25,58.251.80.0/25

Entrance IP means when you request our API, the IP of our API domain.

Exit IP means when we request your notification url, the exit IP we used. For api.mch.weixin.qq.com and apihk.mch.weixin.qq.com, the entrance IP are different, but we cannot provide the entrance IP for api.mch.weixin.qq.com. For the exit IP, they are all the same.


Q:发到apihk的请求有比较多的超时,如何查看微信支付这边的metrics是否有什么异常?

A:可以帮忙执行下这个命令,看下统计数据:

for i in {1..100};do curl -so /dev/null -w "DNS_lookup:%{time_namelookup}, TCP_handshake:%{time_connect}, SSL_handshake:%{time_appconnect}, TTFB:%{time_starttransfer}, Total:%{time_total}\n" "https://apihk.mch.weixin.qq.com/pay/orderquery" ;done


Q:网络出现问题,请求接口耗时比较长怎么办?

A:推进安装一下网络工具进行自查,安装指引:http://kf.qq.com/product/wechatpaymentmerchant.html#hid=2857

可以看一下以下指引提高安装效率:


12、回调和域名

Q:扫码支付回调链接有什么用?

A:是扫码支付模式一的回调地址,模式二在统一下单里设置,模式一在商户平台设置。

境外非直连模式不支持模式一(境外的直联商户才支持模式一,但是现在已经实行断直联)


Q:小程序的业务域名在哪里配置?

A:配置的地方一样,就是小程序内加载webview时开发的页面的域名,在小程序的管理平台里配置


Q:H5支付域名如何增加?

A:找对接的运营申请。(为了安全起见,商户运营场景发布功能都是要在测试环境测试无误才可以发布。

该测试网站仅用于实际运营发布前的测试环节,能否单独给开通测试域名,测试成功后关掉)


Q:境外网页授权域名可以设置几个?

A:境内境外都是一样,可以设置2个


Q:JSAPI支付完成后是否可以实现跳转?

A:可以的,可以参考https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6


Q:接口地址异常可以怎么排查?

A:商户可以检查一下是否绑定了host。由于网络变更,如下接入IP需要裁撤替换的通知:https://pay.weixin.qq.com/index.php/public/cms/content_detail?lang=zh&id=45603


Q:授权报10003redirect_uri域名与后台配置不一致?

A:你好, 请仔细检查公众平台配置的网页授权域名与请求的域名是否一致。 配置域名:登录微信公众平台--设置--公众号设置--功能设置--网页授权域名;也有可能是商户对网页授权域名做了两次encode导致报错

这里encode符号的规则,1:正常一次encode冒号是%3a, /是%2f

2:如果做了两次encode前者就变成%253a,后者变成%252f


Q:部分商户在2月24日的回调报文出现了异常,外币标价的订单收到的回调的cash fee和total fee数值一样,回调中的total fee显示错误,不是真实外币标价的金额?

A:这个问题是是内部版本问题,当天已经做了回退,问题已经修复了


Q:微信回调通知缺少微信订单号的问题?

A:这里有一些特殊规则,但不便透露,可以确认是version和sign_type字段会出现在回调中,但是是非必填字段,后续我们在文档里更新一下


Q:微信回调中的通知id对同一个微信订单号是唯一的吗。对于同一笔订单,如果 重复的进行通知,这个id会变化吗?

A:通知的唯一标识。x联的支付通知回调,是按微信支付单号生成的回调id,所以是不变的


Q:境外商户现在服务器在国内的是否也是建议使用apihk的那个域名呢?

A:如果服务器部署在国内,就用api.mch.weixin.qq.com


13、证书和秘钥

Q:证书私钥的导出方式?

A:部分开发语言和环境,不能直接使用p12文件,而需要使用pem,所以为了方便您使用,已为您直接提供。也可以使用openssl命令来自己从p12 文件中导出


Q:已经替换了新证书,为什么API安全里还有更换服务器通讯证书的提醒?

A:这只是一个提示,没有去检测商户是否有在他的服务器端成功替换旧证书


Q:如何升级证书?

A:请参考文档:https://kf.qq.com/faq/180824BrQnQB180824m6v2yA.html


Q:证书失效时间是什么?

A:1,这里说的情况,是商户已经升级成新的证书了,已经在正常使用了,但使用后,比如说商户换了技术,遗失了新的证书,这个时候,可以在商户平台里面,点更换证书,再生成一个订书,这个时候,遗失的那个证书就会在48小时后会失效。

2,这里的情况,就是你截图中的情况,首次升级成新的版本的证书后,老的版本的API证书会在14天后失效


Q:升级为新的版本的证书后旧的证书的有效期是14天内有效是什么意思?

A:申请新的证书后,商户就有两个证书了。从安全角度讲,旧的那个就没有存在得意义了。但从业务连续性讲,我们又不能将旧的证书立即作废。因此我们采用的是限制旧的API证书的有效期


Q:那证书序列号在哪里查看?

A:在证书文件,apiclient_cert.pem, 用软件工具进行获取。https://myssl.com/cert_decode.html


Q:升级证书时显示商户名称和登录账户不一致?

A:商户那边商户名称是从商户平台复制过去的,但是平台上的复制功能只是从网页前端取得,而非从我们后台记录的商户名称取值,我们后台记录的商户实际的名称多了一个空格,所以商户在填写名称的时候报名称和登录账号不符合的错误。后续后台在比较时,连续的空白符压缩成一个空格来比较,以解决空格不匹配的错误,现在已经在优化进程中,会发版本来兼容这种问题


Q:证书验证出错? 

A:检查商户证书是否匹配或者已经失效


Q:使用证书工具安装证书失败,在第二部的把证书工具中的请求串复制到商户平台后,从商户平台切换到证书工具中点击next的时候,返回:“Error, please copy the correct certificate to the clipboard”?

A:检查是否从商户平台把正确的请求串信息复制到了剪切板中


Q:当商户只有自签证书的时候,续期证书的方法是什么样的?

A:只有自签证书的情况下,需要做更换。境外的一开始就没有自签证书,申请后让他继续申请CA证书,申请后要部署到他的服务器上面去,替换掉旧的证书


Q:证书还有好多天才到期,在平台点击续期之后,是否需要导出新证书并替换到服务器上?

A:不需要,这种只需要在商户平台点击一下续期即可。可以参考文档:https://kf.qq.com/faq/161222nEB7b6161222ArMNFR.html


Q:商户原来更新证书的时候没有注意保存证书文件,现在需要重新下载更新的证书,现在不用原来的电脑设备,用wxcertutil工具可以重新获取证书吗?

A:可以的。 用这个链接也可以下载 https://wx.gtimg.com/mch/files/WXCertUtilEn.exe


14、文档和字段

Q:什么情况下会返回NOT ENOUGH的错误码?什么情况下返回trade error的错误码?

A:如果用户是银行卡余额不足会返回Notenough;

返回trade error则是这里这种情况确实是用户没有可用的支付方式,但是这个不仅仅包括余额不足这一种情况


Q:1.7版本的文档什么时候上线的?

A:更新日期2019年10月底。目前的线上文档和1.7版本是一样的


Q:使用了优惠券后,返回的cash_fee金额与total_fee有差异,报关的时候商品的价格传多少呢?

A:现在建议您通过汇率和total_fee去计算哈


15、香港钱包和v3接口

Q:V3 支付成功后回调解密报文出现这个javax.crypto.AEADBadTagException: Tag mismatch!,是什么原因?

A:商户回调解密key配置错误


Q:融合商户的对账单人民币港币账单展示的情况是什么样的?

A:存量升级的账单2种标价的对账单和新接入的香港钱包商户的对账单都是合在一起的,都只展示港币,另外如果用户是用人民币支付的,在cash_fee字段中可以看到用户实际支付的人民币金额。新接入的香港钱包商户fee_type 标价参数都是HKD,新接入的香港钱包商户判断是否是港人用户只能看bank_type类型字段


Q:v3接口返回“PARAM_ERROR”错误,message提示header缺少微信支付平台证书序列号?

A:根据错误提示,这边请求头没有进行加入平台证书的序列号,这边需要在请求头中加入wechatpay-serial参数,具体序列号的值,可以进行请求平台证书接口获取。境外的退款资金来源是待结算,而不是余额。境外的资金体系里没有余额


Q:香港钱包商户号(32开头的),交易出现 invalid appid的报错怎么解决?

A:如果是纯香港钱包问题需要找一下商户对接的fit的同学查看


Q:融合商户怎么区分用户钱包是什么钱包?

A:根据账单里的bank_type区分


Q:如何申请香港钱包新商户?

A:申请香港融合钱包新商户账户的申请地址 https://pay.weixin.qq.com/public/wechatpay/apply_guide


Q:v2的商户设置了apiv3秘钥,对v2接口的微信支付有没有影响

A:没有影响


Q:查询订单接口验证签名串是什么样的?

A:待签证参数:

GET

/hk/v3/transactions/out-trade-no/12345678901234567?sp_mchid=104556286&sub_mchid=293024388

1560757110

1560757110128

\n


Q:v3下载对账单接口验证签名规则是什么?

A:按照以下格式:

时间戳\n

随机字符串\n

Sha1\n

\n

注意最后有2个\n


Q:v2和v3版本的实时汇率是会存在差异的吗?微信V3版本接口有没有实时汇率获取API呢?

A:有差异,目前v3没有汇率接口,人民币金额根据cash_fee和promotion字段内的优惠金额相加得到


Q:如何判断是否为v3接口商户?

A:18年12月以后接入的,mchid和mchcode不一样的就是v3接口商户。

另外商户号和mchcode是否一致,只是用来判断该商户号是否是v3商户号,对于香港地区,如果是v3商户号,那只能使用v3接口。但香港地区老的入驻商户,商户号版本还是v2,做融合升级后,虽然商户号版本还是v2,但是内部做了特殊处理,是即可以使用v2接口也可以使用v3接口的


Q:支付一直报验证签名失败?

A:情况一:如果统一下单、调起支付参数和待签名串没问题,主要就是检查证书序列号和商户私钥是否正确。可以检查一下签名原文sign_src 字段是否正确;

情况二:如果不能确定统一下单和调起支付参数是否有问题,可以通过商户的私钥生成签名,然后再利用生成的签名发起请求看看,能不能成功:

  1. :可以判断生成签名有没有用小程序的appid来生成;
  2. :可以检查调起支付参数是否正确;
  3. :记得clear一下项目缓存,有时候项目缓存可能也会导致一些问题。(signtype不影响签名,但是会导致拉起支付时存在不识别的参数值。signtype取值应为RSA,而不是SHA256withRSA。)

情况三:查看商户的待签名串代码,是否换行符和报文都没有缺少

Q:v3在线文档中的wechatpay-apache-httpclient工具可以自动做应答验签吗

A:这个只是个demo,参数名都是固定的,不是适用于每个接口

16、合单、代扣和分账

Q:国内商品和国外商品合并支付了,真正支付的时候,走的是跨境支付的接口,还是国内支付的接口呢?境外合单规则?

A:合单只能走国内的商户号发起,境外商户号为被合方,但合单要求发起方合被合方的appid相同,所以境外机构模式这里还走不通


17、报关

Q:推给海关或者国检都偶尔有出现这个错误:<err_code_des><![CDATA[[132021059]您的操作已提交,请确认是否已生效?

A:国检的国庆前已经暂停了,可以直接推广州总署后即可去清关


Q:报关支持什么币种?

A:只支持人民币


Q:报关返回支付人与订购人不一致 但是用户反馈是一致的?

A:早期存量用户预留实名为小写x,所以比对不一致,我们这边已经解决了大小写校验问题


Q: 实名信息尾数带X的报错,商户这边需要做什么,现在调用重推接口重推,然后再去清关再看看吗?

A:上次报错的订单,分两种情况:

1,如商户是给我们传实名信息的话,先调用“订单附加信息提交接口

”发修改(action_type=MODIFY)报文在微信侧比对实名一致,然后再调用重推接口重推即可

2,商户如果在昨天调用“订单附加信息提交接口”不传实名信息返回DIFFERENT的,直接调用重推接口重推即可


18、刷脸

Q:刷脸怎么申请?

A:找对接的BD申请


19、小微商户

Q:小微商户的提现是什么样的,支持开通手动提现吗?

A:小微都是自动提现的


20、入驻和子商户进件

Q:境内的公司需要有境外的商户号,怎么接?

A:他们都要注册一个境外主体才能申请


Q:境内的服务商如何才能为境外的做停车场支付的公司接微信支付?

A:需要服务商注册一个境外的主体,而且需要服务商在本地有支付牌照


Q:请问最近子商户进件接口做了什么新的变动,我们收到了一版新的报备接口?

A:计划对个别地区的机构做强化进件,强化后进件子商户需要提交注册证件、门店照片、负责人的个人信息、UBO信息等。机构可以通过开放平台或API进件


Q:office_phone的长度限制是多少?

A:5-25位


Q:service_phone,我这边限制的是长度5-32。 merchant_mobile_phone 手机这个字段有没有加正则校验?

A:16个字符以内。contact phone字段是15位以内


Q:进件的时候的境外银行机构需要传channel id吗?

A:不是必传,未来这个参数及对应的能力都可能下掉了


Q:商户平台无法进件可能是什么原因?

A:有可能是商户的权限被处罚了,机构可以先查看一下自己的权限是否正常


Q:报备完成后发现除了business code外其他参数是错的,我们需不需要改,怎么改?

A:建议您把其他的数据,比如商户名字,其他信息等,都修改一下就行了哈


Q:显示无法新增商户是什么原因?

A:可能是这个机构的等级被降为C了


Q:当前商户需补齐相关资料后,才可进行相应的支付交易,请商户联系对接的微信支付服务商?

A:要登录渠道号补齐资料,或者通过小程序进行认证。也有可能是这个原因:商户进到了“报名了激励项目的商户号”中


Q:子商户进件报签名错误?

A:1、首先排查自己的商户key是否正确。(//注:key为商户平台设置的key)

2、排查完了之后,到这个网页https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=4_3 拼接请求,看是否和你代码拼接的请求是一样的

最后一次编辑于  2020-11-18
收藏

6 个评论

  • Hongyi
    Hongyi
    2023-11-01

    几个问题确实很有代表性 感谢分享

    2023-11-01
    赞同
    回复
  • 春天燕子   
    春天燕子   
    发表于移动端
    2022-06-09
    我要退款,请求帮助
    2022-06-09
    赞同
    回复
  • 春天燕子   
    春天燕子   
    发表于移动端
    2022-06-09
    我不喜欢
    2022-06-09
    赞同
    回复
  • 冯金良
    冯金良
    发表于移动端
    2021-06-13
    1′昨天寻缘平台收了一千捌元走了
    2021-06-13
    赞同
    回复
  • Memory
    Memory
    2021-05-14

    2021-05-14
    赞同
    回复
  • Javen
    Javen
    2020-05-21

    这个QA 很有参考价值 感谢分享

    2020-05-21
    赞同
    回复
登录 后发表内容