# ks.pay

发起担保支付。详见 担保支付接入指南

# pay(originOptions: PayOptions): Promise<void>

# 参数

参数 类型 必填
originOptions PayOptions

# PayOptions

属性
属性 类型 必填 说明
serviceId string 服务类型 id(固定值为 '1'
orderInfo PaymentOrderInfo 订单数据
paymentChannel PaymentChannel 支付渠道信息(来自 <payment-list> 组件)
success (result: void) => void 接口调用成功的回调函数
fail (error: APIError) => void 接口调用失败的回调函数
complete (resultOrError: void | APIError) => void 接口调用结束的回调函数(调用成功、失败都会执行)
PaymentOrderInfo
属性
属性 类型 必填 说明
order_no string 订单号
order_info_token string 订单 token
PaymentChannel
属性
属性 类型 必填 说明
provider string 通道类型
provider_channel_type string 金融渠道的通道类型

# 返回值

# Promise<void>

# 使用方式

Page({
    data: {
        payment: {
            provider: '',
            provider_channel_type: '',
        },
    },
    async pay() {
        const paymentChannel = this.data.payment;
        // 执行预下单逻辑
        await this.doPreOrder(payment);
        // 执行支付
        ks.pay({
            serviceId,
            orderInfo,
            paymentChannel,
            success,
            fail,
        })
    }
})

注:请严格遵循以下使用方式:

  1. 使用「支付渠道列表组件」 a. 「支付渠道列表组件」初始化成功,则需要在预下单(参考预下单接口文档)及 ks.pay 接口处提供相应的 paymentChannel 参数 b. 「支付渠道列表组件」初始化失败,则在预下单(参考预下单接口文档)及 ks.pay 接口无需提供paymentChannel 参数,ks.pay 会 fallback 到默认的拉起收银台的方式
  2. 未使用,则在预下单(参考预下单接口文档)及 ks.pay 接口无需提供paymentChannel 参数,ks.pay 会 fallback 到默认的拉起收银台的方式
Copyright ©2024, All Rights Reserved