# 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,
})
}
})
注:请严格遵循以下使用方式:
- 使用「支付渠道列表组件」
a. 「支付渠道列表组件」初始化成功,则需要在预下单(参考预下单接口文档)及
ks.pay
接口处提供相应的 paymentChannel 参数 b. 「支付渠道列表组件」初始化失败,则在预下单(参考预下单接口文档)及ks.pay
接口无需提供paymentChannel 参数,ks.pay
会 fallback 到默认的拉起收银台的方式 - 未使用,则在预下单(参考预下单接口文档)及
ks.pay
接口无需提供paymentChannel 参数,ks.pay
会 fallback 到默认的拉起收银台的方式