淘宝开放平台

登录
文档中心 > API类目 > 国际机票运价采购

alitrip.ie.ticket.service.buyer.applyrefund (买家提交退票申请)

商户作为买家可以通过top接口提交退票申请

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
passenger_name String 必须 www/xxx 乘机人姓名
reason String 必须 飞机晚点无法起飞 申请退票的具体原因
trace_id String 必须 11111111111 接口的tracerId
apply_type Number 必须 0 自愿申请:0,非自愿退票(不可抗力):1,自愿退票（我要改变行程计划、我不想飞）:2,自愿退票（填错名字、选错日期、选错航班）:3,自愿退票（生病了无法乘机（无二甲医院证明））:4,非自愿退票（航班延误或取消、航班时刻变更等航司原因）:5,非自愿退票（身体原因且有二级甲等医院<含>以上的医院证明）:6,非自愿退票（旅客拒签或其他不可抗力因素）:7
order_id Number 必须 23678654367 退票所属的正向订单id

响应参数

名称 类型 示例值 描述
result ApplyRefundTicketRs applyRefundTicketRS
  • └ refund_apply_id
  • Number
  • 228794254
  • 退票申请单id
  • └ error_code
  • String
  • 2
  • 错误信息
  • └ error_msg
  • String
  • 无错误
  • errorMsg
  • └ success
  • Boolean
  • true
  • 退票结果

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripIeTicketServiceBuyerApplyrefundRequest req = new AlitripIeTicketServiceBuyerApplyrefundRequest();
req.setPassengerName("www/xxx");
req.setReason("飞机晚点无法起飞");
req.setTraceId("11111111111");
req.setApplyType(0L);
req.setOrderId(23678654367L);
AlitripIeTicketServiceBuyerApplyrefundResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
<alitrip_ie_ticket_service_buyer_applyrefund_response>
    <result>
        <refund_apply_id>228794254</refund_apply_id>
        <error_code>2</error_code>
        <error_msg>无错误</error_msg>
        <success>true</success>
    </result>
</alitrip_ie_ticket_service_buyer_applyrefund_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部