帮助中心

1211-EZR积分流水下发

2020-08-03

接口编号 1211

接口说明

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

1.积分增加

2.积分消耗

注:

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

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

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

回调说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

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

请求参数

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


字段类型为空描述
Brandstring所属品牌编号
OldCodestring客户卡号
TransBonusInt积分变动值:正数=赠送积分,负数=使用积分
TradeNostring变动凭证:调用方的追朔日志记录代码,接收方需要按照该值做数据唯一性校验
RelationCodestring关联单号
TransOriginInt积分变更来源:1=初始积分;2=交易送积分-线下;3= 赠送积分;4=N倍积分;5=积分兑换;6=积分抵现;7=交易退积分-线下;8=绑定旧卡的积分;9=调整积分;10=抽奖;11=邀请有礼;12=积分兑礼;13=接口赠送;15=接口消耗;16=分享活动送积分;17=活动浏览送积分;18=批量赠送积分;20=商城商品兑换;30=会员特权赠送;50=交易送积分-线上商城;51=交易退积分-线上商城;52=交易送积分-三方商城,京东天猫等;53=交易退积分-三方商城,京东天猫; 54=积分兑礼退积分;56=线下积分抵扣;100=交易评论赠送积分
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对象):

第三方自定义返回内容


4831