注:此服务只限于 已开通会员互通的直连商家使用。
第三方系统根据此接口定义实现会员查询回调接口(例如首住权益),并暴露成服务。
此接口用于会员试单和下单时进行会员首住权益的查询和新会员权益的查询
请求参数
名称 |
类型 |
是否必须 |
最大长度/取值范围 |
描述 |
示例值 |
Username |
String |
|
100 |
第三方系统接口调用需要校验时的用户名。 |
taobao |
Password |
String |
|
100 |
第三方系统接口调用需要校验时的密码 |
taobao |
CreateToken |
String |
必须 |
255 |
单次请求token |
taobao1387784033263-1387784033266 |
TaoBaoUserId |
long |
必须 |
|
Taobao用户ID |
524148745 |
DoctType |
String |
必须 |
|
证件类型 |
1 身份证 |
DoctNo |
String |
必须 |
|
证件号 |
42900519850101999X |
RightType |
String |
必须 |
|
权益类型 |
1 首住权益 2 新会员权益 |
Phone |
String |
必须 |
手机号 |
示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <QueryRightRQ> <AuthenticationToken> <Username>taobao</Username> <Password>taobao</Password> <CreateToken>taobao1230123213-1387792484913</CreateToken> </AuthenticationToken> <TaoBaoUserId >1230123213</TaoBaoUserId > <DoctType >1</DoctType > <DoctNo >42900519850101999X</DoctNo > <RightType>1</RightType> <Phone>15988888888</Phone> |
返回结果(成功)
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
否 |
300 |
空 |
|
ResultCode |
String |
是 |
取值:0 |
错误码 0表示成功 |
0 |
HasRight |
String |
是 |
取值:true / false |
是否有权益 |
true / false |
示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message></Message> <ResultCode>0</ResultCode> <HasRight>true</ HasRight > </Result> |
返回结果(失败)
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
必须 |
300 |
错误原因 |
内部错误 |
ResultCode |
String |
必须 |
取值 -400 |
错误码 |
-400 |
示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message>内部错误</Message> <ResultCode>-400</ResultCode> </Result> |
返回结果定义表
以下是第三方接到支付成功请求后,处理成功或失败时应该返回的结果。此表已定义结果类型不会修改,但可能会根据业务情况进行增补。
ResultCode |
Message |
备注 |
0 |
处理成功 |
|
-400 |
内部逻辑错误 |
|