智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
paymentService (鸿蒙支付服务)
Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+
本文导读
本模块提供支付、签约服务能力，包括基础支付、支付并签约、合单支付、签约代扣等。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 4.1.0(11)
导入模块
- import { paymentService } from '@kit.PaymentKit';
PayResult
Phone5.0.2(14)+PC/2in15.0.2(14)+Tablet5.0.2(14)+
用户在通用收银台选择支付方式并确认支付后的支付信息。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.2(14)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 5.0.2(14)
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| selectedPaymentType | string | 否 | 是 | 用户选择的支付方式。 - wechat_pay：微信支付 - ali_pay：支付宝支付 - 其他（其他为商户申请配置三方支付方式时所申请的相关配置） - wechat_pay_sdk：微信支付 - ali_pay_sdk：支付宝支付 - 其他（其他为商户申请配置三方支付方式时所申请的相关配置） |
| clientToken | string | 否 | 是 | 客户端凭证。用于校验调用方信息。 |
| nextStep | string | 否 | 是 | 下一步支付流程。 |
| extraInfo | string | 否 | 是 | 保留字段。json string格式。示例为{"selectPayType":"wechat_pay"}。 |
| payload | string | 否 | 是 | 预留信息，在请求接口时，入参如果传递，接口响应中则会原样返回。 说明： 拉起H5支付场景下需要固定传递“AP”。 |
PaymentInfo
Phone5.0.2(14)+PC/2in15.0.2(14)+Tablet5.0.2(14)+
三方支付拉起通用收银台时传入的支付订单信息。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.2(14)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 5.0.2(14)
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| tradeSummary | string | 否 | 是 | 订单的摘要信息。若未填写，默认为空。 |
| amount | number | 否 | 是 | 订单总金额，必须为大于0的整数值，单位：分。传递非取值范围内的值会导致请求异常。 |
| currency | string | 否 | 是 | 货币单位。若未填写，默认为空。 说明： - 不传递则收银台不显示货币单位。 - 传递后收银台可以转换成货币符号则显示货币符号（比如￥），转换不了则显示所传递的值。 |
| extraInfo | string | 否 | 是 | 保留字段。json string格式。若未填写，默认为空。 说明： 商户可以通过保留字段指定支付方式。指定收银台支付方式列表传递内容示例为{"selectPayType":"wechat_pay|xxx"}。 |
PickerResult
Phone5.0.2(14)+PC/2in15.0.2(14)+Tablet5.0.2(14)+
三方支付拉起通用收银台时响应给开发者的订单支付信息。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.2(14)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 5.0.2(14)
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| selectedPaymentType | string | 否 | 是 | 用户选择的支付方式。 - wechat_pay：微信支付 - ali_pay：支付宝支付 - 其他（其他为商户申请配置三方支付方式时所申请的相关配置） - wechat_pay_sdk：微信支付 - ali_pay_sdk：支付宝支付 - 其他（其他为商户申请配置三方支付方式时所申请的相关配置） |
| clientToken | string | 否 | 是 | 客户端凭证。用于校验调用方信息。 |
BindCardResult
Phone5.0.5(17)+PC/2in15.0.5(17)+Tablet5.0.5(17)+
绑卡结果信息。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.5(17)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 5.0.5(17)
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| hasBankCard | boolean | 否 | 否 | 用户当前是否有已绑定的银行卡。 - true：是 - false：否 |
| hasJustBoundCard | boolean | 否 | 是 | 用户在拉起绑卡管理页面后是否完成了绑卡。 - true：是 - false：否 |
requestPayment
Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+
requestPayment(context: common.UIAbilityContext, orderStr: string): Promise<void>
该方法提供基础支付、支付并签约等功能，调用方法前请确保网络已连接，调用该方法后会拉起Payment Kit收银台，支付完成后使用Promise异步回调。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 4.1.0(11)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | 是 | UIAbility上下文，不传会报401参数错误。 |
| orderStr | string | 是 | 拉起收银台传入的订单信息，orderStr是json字符串的格式。不传会报401参数错误。示例为{"app_id":"","merc_no":"","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<void> | Promise对象，无返回结果。 |
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930001 | Pay failed. |
| 1001930002 | The transaction has been processed. |
| 1001930010 | Duplicate request. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息。
- import { paymentService } from '@kit.PaymentKit';
- import { common } from '@kit.AbilityKit';
-
- @Entry
- @Component
- struct Index {
- context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
- requestPaymentPromise() {
- // 请使用开发者真实的订单信息（orderStr）
- const orderStr = '{"app_id":"***","merc_no":"***","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}';
- paymentService.requestPayment(this.context, orderStr)
- .then(() => {
- // 支付成功
- console.info('succeeded in paying');
- });
- }
-
- build() {
- Column() {
- Button('requestPaymentPromise')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestPaymentPromise();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
requestPayment
Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+
requestPayment(context: common.UIAbilityContext, orderStr: string, callback: AsyncCallback<void>): void
该方法提供基础支付、支付并签约等功能，调用该方法前请确保网络已连接，调用该方法后会拉起Payment Kit收银台，支付完成后使用callback异步回调。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
起始版本： 4.1.0(11)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | 是 | UIAbility上下文，不传会报401参数错误。 |
| orderStr | string | 是 | 拉起收银台传入的订单信息，orderStr是json字符串的格式。不传会报401参数错误。示例为{"app_id":"","merc_no":"","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}。 |
| callback | AsyncCallback<void> | 是 | 回调函数。当支付成功，err为undefined，否则为错误对象。 |
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930001 | Pay failed. |
| 1001930002 | The transaction has been processed. |
| 1001930010 | Duplicate request. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息
- 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;
- requestPaymentCallBack() {
- // 请使用开发者真实的订单信息（orderStr）
- const orderStr = '{"app_id":"***","merc_no":"***","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}';
- paymentService.requestPayment(this.context, orderStr, (error: BusinessError) => {
- if (error) {
- // 支付失败
- console.error(`failed to pay, error.code: ${error.code}, error.message: ${error.message}`);
- return;
- }
- // 支付成功
- console.info('succeeded in paying');
- });
- }
-
- build() {
- Column() {
- Button('requestPaymentCallBack')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestPaymentCallBack();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
requestContract
Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+
requestContract(context: common.UIAbilityContext, contractStr: string): Promise<void>
该方法提供签约功能，调用方法前请确保网络已连接，调用该方法后会拉起Payment Kit签约收银台，签约完成后使用Promise异步回调。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
设备行为差异： 该接口在Phone、Tablet、2in1设备中可正常调用，在其他设备中返回801错误码。
起始版本： 5.0.0(12)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | 是 | UIAbility上下文，不传会报401参数错误。 |
| contractStr | string | 是 | 拉起签约收银台入参，contractStr是json字符串的格式。不传会报401参数错误。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<void> | Promise对象，无返回结果。 |
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930002 | The transaction has been processed. |
| 1001930003 | Withhold failed. |
| 1001930010 | Duplicate request. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息
- import { paymentService } from '@kit.PaymentKit';
- import { common } from '@kit.AbilityKit';
-
- @Entry
- @Component
- struct Index {
- context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
- requestContractPromise() {
- // 请使用开发者真实的入参信息（contractStr）
- const contractStr = '{"appId":"***","preSignNo":"***"}';
- paymentService.requestContract(this.context, contractStr)
- .then(() => {
- // 签约成功
- console.info('succeeded in signing');
- });
- }
-
- build() {
- Column() {
- Button('requestContractPromise')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestContractPromise();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
requestContract
Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+
requestContract(context: common.UIAbilityContext, contractStr: string, callback: AsyncCallback<void>): void
该方法提供签约功能，调用该方法前请确保网络已连接，调用该方法后会拉起Payment Kit签约收银台，签约完成后使用callback异步回调。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
设备行为差异： 该接口在Phone、Tablet、2in1设备中可正常调用，在其他设备中返回801错误码。
起始版本： 5.0.0(12)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | 是 | UIAbility上下文，不传会报401参数错误。 |
| contractStr | string | 是 | 拉起签约收银台入参，contractStr是json字符串的格式。不传会报401参数错误。 |
| callback | AsyncCallback<void> | 是 | 回调函数。当签约成功，err为undefined，否则为错误对象。 |
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930002 | The transaction has been processed. |
| 1001930003 | Withhold failed. |
| 1001930010 | Duplicate request. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息
- 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;
- requestContractCallBack() {
- // 请使用开发者真实的回调函数（contractStr）
- const contractStr = '{"appId":"***","preSignNo":"***"}';
- paymentService.requestContract(this.context, contractStr, (error: BusinessError) => {
- if (error) {
- // 签约失败
- console.error(`failed to sign, error.code: ${error.code}, error.message: ${error.message}`);
- return;
- }
- // 签约成功
- console.info('succeeded in signing');
- });
- }
-
- build() {
- Column() {
- Button('requestContractCallBack')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestContractCallBack();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
requestPayment
Phone5.0.2(14)+PC/2in15.0.2(14)+Tablet5.0.2(14)+
requestPayment(context: common.UIAbilityContext, orderStr: string, payload: string): Promise<PayResult>
该方法提供拉起通用收银台、跳转三方支付功能，调用方法前请确保网络已连接，用户在通用收银台选择支付方式并确认支付后，使用Promise异步回调。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.2(14)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
设备行为差异： 该接口在Phone、Tablet、2in1设备中可正常调用，在其他设备中返回801错误码。
起始版本： 5.0.2(14)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | 是 | UIAbility上下文，不传会报401参数错误。 |
| orderStr | string | 是 | 拉起收银台或跳转三方支付传入的订单信息。 orderStr是json字符串的格式，不传会报401参数错误。示例为{"app_id":"","merc_no":"","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}。 |
| payload | string | 是 | 预留信息，在请求接口时，入参如果传递，接口响应中则会原样返回。 说明： 拉起华为支付收银台，需传空或空字符。H5支付场景下跳转三方支付收银台需要固定传递“AP”。 |
返回值：
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930001 | Pay failed. |
| 1001930002 | The transaction has been processed. |
| 1001930010 | Duplicate request. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息
- import { paymentService } from '@kit.PaymentKit';
- import { common } from '@kit.AbilityKit';
-
- @Entry
- @Component
- struct Index {
- context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
- requestPaymentPromise() {
- // 请使用开发者真实的订单信息（orderStr）支付订单。
- // 订单信息示例参考'{"app_id":"***","merc_no":"***","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}'
- // 请使用开发者真实的订单信息（orderStr）跳转到第三方支付。
- const orderStr = '{"nextAction":"L","linkUrl":"","scheme":"","clientToken":"***"}';
- paymentService.requestPayment(this.context, orderStr, 'AP')
- .then((payResult: paymentService.PayResult) => {
- // 支付成功
- console.info('succeeded in paying, pay result: ', payResult);
- });
- }
-
- build() {
- Column() {
- Button('requestPaymentPromise')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestPaymentPromise();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
cashierPicker
Phone5.0.2(14)+PC/2in15.0.2(14)+Tablet5.0.2(14)+
cashierPicker(context: common.UIAbilityContext, paymentInfo: PaymentInfo): Promise<PickerResult>
该方法提供拉起通用收银台功能，调用方法前请确保网络已连接，用户在通用收银台选择支付方式并确认支付后，使用Promise异步回调。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.2(14)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
设备行为差异： 该接口在Phone、Tablet、2in1设备中可正常调用，在其他设备中返回801错误码。
起始版本： 5.0.2(14)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | 是 | UIAbility上下文，不传会报401参数错误。 |
| paymentInfo | PaymentInfo | 是 | 拉起通用收银台传入的支付信息。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<PickerResult> | Promise对象。带PickerResult返回结果的Promise对象。 |
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930001 | Pay failed. |
| 1001930002 | The transaction has been processed. |
| 1001930010 | Duplicate request. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息
- import { paymentService } from '@kit.PaymentKit';
- import { common } from '@kit.AbilityKit';
-
- @Entry
- @Component
- struct Index {
- context: common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext;
- requestCashierPicker() {
- // 请使用开发者真实的支付信息（paymentInfo）
- const paymentInfo: paymentService.PaymentInfo = {
- tradeSummary: '***交易',
- amount: 100,
- currency: 'CNY',
- extraInfo: '{"***":"***"}'
- }
- paymentService.cashierPicker(this.context, paymentInfo)
- .then((pickerResult: paymentService.PickerResult) => {
- // 支付成功
- console.info('succeeded in paying, picker result: ', pickerResult);
- });
- }
-
- build() {
- Column() {
- Button('requestCashierPicker')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestCashierPicker();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
requestBindCard
Phone5.0.5(17)+PC/2in15.0.5(17)+Tablet5.0.5(17)+
requestBindCard(context: common.UIAbilityContext | common.UIExtensionContext): Promise<BindCardResult>
该方法提供用户绑卡功能，调用该方法后会拉起Payment Kit用户绑卡页面，绑卡完成后使用Promise异步回调。调用方法前请确保网络已连接。
模型约束： 此接口仅可在Stage模型下使用。
元服务API： 从版本5.0.5(17)开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Payment.PaymentService
设备行为差异： 该接口在Phone、Tablet、2in1设备中可正常调用，在其他设备中返回801错误码。
起始版本： 5.0.5(17)
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| context | common.UIAbilityContext | common.UIExtensionContext | 是 | UIAbility上下文，不传会报401参数错误。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<BindCardResult> | Promise对象。带BindCardResult返回结果的Promise对象。 |
错误码：
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error.Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
| 801 | Capability not supported. Failed to call the API due to limited device capabilities. |
| 1001930000 | The operation was canceled by the user. |
| 1001930011 | Network connection error. |
示例：
示例中的context的获取方式请参见获取UIAbility的上下文信息
- 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}`);
- });
- }
-
- build() {
- Column() {
- Button('requestBindCardPromise')
- .type(ButtonType.Capsule)
- .width('50%')
- .margin(20)
- .onClick(() => {
- this.requestBindCardPromise();
- })
- }
- .width('100%')
- .height('100%')
- }
- }
在 API参考 中进行搜索
请输入您想要搜索的关键词