文档中心 > API类目 > 火车票API

taobao.train.agent.returnticketinfo.get.vtwo (代理商获取退票详情回调)

代理商获取退票详情回调

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
agent_id Number 必须 123 代理商id
sub_order_id Number 必须 123 淘宝子订单号
main_order_id Number 必须 123 淘宝主订单号

响应参数

名称 类型 示例值 描述
offline_refund_type Number 10 退票类型:10:跑腿退
certificate_url_list String [] url1,url2 证件照图片列表
sub_order_id Number 123 淘宝子订单号
main_order_id Number 123 淘宝主订单号
offline_return Boolean true 是否线下票退票
certificate_type Number 10:身份证(需要2张照片) 20:护照(需要1张) 30:港澳居民来往内地通行证(需要2张照片) 40:台湾居民来往内地通行证(需要2张照片) 50:外国人永久居留证(需要2张照片) 60:港澳台居民居住证(需要2张照片) 证件类型
result_msg String 主单号为空 错误信息
is_success Boolean true 查询返回状态
result_code String isv.error 错误码
vip_errand_return_price Number 123 线下票跑腿费
refund_deadline String 2021-09-23 11:00:00 退票处理截止时间
attribute String 123 预留字段

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TrainAgentReturnticketinfoGetVtwoRequest req = new TrainAgentReturnticketinfoGetVtwoRequest();
req.setAgentId(123L);
req.setSubOrderId(123L);
req.setMainOrderId(123L);
TrainAgentReturnticketinfoGetVtwoResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<train_agent_returnticketinfo_get_vtwo_response>
    <offline_refund_type>10</offline_refund_type>
    <certificate_url_list>
        <string>url1</string>
        <string>url2</string>
    </certificate_url_list>
    <sub_order_id>123</sub_order_id>
    <main_order_id>123</main_order_id>
    <offline_return>true</offline_return>
    <certificate_type>10:身份证(需要2张照片) 20:护照(需要1张) 30:港澳居民来往内地通行证(需要2张照片) 40:台湾居民来往内地通行证(需要2张照片) 50:外国人永久居留证(需要2张照片) 60:港澳台居民居住证(需要2张照片)</certificate_type>
    <result_msg>主单号为空</result_msg>
    <is_success>true</is_success>
    <result_code>isv.error</result_code>
    <vip_errand_return_price>123</vip_errand_return_price>
    <refund_deadline>2021-09-23 11:00:00</refund_deadline>
    <attribute>123</attribute>
</train_agent_returnticketinfo_get_vtwo_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部