帮助中心

Member points inquiry

2020-12-03

Scenario

External system needs to get a member’s available points from EZR.


Direction

External system will call EZR

Call path: api/cvip/vipbonusget


Core Logic

Only single member at a time


Request Parameters

Field

Type

Required

Length

Description

OldCode

string

at least
  1 of 5
  is filled

1~16

Member's   unique code (external system)

Code

string

1~16

Member's   unique code (in EZR)

MobileNo

string

0~11

Member's   Mobile number

WxNo

string

0~32

Member’s   WeChat OpenID

WxUnionId

string

0~32

Member’s   WeChat UnionID

 

Returned Parameters

Field

Type

Length

Description

OldCode

string

1~16

Member's   unique code (external system)

Code

string

1~16

Member's   unique code (in EZR)

MobileNo

string

0~11

Member's   Mobile number

Bonus

int


Member's   available points

BonusTotal

int


Member's   total points (including used/expired)

Trans

JSON

-

Points   records

 

field of “Trans”:

Field

Type

Length

Description

TransOrigin

string


Transaction   reason

TransId

string


Points   transaction ID

TransVal

Int


Points value

TransDate

string


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

EffectDate

string


Time when   points will take effect
  yyyy-MM-dd HH:mm:ss

ExpiredExcTime

string


Time when   points will expire
  yyyy-MM-dd HH:mm:ss

 

Example Request (JSON)

{

    "OldCode": "EZ00001230",

    "Code": "",

"MobileNo": "",

“Trans”:”TRUE”

}


Example Returned Result (JSON)

{

    "OldCode": "EZ00001230",

    "Code": "Ez00001230",

    "MobileNo": "18988888888",

    "Bonus": 100,

    "BonusTotal": 100,

    "Trans": [{

        "TransOrigin": "1 ",

        "TransId": "ezp1232101 ",

        "TransVal": 100,

        "TransDate": "2016-10-11 12:20:30 ",

        "EffectDate": " 2016-10-11 12:20:30 ",

        "ExpiredExcTime": " 2016-10-11 12:20:30 "

    }, {

        ......

    }]

}


 


1642