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

taobao.bus.ticket.refund (汽车票退票-分销)

汽车票-退票

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_refund_ticket_rq TopRefundTicketRq 必须 退票参数
  • └ refundable_amount
  • Number
  • 可选
  • 7300
  • 退款总金额
  • └ refund_fee
  • Number
  • 可选
  • 800
  • 退票手续费
  • └ refundable_ticket_price
  • Number
  • 可选
  • 7200
  • 退票款金额
  • tickets
  • TicketInfo []
  • 必须
  • 票列表
  • └ refundable_amount
  • Number
  • 可选
  • 7300
  • 退款总金额
  • └ refund_fee
  • Number
  • 可选
  • 800
  • 退票手续费
  • └ service_charge
  • Number
  • 可选
  • 200
  • 服务费
  • └ refundable_ticket_price
  • Number
  • 可选
  • 7200
  • 退票款金额
  • └ ticket_price
  • Number
  • 可选
  • 8000
  • 票价
  • └ ticket_no
  • String
  • 可选
  • 123456
  • 票号
  • └ ticket_type
  • Number
  • 可选
  • 0
  • 票种类型
  • └ refundable_service_price
  • Number
  • 可选
  • 100
  • 退服务费金额
  • └ rider_name
  • String
  • 可选
  • 张三
  • 乘客姓名
  • └ rider_cert_type
  • String
  • 可选
  • 身份证
  • 乘客证件类型
  • └ sub_alitrip_order_id
  • String
  • 必须
  • 123456
  • 飞猪子订单号
  • └ rider_cert_number
  • String
  • 可选
  • 123456
  • 乘客证件号码
  • └ alitrip_order_id
  • String
  • 必须
  • 123456
  • 飞猪订单号
  • └ refundable_service_price
  • Number
  • 可选
  • 100
  • 退服务费金额

响应参数

名称 类型 示例值 描述
alitrip_order_id String 123456 飞猪订单号
is_biz_success Boolean true 退票是否成功
status Number 1 退款状态
refundable_amount Number 7300 退款总金额
refundable_ticket_price Number 7200 退票款金额
refund_fee Number 800 退票手续费
refundable_service_price Number 100 退服务费金额
result_code String SYS_ERROR 错误码
result_msg String 系统异常 错误信息
is_success Boolean true 接口调用是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusTicketRefundRequest req = new BusTicketRefundRequest();
BusTicketRefundRequest.TopRefundTicketRq obj1 = new BusTicketRefundRequest.TopRefundTicketRq();
obj1.setRefundableAmount(7300L);
obj1.setRefundFee(800L);
obj1.setRefundableTicketPrice(7200L);
List<BusTicketRefundRequest.TicketInfo> list3 = new ArrayList<BusTicketRefundRequest.TicketInfo>();
BusTicketRefundRequest.TicketInfo obj4 = new BusTicketRefundRequest.TicketInfo();
list3.add(obj4);
obj4.setRefundableAmount(7300L);
obj4.setRefundFee(800L);
obj4.setServiceCharge(200L);
obj4.setRefundableTicketPrice(7200L);
obj4.setTicketPrice(8000L);
obj4.setTicketNo("123456");
obj4.setTicketType(0L);
obj4.setRefundableServicePrice(100L);
obj4.setRiderName("张三");
obj4.setRiderCertType("身份证");
obj4.setSubAlitripOrderId("123456");
obj4.setRiderCertNumber("123456");
obj1.setTickets(list3);
obj1.setAlitripOrderId("123456");
obj1.setRefundableServicePrice(100L);
req.setTopRefundTicketRq(obj1);
BusTicketRefundResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_ticket_refund_response>
    <alitrip_order_id>123456</alitrip_order_id>
    <is_biz_success>true</is_biz_success>
    <status>1</status>
    <refundable_amount>7300</refundable_amount>
    <refundable_ticket_price>7200</refundable_ticket_price>
    <refund_fee>800</refund_fee>
    <refundable_service_price>100</refundable_service_price>
    <result_code>SYS_ERROR</result_code>
    <result_msg>系统异常</result_msg>
    <is_success>true</is_success>
</bus_ticket_refund_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

返回
顶部