TTMusic/oh_modules/@cashier_alipay/cashiersdk

cashiersdk

---

隐私说明

https://opendocs.alipay.com/common/02kiq3

功能说明

• H5支付
• 唤起支付宝支付
• H5转native支付

compileSdkVersion

12

minSdkVersion

12

安装说明

ohpm install @cashier_alipay/cashiersdk

使用说明

基础说明

如果还没有接入过支付宝其他版本SDK，请参考文档： https://opendocs.alipay.com/open/204/105051?pathHash=b91b9616&ref=api 进行服务端接入

配置

唤起支付宝 APP, 需要在项目 entry 中的 module.json5 中增加如下配置

"module": {
...
"querySchemes": [
"https"
],

使用 - 直接支付功能

未安装支付宝 APP 是跳转 H5 支付，已安装支付宝 APP 会直接跳转 APP 支付 通过 router 跳转或者通过 navigation 跳转，只针对未安装支付宝 APP 时跳转 H5 的方式有差异

1. 默认方式，H5通过router进行跳转

   // orderInfo 由服务端生成
   // 第二个参数 控制是否展示支付宝loading        
   new Pay().pay(orderInfo, true).then((result) => {
   let message =
   `resultStatus: ${result.get('resultStatus')} memo: ${result.get('memo')} result: ${result.get('result')}`;
   console.log(message);
   }).catch((error: BusinessError) => {
   console.log(error.message);
   });
   

2. 使用navigator进行跳转

   步骤一：通过调用payWithNav方法
   - 第三个参数由sdk回调传入H5页面名称和需要传入到H5页面的参数，开发者自行进行nav跳转
   - 第四个参数必传 ，传入 NavPathStack 实例    
           
   new Pay().payWithNav(orderInfo, true, (name: string, params: Object) => {
   this.pageInfos.pushPathByName(name, params);
   }, this.pageInfos).then((result) => {
   let message =
   `resultStatus: ${result.get('resultStatus')} memo: ${result.get('memo')} result: ${result.get('result')}`;
   console.log(message);
   }).catch((error: BusinessError) => {
   console.log(error.message);
   });
   
   步骤二： 在你的navigation的navDestination builder中配置对应页面
           
   Navigation(this.pageInfos)...
       .navDestination(this.PagesMap)
       ...
   @Builder
   PagesMap(name: string, navPageIntent: Map<string, Object>) {
   if (name === 'alipay/cashier/H5Page') {
   // name 固定为这个，当然如果你的项目支持动态import的话可以使用回调中的name，二者值一致
   AlipayH5Page({ navPageIntent: navPageIntent })
   }
   }
   
   

1. 使用navigator进行跳转，使用系统路由表

   new Pay().payWithNav(orderInfo, true, undefined, this.pageInfos).then((result) => {
   let message =
   `resultStatus: ${result.get('resultStatus')} memo: ${result.get('memo')} result: ${result.get('result')}`;
   console.log(message);
   }).catch((error: BusinessError) => {
   console.log(error.message);
   });
   

   使用 - H5转native支付

   // 在你的H5容器中拦截url加载
     
   Web({
   src: 'https://xxx/xx',
   controller: this.webviewController,
   })
   ...
   .onLoadIntercept((event) => {
   let data = event.data;
   let url = data.getRequestUrl();
   if (!(url.startsWith("http") || url.startsWith("https"))) {
     return false;
   }
   console.log(`alipay: url: ${url}`);
   let result = new Pay().payInterceptorWithUrl(url, true, (result) => {
     let resultCode = result.get("resultCode");
     let returnUrl = result.get("returnUrl");
     console.log(`resultCode: ${resultCode}, returnUrl: ${returnUrl}`);
     // 如果url不为空，建议商户跳转到对应url，当然也可自行处理
     this.webviewController.loadUrl(returnUrl);
   });
   return result;
   })
   

日志获取

 Log.setupLogCallback((log) => {
      hilog.info(0x00, "sdk_demo", log);
    });

demo下载

以下文档顶部的zip包就是demo https://alidocs.dingtalk.com/i/nodes/qnYMoO1rWxrkmoj2IOpZR6yaJ47Z3je9?iframeQuery=utm_source%3Dportal%26utm_medium%3Dportal_recent&rnd=0.2928087218087806

FAQ

1. 系统弹出唤端确认框，用户点击取消是否有回调？

   没有回调，系统并未给出回调，sdk无法感知

2. 现在跳转H5是以什么方式？

   使用.pay()接口，以router为默认跳转方式

   使用.payWithNav() 接口，以navigator为默认跳转方式。已支持系统路由表，其中第三个参数可不传

   请根据自己的应用框架选用合适的方式。唤端的情况下，两个接口表现一致，无任何区别

3. 是否支持auth？

   不支持，如果要接入auth能力，请参考 极简版 SDK 调用方法

4. 开放平台上目前还不能直接申请鸿蒙app，有什么办法接入吗？

   可以先使用Android或者iOS的项目来申请，再在鸿蒙上进行接入

5. 服务端是否需要改造？

   目前来看不需要。附支付产品文档：https://opendocs.alipay.com/open/204/105051?pathHash=b91b9616&ref=api

6. 遇到错误怎么排查

   过滤alipay_sdk日志，查看错误信息。目前99%都是订单串传入错误，请多检查订单串，是否和android传入到支付宝sdk中的一致。

   订单串用android验证之后不可以支付，再反馈问题

7. 是否支持商家扣款 - 独立签约（免密签约）、芝麻信用等？

   sdk不提供此项能力，请参考开放平台文档，生成对应唤端链接，进行唤端。附独立签约文档：https://opendocs.alipay.com/open/08ayiq?pathHash=a2d4e097

   如何唤端请参考鸿蒙官方文档 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/uiability-startup-adjust-V5

8. 如何判断支付宝是否安装

   华为文档 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/canopenlink-V5

   对应支付宝scheme：'alipays://'

9. 升级sdk版本到15.8.27后，无法打开支付宝app进行支付

   1. 请确认entry模块的module.json5是否配置了"querySchemes": ["alipays"]
   2. 请确认安装的支付宝版本是否>=10.6.50

`10. 升级sdk版本到15.8.29后，无法打开支付宝app进行支付

1. 请确认entry模块的module.json5是否配置了"querySchemes": ["https"]
2. 不再需要配置 "querySchemes": ["alipays"]，除非你需要非 sdk 场景打开支付宝

1. 如需反馈问题，请提供相关信息` > appid(必须提供) > > 订单串(如果方便的话)，不方便提供订单id也可 > > 问题发生的时间 > > 录屏(如果有的话)