Skip to main content

【聚合类】激活卡券并插卡包

基本信息

接口名称:激活卡券并插卡包(标准分支特有功能)状  态:已完成
接口路径:POST /paas/micro/voucherwallet/activeVoucher更新时间:2024-08-26 23:42:19
Mock地址:https://apimock.e-buychina.com/mock/77/paas/micro/voucherwallet/activeVoucher

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json

Body:

参数名称类型必填默认值备注其他信息
uuidstringuuid最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring应用id最大长度:50
最小长度:1
Mock:@string
actionstring交易名称最大长度:50
最小长度:1
Mock:activeVoucher
timestampnumber请求时间戳Mock:@timestamp
signTypestring签名类型最大长度:50
最小长度:1
Mock:sha_256
signstring签名值最大长度:50
最小长度:1
Mock:@natural
contentobject请求体
  voucherCodestring券码最大长度:50
最小长度:1
  phoneNumberstring手机号最大长度:50
最小长度:1
  shopNostring核销门店最大长度:50
最小长度:1
Mock:99990
langstring

返回数据

参数名称类型必填默认值备注其他信息
uuidstringuuid最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
actionstring交易名称最大长度:50
最小长度:1
Mock:activeVoucher
contentobject响应报文
  cardListarray结构同voucherList
  voucherListarray用户券列表
    remainTimesnumber剩余可用次数Mock:@integer
    voucherStatusDescstring卡券状态描述最大长度:50
最小长度:1
Mock:@string
    voucherNamestring券名称最大长度:50
最小长度:1
Mock:@string
    totalTimesnumber总次数Mock:@integer
    validEndTimestring卡券有效期结束时间最大长度:50
最小长度:1
Mock:@datetime
    voucherCodestring券码最大长度:50
最小长度:1
Mock:@string
    productTypestring产品类型最大长度:50
最小长度:1
Mock:Voucher
    createDatenumber创建时间Mock:@datetime
    validStartTimestring卡券有效期开始时间最大长度:50
最小长度:1
Mock:@datetime
    createBystring创建人最大长度:50
最小长度:1
Mock:@string
    voucherStatusstring卡券状态最大长度:50
最小长度:1
Mock:@string
    faceValuenumber面值
    voucherExtendstring卡券扩展字段最大长度:50
最小长度:1
  totalCountnumber总数Mock:1
successboolean是否成功Mock:@boolean
errorCodestring错误码最大长度:50
最小长度:1
Mock:@natural
errorMessagestring错误信息最大长度:50
最小长度:1
timestampnumber响应时间戳Mock:@timestamp
signTypestring
signstring

备注

请求示例:

{
  "content": {
    "phoneNumber": "176******",
    "voucherCode": "10032870698162*****"
  },
  "uuid": "20240731-jtgkrdtjeuwkzqbddesdjnxqjvebaysl",
  "appId": "ebuy0a0fd74341cc",
  "action": "activeVoucher",
  "timestamp": 1722413869,
  "signType": "sha_256",
  "sign": "4789268584454036",
  "lang": "est eiusmod"
}

响应示例:

{
  "uuid": "20240731-jtgkrdtjeuwkzqbddesdjnxqjvebaysl",
  "action": "activeVoucher",
  "content": {
    "cardList": [],
    "voucherList": [
      {
        "remainTimes": 1,
        "voucherStatusDesc": "可使用",
        "voucherName": "照烧鸡三明治三件套",
        "phoneNumber": "176*******",
        "totalTimes": 1,
        "validEndTime": "20241028235959",
        "voucherCode": "1003287069816******",
        "productType": "Voucher",
        "createDate": 1722418903000,
        "validStartTime": "20240731000000",
        "createBy": "system",
        "voucherStatus": "00",
        "faceValue": 36,
        "voucherExtend": "{\"ticketDetail\":{\"paymentParam\":{\"discountCode\":\"F069|2\",\"tenderCode\":\"P116|34\",\"goods\":[{\"quantity\":\"\",\"price\":\"\",\"goodsId\":\"5021006\",\"goodsName\":\"\"}]},\"supportNextDayCancel\":\"Y\",\"skuList\":[\"5031005\"],\"voucherType\":\"merchandiseCoupon\",\"netValue\":\"34.00\",\"voucherImage\":\"\",\"shopWhiteList\":[\"73011\",\"99990\"],\"faceValue\":\"36.00\",\"supportSameDayCancel\":\"Y\",\"useDesc\":\"\"}}"
      }
    ],
    "totalCount": 1
  },
  "success": true,
  "errorCode": "",
  "errorMessage": "",
  "timestamp": 1722500968954,
  "signType": "sha256",
  "sign": "486e1ef7c6c2c12aeef9e42c6c65fde90a269709b0063b71de64738863e473fc"
}

其中voucherExtend中ticketDetail字段相关含义如下:
supportVerify: true/false 门店是否可用
supportNextDayCancel:是否支持隔日退
supportSameDayCancel:是否支持当日退
faceValue:面值
netValue:净值
minLimit:门槛金额(有则返回)
discountAmount:折扣金额(有则返回)
weekTimes:可用时间段(JSONArray有则返回)
/*
* 可用时间段
* times: 000000235959(前六位是开始时间, 后6位是结束时间)
* weekDay: 0011000(周日周一周二周三周四周五周六,0:不可用, 1:可用)
*/
cityBlackList: 城市黑名单列表(有则返回)
cityWhiteList: 城市白名单列表(有则返回)
shopBlackList:门店黑名单列表(有则返回)
shopWhiteList:门店白名单列表(有则返回)
voucherType: 券类型(约定值,示例:product表示产品券)
skuList:可用商品列表
defaultGoodsId: 多组n选1套餐(示例:“defaultGoodsld":"110507,110508,11509|124138,123103,123204"表示A组商品:110507110508,110509二选1,B组商品:124138,123103,123204选1)

变更历史

变更日期变更内容
2024-08-26
2024-08-01
2024-08-01
2024-07-31
2024-07-31
2024-07-31
2024-07-31
api-id=37218