第三方系统根据此接口定义实现退款通知回调接口,并暴露成服务。
此接口用于预付订单买家申请退款通知第三方系统,仅通知一次(超时原因会重试3次),如果第三方系统因为各种原因未收到回调数据(比如:第三方服务重启),需要卖家在淘宝后台处理退款。注:此接口请求只作为退款通知申请,不会根据响应结果做退款处理。
名称 |
类型 |
是否必须 |
长度/取值 |
描述 |
示例值 |
Username |
String |
100 |
第三方系统接口调用需要校验时的用户名。 |
taobao |
|
Password |
String |
100 |
第三方系统接口调用需要校验时的密码 |
taobao |
|
CreateToken |
String |
必须 |
255 |
单次请求token |
taobao1387784033263-1387784033266 |
OrderId |
String |
|
100 |
OTA订单id,即第三方系统中的订单id |
21544874 |
TaoBaoOrderId |
long |
必须 |
|
taobao订单id |
524148745 |
Shipped |
String |
必须 |
|
是否发货,true为已发货,false为未发货 |
True/false |
示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> < OrderRefundRQ> < AuthenticationToken> <Username>taobao</Username> <Password>taobao</Password> <CreateToken>taobao1230123213-1387792484913</CreateToken> </AuthenticationToken> <OrderId>123456</OrderId> <TaoBaoOrderId>744607523450720</TaoBaoOrderId> <Shipped>false</Shipped> </OrderRefundRQ> |
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
否 |
300字 |
空 |
|
ResultCode |
String |
是 |
取值:0,-400 |
错误码 0表示成功 |
0 |
示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message></Message> <ResultCode>0</ResultCode> </Result> |
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
必须 |
300字 |
错误原因 |
查询失败 |
ResultCode |
String |
必须 |
取值:0,-400 |
错误码 |
-400 |
示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message>系统错误查询失败 </Message> <ResultCode>-300</ResultCode> </Result> |
以下是第三方接到退款申请请求后,处理成功或失败时应该返回的结果。此表已定义结果类型不会修改,但可能会根据业务情况进行增补。
ResultCode |
Message |
备注 |
0 |
处理成功 |
|
-400 |
处理失败 |
|