my.openkbvoucherdetail(object object)
小程序开发者工具： 不支持。 请使用真机调试
主体： 企业支付宝小程序 、 个人支付宝小程序
相关文档： 支付宝卡包产品介绍 、 my.openvoucherdetail
my.openvoucherdetail 打开支付宝卡包里的口碑券详情页。
有关支付宝卡包详细功能，可查看支付宝卡包产品介绍。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| passid | string | - | 是 | 口碑券实例 id，调用 alipay.pass.instance.add（卡券实例发放接口）可以获取该参数（如果传入了 partnerid 和 serialnumber 则不需传入）。 |
| partnerid | string | - | 是 | 商户编号，即商户 pid。 pid 即 partner id，是商家与支付宝签约后所获得的唯一识别码，由 16 位数字组成，以 2088 开头。 pid 的获取可查看文档：获取 pid（如果传入了 passid 则不需传入） |
| serialnumber | string | - | 是 | 序列号，调用 alipay.pass.instance.add（卡券实例发放接口）可以获取该参数（如果传入了 passid 则不需传入）。 |
| success | function | - | 否 | 调用成功的回调函数。 |
| fail | function | - | 否 | 调用失败的回调函数。 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行）。 |
传入 passid 打开券详情
传入 partnerid 和 serialnumber 打开券详情
传参为空或无效示例
传参无效示例
// 传入 passid 来打开券详情
my.openkbvoucherdetail({
passid: '20170921',
success: (res) => {
console.log('调用成功', res)
},
fail: (error) => {
console.log('调用失败', error)
}
});传参正确的示例图
// 传入 partnerid 和 serialnumber 打开券详情
my.openkbvoucherdetail({
partnerid: '2018xxxx',
serialnumber: '20231111',
success: (res) => {
console.log('调用成功', res)
},
fail: (error) => {
console.log('调用失败', error)
}
});my.openkbvoucherdetail({
passid: "",
success: (res) => {
console.log("调用成功", res);
},
fail: (error) => {
console.log("调用失败", error);
},
});
传参为空或无效示例
my.openkbvoucherdetail({
passid: "1234566",
success: (res) => {
console.log("调用成功", res);
},
fail: (error) => {
console.log("调用失败", error);
},
});
传参无效示例
- tip
当 passid/partnerid/serialnumber 传空或传错时,该 api 不会报错，而是打开错误展示页（参考示例代码中参数错误时的示例图）。使用时，请确保传入正确的 passid/partnerid/serialnumber 值。
- tip
此 api 只支持打开口碑券的详情页，若想打开非口碑券的详情页，请使用 my.openvoucherdetail 接口。