帮助中心

1211-EZR积分流水下发

2021-08-20

接口编号 1211

接口说明

会员在EZR微信H5页面进行积分兑换消耗或其它活动获得赠送积分后,实时将会员积分变动数据推送给第三方系统

1.积分增加

2.积分消耗

注:

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

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

3>网络原因可能会造成重复推送,第三方系统需按照流水号进行去重判断

回调说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

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

请求参数

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


字段类型为空描述
Brandstring所属品牌编号
OldCodestring客户卡号
TransBonusInt积分变动值:正数=赠送积分,负数=使用积分
TradeNostring变动凭证:调用方的追朔日志记录代码,接收方需要按照该值做数据唯一性校验
RelationCodestring关联单号
TransOriginInt参考1206文档TransOrigin介绍
ChangeTimestring变动时间(yyyy-MM-dd HH:mm:ss格式)
EffectDateInt积分生效日期,yyyyMMdd格式,为0表示立即生效(此字段只有在增加积分时有效)
ValidityDateInt积分有效期,yyyyMMdd格式,为0表示永久有效(此字段只有在增加积分时有效)
Remarkstring描述
Bonusint可用积分(仅供参考)


返回示例代码(json对象)

{

  "OldCode": "000008",

  "TransBonus": -100,

  "TradeNo": "T00001",

  "ChangeTime": "2015-11-01 12:30:01",

  "Remark": "积分换券",

  "EffectDate": 20100101,

  "ValidityDate ": 20100105,

  “Bonus”:1

}

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

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

{

  "Status": true,

  "StatusCode": 200,

  "Msg": "成功",

  "Timestamp": "20150622093101",

  "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",

  "Result": 见业务返回结果示例,

}

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

第三方自定义返回内容


7726