接口说明
会员在EZR微信H5页面进行积分兑换消耗或其它活动获得赠送积分后,实时将会员积分变动数据推送给第三方系统
1.积分增加
2.积分消耗
注:
1>第三方成功处理需要返回{"Status": true,"StatusCode": 200,…},见返回结果示例;
2>推送失败自动重试3次
3>因网络原因可能会造成重复推送,第三方系统需按照流水号进行去重判断
回调说明
返回数据格式:JSON
请求路径:callback(调用方提供支持POST方式的接口地址)
请求参数
指驿氪推送给第三方接口的数据格式
字段 | 类型 | 为空 | 描述 |
---|---|---|---|
Brand | string | 否 | 所属品牌编号 |
OldCode | string | 否 | 客户卡号 |
TransBonus | Int | 否 | 积分变动值:正数=赠送积分,负数=使用积分 |
TradeNo | string | 否 | 变动凭证:调用方的追朔日志记录代码,接收方需要按照该值做数据唯一性校验 |
RelationCode | string | 是 | 关联单号 |
TransOrigin | Int | 否 | 参考1206文档TransOrigin介绍 |
ChangeTime | string | 否 | 变动时间(yyyy-MM-dd HH:mm:ss格式) |
EffectDate | Int | 否 | 积分生效日期,yyyyMMdd格式,为0表示立即生效(此字段只有在增加积分时有效) |
ValidityDate | Int | 否 | 积分有效期,yyyyMMdd格式,为0表示永久有效(此字段只有在增加积分时有效) |
Remark | string | 是 | 描述 |
Bonus | int | 否 | 可用积分(仅供参考) |
返回示例代码(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对象):