引导用户绑卡场景
========

#### 场景介绍

从5.0.5(17)版本开始，新增支持引导用户绑卡场景。

支持拉起绑卡页面，结合商户营销活动，有效引导用户完成绑卡操作。例如商户针对银行卡开展某营销活动，需要引导用户拉起绑卡页面完成银行卡绑定。

支持商户模型：直连商户、平台类商户、服务商

引导用户绑卡页面展示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e9/v3/uIsyC-9RT5GxyOaMjS0y1w/zh-cn_image_0000002594669390.png?HW-CC-KV=V1&HW-CC-Date=20260612T073633Z&HW-CC-Expire=86400&HW-CC-Sign=3671331F91C1979EFDFAFF9A4BA4FEE0F9BCB47F40D7E1C2AC51A32AE6BDAABB)

#### 提供绑卡跳转应用信息

开发者需与华为支付业务侧沟通（合作咨询可[点击此处](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/payment-service-support)）后提供以下应用信息：

| 应用信息 | 是否必选 | 说明 |
| :-- | :-- | :-- |
| AppID | 是 | 应用的AppID（在[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)网站点击“开发与服务”，在项目列表中找到项目，在“项目设置 > 常规”页面的“应用”区域获取“APP ID”的值）。 |

#### 业务流程

开发者接入引导用户绑卡，具体接入流程如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fd/v3/RsaHPW2TTUGG4vf9QBD7ew/zh-cn_image_0000002594829318.png?HW-CC-KV=V1&HW-CC-Date=20260612T073633Z&HW-CC-Expire=86400&HW-CC-Sign=672DECB0DBEC3AED4BE9A5A10ABAC25528A10E9F8841AF02463C6CEB7696F640)

**场景1：用户取消绑卡**

1.  商户客户端调用[requestBindCard](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-paymentservice#requestbindcard)接口拉起用户绑卡页面。
    
2.  Payment Kit客户端展示绑卡页面，商户客户端可根据用户不同处理场景完成后续流程。
    
3.  用户返回或取消绑卡。
    
4.  Payment Kit客户端返回商户客户端并将绑卡结果一并返回，商户客户端根据绑卡结果完成后续业务处理。
    

**场景2：用户完成绑卡**

1.  商户客户端调用[requestBindCard](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-paymentservice#requestbindcard)接口拉起用户绑卡页面。
    
2.  Payment Kit客户端展示绑卡页面，商户客户端可根据用户不同处理场景完成后续流程。
    
3.  用户通过绑卡页面完成绑卡操作，Payment Kit客户端会请求Payment Kit服务端处理绑卡。
    
4.  Payment Kit服务端处理绑卡。
    
5.  Payment Kit服务端将绑卡结果返回给Payment Kit客户端。
    
6.  Payment Kit客户端展示绑卡结果页面。
    
7.  用户关闭绑卡页后，Payment Kit客户端返回商户客户端并将绑卡结果一并返回。
    
8.  商户客户端根据绑卡结果完成后续业务处理。
    

#### 接口说明

拉起用户绑卡页面接口。具体API说明详见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-paymentservice#requestbindcard)。

| 接口名 | 描述 |
| :-- | :-- |
| requestBindCard(context: common.UIAbilityContext | common.UIExtensionContext): Promise<BindCardResult> | 拉起用户绑卡页面。 |

#### 开发步骤

#### \[h2\]拉起绑卡页面（端侧开发）

商户客户端调用[requestBindCard](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/payment-paymentservice#requestbindcard)接口拉起用户绑卡页面。

当接口通过.then()方法返回结果，则表示接口请求成功，通过.catch()方法返回异常表示请求失败。当此次请求有异常时，可通过**error.code**获取错误码，错误码相关信息请参见[错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-payment)。

示例代码如下：

import { BusinessError } from '@kit.BasicServicesKit';
import { paymentService } from '@kit.PaymentKit';
import { common } from '@kit.AbilityKit';

@Entry
@Component
struct Index {
  context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
  requestBindCardPromise() {
    paymentService.requestBindCard(this.context)
      .then((bindCardResult: paymentService.BindCardResult) => {
        // 绑卡成功
          console.info(\`succeeded in binding card. result: ${bindCardResult}\`);
      })
      .catch((error: BusinessError) => {
        // 绑卡失败
        console.error(\`failed to binding card, error.code: ${error.code}, error.message: ${error.message}\`);
      });
  }

  build() {
    Column() {
      Button('requestBindCardPromise')
        .type(ButtonType.Capsule)
        .width('50%')
        .margin(20)
        .onClick(() => {
          this.requestBindCardPromise();
        })
      }
    .width('100%')
    .height('100%')
  }
}