客户优惠券核销

接口地址

/macan/coupon/directVerify

入参

字段说明

名称	类型	必填	示例	描述
idCustomer	Number	是	10545360219000304622	优惠券归属客户唯一标识
idCouponList	Number[]	是	[14038071, 14039392]	优惠券 ID，最多支持 20 个
idOwnOrg	Number	是	16011640498246656021	用券门店 ID。当优惠券非适用全部门店时，会校验优惠券在当前门店是否可用
orderId	Number	否	20241010000002	用券订单 ID
orderCode	String	否	"TSF20241010000002"	用券订单编码，最大长度 64

JSON示例

{
    "paramValues": [
        {
            "idCustomer": 10545360219000304622,
            "idCouponList": [14038071, 1307515],
            "idOwnOrg": 16011640498246656021,
            "orderId": 20241010000002,
            "orderCode": "TSF20241010000002"
        }
    ]
}

出参

字段说明

名称	类型	示例	描述
data	Boolean	true	优惠券核销结果，true 代表成功，false 代表失败
code	String	"4005"	优惠券核销错误码，当 data=false 时才需要关注该字段。 -1：核销失败 0：核销成功 4000：优惠券或部分优惠券不存在 4001：优惠券已删除 4002：优惠券状态不可用 4003：优惠券有效期未开始或已结束 4004：优惠券在当前门店不可用 4005：不能核销他人优惠券 9999：系统繁忙
message	String	"不能核销他人优惠券"	优惠券核销错误描述，当 data=false 时才需要关注该字段

JSON示例

{
    "code": 200,
    "data": {
        "data": false,
        "code": "4002",
        "message": "优惠券状态不可用: 1307515"
    },
    "message": "SUCCESS"
}