# dcb.chooseCoupon
客户端 6.1.0 开始支持,低版本需做兼容处理。
调起优惠券选择弹窗 -> 选择可用的优惠券。
# 参数
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
amount | number | 是 | 订单金额(元)。 | 6.1.0 | |
goodsIds | Array<string | Object> | 是 | 商品 ID 列表,支持 JSON 字符串。 | 6.1.0 | |
selectedCouponId | string | 否 | 初始选中的优惠券 ID。 | 7.0.0 | |
unitOrgCode | Array<string> | 否 | 优惠券支持的机构。 | 7.1.0 | |
businessType | string | 否 | 优惠券支持的业务类型。 | 7.1.0 |
# 返回值
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
couponId | string | 优惠券 ID | |
couponName | string | 优惠名称 | |
couponType | number | 优惠类型:1=满减券,2=折扣券,3=兑换券,4=随机金额券 | |
denomination | string | 抵扣金额/折扣数/兑换 | |
discountedAmt | number | 优惠金额 | |
endTime | string | 有效结束日期 | |
minPointAmt | string | 门槛金额 | |
nearExpire | number | 是否即将过期,0-否,1-是 | |
remarks | string | 备注说明 | |
scope | string | 适用范围 | |
status | number | 状态:1=可用券,2=已过期,3=已作废,4=退回可用,5=已使用,6=订单冻结中 | |
useTimeType | number | 优惠券可用时间 | |
useTimeVal | string | 优惠券可用时间值 | |
payAmt | number | 支付金额 |
# 示例
const res = await dcb.chooseCoupon({
amount: 10,
goodsIds: ['122333'],
});
// 结果类似:
// {
// "couponId": "8a8a893075d3e7160175d40e316a0005",
// "couponName": "兑换优惠券",
// "couponType": 3,
// "denomination": "兑换",
// "discountedAmt": 0,
// "endTime": "有效期至:2020/11/30",
// "minPointAmt": "",
// "nearExpire": 0,
// "remarks": "无门槛(备注)",
// "scope": "全部商品",
// "status": 1,
// "useTimeType": 3,
// "useTimeVal": "周一、周二、周三、周四、周五、周六、周日 09:00-12:00 可用<br/>周一、周二、周三、周四、周五、周六、周日 13:00-24:00 可用",
// "validEndTime": "2020-11-30T23:59:59"
// }