帮助中心

1217-券核销信息推送

2021-11-17

接口编号 1217

接口说明

1.场景:会员在EZP系统核销券后,可根据该接口实时推送券核销状态给第三方系统

2.该调用由驿氪发起,支持错误重试3次

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

注:

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

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

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:callback(调用方提供支持POST方式的接口地址)

请求参数


字段类型为空长度描述
Brandstring
1~16所属品牌
Codestring
1~40券号码
OldCodestring

线下卡号
OrderCodestring
0~26关联订单号,网络问题ezr可能多次调用核销接口,请按照单号确定是否 成功。即如果 俩次单号相同,即使是已经核销 也要返回核销成功
ConsumeTimestring
1~19核销时间(yyyy-MM-dd HH:mm:ss格式)
ConsumeShopstring
0~16核销门店
OrigSystemstring
0~16券发放来源系统
OutSysIdint
1-1通用,-2线上券,大于0其它


请求参数示例代码(json对象)

{  
  "Code": "EZ00001230",
  "OrderCode": "0000123001",
  "ConsumeTime": "2016-09-28 10:13:30",    
}


系统级返回结果示例(json)

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

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

业务返回结果示例(json对象):

第三方自定义返回内容


6658