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

taobao.bus.agent.multiple.refund.confirm (综合交通多次退款接口)

此接口支持多次按照单客进行多次退款操作,只进行退款操作。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_agent_multiple_refund_r_q AgentMultipleRefundRq 必须 入参
  • └ agent_order_id
  • String
  • 必须
  • 333ffddddddd
  • 商家订单号
  • └ agent_refund_reason
  • String
  • 必须
  • 因***退款
  • 退款原因必填
  • └ agent_refund_trans_no
  • String
  • 必须
  • 202003290033030FFF
  • 退款流水号唯一标识,防止重复退款
  • └ main_biz_order_id
  • Number
  • 必须
  • 3340303000393
  • 飞猪平台订单号
  • refund_ticket_detail_list
  • AgentMultipleRefundTicketInfo []
  • 必须
  • 退款明细数据
  • └ agent_ticket_id
  • String
  • 可选
  • e3304043k
  • 商家票号(唯一标识关联乘客)
  • └ passenger_id_num
  • String
  • 可选
  • 154023939993939393993
  • 退款人证件号(无票号时此参数必填)
  • └ refund_amount
  • Number
  • 可选
  • 1000
  • 退票金额(分)
  • └ service_charge_refund_amount
  • Number
  • 可选
  • 300
  • 退服务费金额(分)
  • └ total_refund_amount
  • Number
  • 必须
  • 1300
  • 退款总金额(票款+服务费)(分)
  • └ total_service_charge_refund_amount
  • Number
  • 可选
  • 300
  • 退服务费总金额(分)
  • └ refund_scene
  • String
  • 可选
  • common:普通退款场景 force: 不可抗力
  • 选择不可抗力场景后飞猪平台会发送停运短信给用户
  • └ refund_scene_official_reason_code
  • String
  • 可选
  • 0:班次停运1:天气原因2:疫情原因
  • 通知用户停运原因

响应参数

名称 类型 示例值 描述
result_code String REFUND_ALREADY_DEAL_DONE 错误码
result_msg String 已完成退款 失败错误信息
is_success Boolean false 退款成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusAgentMultipleRefundConfirmRequest req = new BusAgentMultipleRefundConfirmRequest();
BusAgentMultipleRefundConfirmRequest.AgentMultipleRefundRq obj1 = new BusAgentMultipleRefundConfirmRequest.AgentMultipleRefundRq();
obj1.setAgentOrderId("333ffddddddd");
obj1.setAgentRefundReason("因***退款");
obj1.setAgentRefundTransNo("202003290033030FFF");
obj1.setMainBizOrderId(3340303000393L);
List<BusAgentMultipleRefundConfirmRequest.AgentMultipleRefundTicketInfo> list3 = new ArrayList<BusAgentMultipleRefundConfirmRequest.AgentMultipleRefundTicketInfo>();
BusAgentMultipleRefundConfirmRequest.AgentMultipleRefundTicketInfo obj4 = new BusAgentMultipleRefundConfirmRequest.AgentMultipleRefundTicketInfo();
list3.add(obj4);
obj4.setAgentTicketId("e3304043k");
obj4.setPassengerIdNum("154023939993939393993");
obj4.setRefundAmount(1000L);
obj4.setServiceChargeRefundAmount(300L);
obj1.setRefundTicketDetailList(list3);
obj1.setTotalRefundAmount(1300L);
obj1.setTotalServiceChargeRefundAmount(300L);
obj1.setRefundScene("common:普通退款场景 force: 不可抗力");
obj1.setRefundSceneOfficialReasonCode("0:班次停运1:天气原因2:疫情原因");
req.setParamAgentMultipleRefundRQ(obj1);
BusAgentMultipleRefundConfirmResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_agent_multiple_refund_confirm_response>
    <result_code>REFUND_ALREADY_DEAL_DONE</result_code>
    <result_msg>已完成退款</result_msg>
    <is_success>false</is_success>
</bus_agent_multiple_refund_confirm_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

返回
顶部