接口说明
应用于会员在EZR微信H5页面开卡或完善个人资料后实时同步返回数据到第三方系统。
第三方系统接收到回调数据后需判断OldCode是否为空。 2.1 如果OldCode为空:进入开卡流程->根据接收到的回调数据中的手机号码去查找本地是否有相同手机号的会员。如果存在相同手机号码会员,按照交易记录找到最近会员,通过线下开卡接口传输到驿氪。 如果不存在相同手机号码会员,并将线下会员信息通过 线下开卡接口传输到驿氪。 2.2 如果OldCode不为空:进入会员资料修改流程(根据OldCode,对分销会员进行修改)
支持新增会员以及修改会员信息,会员在EZP微信H5页面开卡或完善个人资料后,可根据该接口实时同步返回数据给第三方系统。
注:
第三方成功处理需要返回{"Status": true,"StatusCode": 200,…},见返回结果示例;
推送失败将自动重试3次
只修改服务关系不触发1210,主动修改会触发服务关系变更接口推送1231
请求说明
请求方式:HTTP POST
返回数据格式:JSON
请求路径:callback(调用方提供支持POST方式的接口地址)
请求参数
指驿氪推送给第三方接口的数据格式
字段 类型 为空 长度 描述 Brand string 否 1~16 所属品牌编号 ChangeType string 否 1 C=开卡, U=修改资料, B=绑卡 (U,B pos都可理解为修改) OldCode string 否 1~20 客户卡号 Code string 否 1~20 Ezr卡号 EzrVipId long 是 0~20 Ezr会员id string 是 0~32 会员昵称 MobileNo string 是 0~11 手机号 Name string 是 0~20 会员姓名 Grade string 否 1~12 会员等级名称 Sex string 否 1 性别数据源:0=未知1=男2=女 PassWord string 是 0~64 会员密码 Birthday string 是 0~10 生日(yyyy-M-d格式) WxNo string 是 0~32 用户微信OpenID WxUnionId string 是 0~32 用户微信UnionID WxCode string 是 0~16 微信卡卡号 WeibNo string 是 0~32 微博号 QqNo string 是 0~20 Qq号 TbNo string 是 0~32 淘宝号 Email string 是 0~32 邮箱地址 RegShop string 否 1~16 开卡门店编码 RegDate string 否 10 开卡日期(yyyy-MM-dd格式) RegTime string 否 19 开卡时间(yyyy-MM-dd HH:mm:ss) ServShop string 是 0~16 服务门店编码 ServUser string 是 0~16 服务导购编码 ServUserName string 服务导购名称 Province string 是 0~64 省份(名称) City string 是 0~64 城市(名称) County string 是 0~64 区县(名称) TaobaoNick string 是 0~50 淘宝Nick InviteVipCode string 是 0~20 邀请会员Ezr卡号 InviteVipOldCode string 是 0~20 邀请会员客户卡号 InviteVipMobileNo string 是 0~11 邀请会员手机号 RegSaler string 是 0~11 开卡导购 OldBindDate string 是 0~19 绑卡时间(yyyy-MM-dd HH:mm:ss) Refereeoldcode string 推荐人线下卡号(弃用) Refereevipcode string 推荐人卡号(弃用) RefereeVipMobileNo string 推荐人手机号(弃用) AddressInfo AddressInfo 收货信息 OpenCardPlatform string 开卡平台(微信\Pos\支付宝等) AddressInfo
字段 类型 描述 RecvProvince string 收货省 RecvCity string 收货市 RecvCounty string 收货区 RecvAddress string 收货人详细地址 RecvCountry string 收货国
请求参数示例代码(json对象数组)
{
"OldCode": "EZ00001230",
"Code": "0000081",
"NickName": "小桂子",
"MobileNo": "18988888888",
"Name": "刘桂",
"Grade": "普通会员",
"Sex": "1",
"PassWord": "",
"Birthday": "1982-10-17",
"WxNo": "",
"WxUnionId": "",
"WeibNo": "",
"QqNo": "",
"TbNo": "",
"Email": "12345678@qq.com",
"RegShop": "HQS0001",
"RegDate": "2015-05-17",
"Province": "",
"City": "",
"County": "",
"AddressInfo": { "RecvProvince": "省", "RecvCity": ""市, "RecvCounty": "区", "RecvAddress": "详细地址", "RecvCountry": "国家" }
}
系统级返回结果示例(json)
指第三方接口需要返回的结果格式
{
"Status": true,
"StatusCode": 200,
"Msg": "成功",
"Timestamp": "20150622093101",
"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
"Result": 见业务返回结果示例,
}
业务返回结果示例(json):