前言
最近有个需求,不能在iOS客户端内集成支付宝和微信的App支付SDK(为了防苹果审核检测SDK),因此使用H5支付,虽然微信和支付宝的H5支付文档都说不要在App内使用H5支付而是使用App支付,但办法总是有的。
这篇讲的是H5微信支付如何从App跳转微信以及如何从微信跳转回App,支付宝的见这篇:
实现的效果是:App→微信→支付(成功失败或取消)→App
前置准备
本项目使用WKWebView,前置动作是后端小伙伴已经处理好微信H5支付下单链接,客户端接收到下单链接后的操作。
下单链接即为微信支付文档-统一下单API中返回的 mweb_url
,格式为 https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241
。
操作步骤
1. 添加 URL Scheme 并把微信加入白名单
添加 URL Scheme。在 xcodeproj
文件 Info
选项卡最下面的 URL Types
内设置。 注意此URL的一级域名需要与微信商户后台(微信商户平台-产品中心-开发配置-H5支付)设置的的一级域名一致,比如微信商户里设置的是company.com
,那 URL Schemes 可以设为 a1.company.com
,此特性使得一套H5支付可以方便得集成到多个App。只有一个App需要H5支付的话也可以直接填与微信后台的一致的 company.com
。
2019年4月10日更新
如果像上图那样填的是www.company.com
,那 URL Scheme 只能设为其三级域名如a2.www.company.com
或同样的www.company.com
把微信的 URL Scheme weixin
和 wechat
填入项目的白名单。在 xcodeproj
文件 Info
选项卡内的 Custom iOS Target Properties
的 LSApplicationQueriesSchemes
里添加上述两个字符串,若没有 LSApplicationQueriesSchemes
就手动输入添加,类型为数组 Array。
2. WKWebView加载链接
添加协议 WKNavigationDelegate
和WKUIDelegate
。
创建一个WKWebView,并加载统一下单链接。
1 | - (void)buildWKWebView { |
此处self.payString就是后台传来的微信H5支付统一下单链接,格式为 https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458041
。
我们需要做的处理是根据文档给这个请求添加请求头 Referer
,关键在于这个 a1.company.com://wxpaycallback/
既满足了微信检测到有商户后台设置好的一级域名,同时把这个链接做成了 URL Scheme 使得可以在跳转微信客户端后(不管支付成功还是失败)能顺利跳转回自己的App。其中的 host wxpaycallback/
可以任意设置,方便在 AppDelegate
里处理跳转回来后部署业务逻辑。当然如果你不需要在 AppDelegate
里接收动作而是直接跳回支付界面自行后续处理的话就只用设为前一步在 URL Scheme a1.company.com://
即可。
2019.4.10 更新
经过测试,对于App内的H5支付而言,实际上是下面步骤里
@"https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb"
后接的参数redirect_url
对支付后跳回App起作用,Referer
只起到给微信校验的作用。所以
Referer
只需要设置成微信H5支付登记的域名的子域名即可,如[request setValue:@"a1.company.com" forHTTPHeaderField:@"Referer"];
3. 实现代理方法拦截链接并跳转微信
1 | - (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler { |
4. AppDelegate 中接收跳转动作
当然你也不一定需要在AppDelegate里接收返回动作,也可以直接返回支付界面,自行操作后续逻辑。
以下是AppDelegate接收返回动作的示例。
1 | - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options{ |
5. 关于微信H5支付域名设置
2019年4月10日更新
这里额外提一下,截止到2019年4月,微信支付设置页面明确说了
添加域名后,其所属的子域名将都有权限
也就是说只需要填一个一级域名比如 company.com
,就可以有无限多个二级域名可供不同App使用,绕过微信H5支付只能添加5个域名的限制。如果填的是二级域名比如 www.company.com
,那么只能往下使用三级域名比如 a1.www.company.com
以微信H5支付域名填了 company.com
为例,那可以这样操作
App | Alpha | Beta-A1 | Beta-A2 | Gamma |
---|---|---|---|---|
添加的Referer | alpha.company.com | a1.beta.company.com | a2.beta.company.com | gamma.company.com |
要替换的redirect_url | alpha.company.com://optional | a1.beta.company.com:// | a2.beta.company.com://optional | gamma.company.com:// |
URL Scheme | alpha.company.com | a1.beta.company.com | a2.beta.company.com | gamma.company.com |