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

taobao.bus.agent.returnticket.confirm (商家回调退票)

商家通过TOP接口调用来回传退票状态

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_agent_confirm_return_r_q AgentConfirmReturnRq 可选 退票入参
  • └ agent_order_id
  • String
  • 必须
  • A380
  • 商家单号
  • └ agent_return_ticket_status
  • Number
  • 必须
  • 1
  • 退票结果 1-成功 2-失败
  • └ agent_return_ticket_type
  • Number
  • 必须
  • 0
  • 退票类型 0-按票退 1-按单退
  • └ agent_ticket_id
  • String
  • 可选
  • B737
  • 按票退 时的票号
  • └ come_from
  • String
  • 可选
  • agentX
  • 调用方表示
  • └ passenger_name
  • String
  • 可选
  • 张三
  • 按票退 时的乘客姓名
  • └ refund_amount
  • String
  • 可选
  • 10.0
  • 参考退款金额(以实际为准)
  • └ isign
  • String
  • 可选
  • ""
  • 签名
  • └ success_time
  • Date
  • 可选
  • 2018-07-01 07:07:07
  • 退票成功时间点

响应参数

名称 类型 示例值 描述
result_code String PARAM_CHECK_LACK_TICKET_ID 错误码
result_msg String 按票退款缺少票号 错误描述
is_success Boolean false 是否确认成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusAgentReturnticketConfirmRequest req = new BusAgentReturnticketConfirmRequest();
BusAgentReturnticketConfirmRequest.AgentConfirmReturnRq obj1 = new BusAgentReturnticketConfirmRequest.AgentConfirmReturnRq();
obj1.setAgentOrderId("A380");
obj1.setAgentReturnTicketStatus(1L);
obj1.setAgentReturnTicketType(0L);
obj1.setAgentTicketId("B737");
obj1.setComeFrom("agentX");
obj1.setPassengerName("张三");
obj1.setRefundAmount("10.0");
obj1.setIsign("\"\"");
obj1.setSuccessTime(StringUtils.parseDateTime("2018-07-01 07:07:07"));
req.setParamAgentConfirmReturnRQ(obj1);
BusAgentReturnticketConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_agent_returnticket_confirm_response>
    <result_code>PARAM_CHECK_LACK_TICKET_ID</result_code>
    <result_msg>按票退款缺少票号</result_msg>
    <is_success>false</is_success>
</bus_agent_returnticket_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

返回
顶部