帮助中心
进入EZR

1219-优惠券变更推送

2021-11-17

接口编号 1219

接口说明

1.场景：优惠券转赠推送，券属会员变动后的同步回调；其它基础信息在券发放后不会变动；

2.该调用由驿氪发起，同步回调支持错误重试3次

3.调用方提供支持POST方式的接口地址

4.支持退单券（状态1），禁用券、转增券、锁定券、券释放

5.需要会员存在线下卡号才触发推送

注：

       1>第三方成功处理需要返回{ "Status": true, "StatusCode": 200, ... }，见返回结果示例；

       2>推送失败自动重试3次。

       3>IsAvailable只能判断转增，禁用，用到锁定，释放，根据coupStatus判断。

       4> coupStatus包含  IsAvailable和UnLock场景。

请求说明

  • HTTP请求方式：POST

  • 返回数据格式：JSON

  • 请求路径：callback（调用方提供支持POST方式的接口地址）

请求参数

指驿氪推送给第三方接口的数据格式




字段类型为空长度描述
Brandstring
1~16所属品牌
CoupNostring
1~18券号码
VipCodestring
1~20线下卡号
CoupTypeint

券类型：1=品牌代金券；2=品牌折扣券；3=品牌促销券；4=礼品券；5=邀请券；10=异业券
ChangeTimestring
19变动时间(yyyy-MM-dd HH:mm:ss格式)
IsAvailablebool

是否可用(true:券转增;false:禁用券) ，弃用
ChangeRemarkstring

状态变更描述
coupStatusint

券当前状态1正常（转赠）2已锁定4已禁用8已核销11释放锁定券
UnLockbool
1true:(释放券)false:(非释放券)，弃用
BegDatestring

有效开始日期
EndDatestring

有效结束日期
BeforeVipCodestring

转增前/分享人线下卡号




请求参数示例代码（json对象）

{  
 "Brand": "EZ",
 "CoupNo": "EZ00001230",
 "VipCode": "0000123001",
 "ChangeTime": "2016-09-28 10:13:30",     
}


系统级返回结果示例（json）

指第三方接口需要返回的结果格式

{
 "Status": true,
 "StatusCode": 200,
 "Msg": "成功",
 "Timestamp": "20150622093101",
 "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
 "Result": 见业务返回结果示例,
}

业务返回结果示例（json对象）：

第三方自定义返回内容



5946