帮助中心

1206-Member points update (external to EZR)

2020-12-03

Scenario

This API is only needed if external system store member data and needs to sync it with EZR.

Member's points change in external system, external system will update changes to EZR


Direction

External system will call EZR

Call path: api/cvip/vipbonusset


Core Logic

Repeated records will be ignored


Request Parameters

Field

Type

Required

Length

Description

OldCode

string

At least 1 of   3 is required

1~16

Member's   unique code (external system)

Code

string

1~16

Member's   unique code (in EZR)

WxOpenID

string

0~32

Member’s   WeChat OpenID

TransBonus

Int

Yes


positive -   add
  negetive - deduct

TradeNo

string

Yes

 1~20

Transaction   record, used to trace back and prevent duplication

ChangeTime

string

Yes


Time when   change happens
  yyyy-MM-dd HH:mm:ss

EffectDate

int



Date when   points are available to redeem
  yyyy-MM-dd
  0 = immediately
  This field is only valid when points are added

ValidityDate

int

Yes


Expiration   date of points
  yyyy-MM-dd
  0 = permanently
  This field is only valid when points are added

TransOrigin

int



Reason of   points change
  1=initial points
  2=purchasing (offline)
  5=redeem
  7=purchasing return (offline)
  9=alternation
  13=add
(不传或小于等于0,默认值)
  15=deduct(不传或小于等于0,默认值)
  50=purchasing (website)
  51=purchasing return (website)
  52=purchasing (JD,Tmall,Taobao)
  53=purchasing return (JD,Tmall,Taobao)

Remark

string

Yes

 1~32

Will be used   in WeChat template message

 

Example Request (JSON)

{

    "OldCode": "EZ00001230",

    "Bonus": 100,

    "BonusTotal": 1000,

    "TransBonus": -100,

    "TradeNo": "T00001",

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

    "Remark": "积分换券",

    "EffectDate": 20100101,

    "ValidityDate ": 20100105,

}   "Remark": "线上手工调整",

 

Example Return by EZR (JSON)

{

    "Status": true,

    "StatusCode": 200,

    "Msg": "成功",

    "Timestamp": "20150622093101",

    "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",

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

}


2078