文档中心 > API类目 > 旅行用车API

alitrip.rentcar.seller.refund.submit (供应商提交退款)

此接口提供给api商家使用,api商家告知飞猪要退款哪个订单、退款多少钱、退款原因。飞猪来执行退款,接口会异步返回退款成功或失败接口,退款场景例如: 1. 用户跟商家协商退:用户和商家客服协商一致后, 2. 提前还车退款:用户发起提前还车,api商家调用接口告知因提前还车给用户退款的金额,飞猪执行退款。 3. 免押退款:适用于商家发起免押退款(比如线上扣了用户押金,线下用户已经交款需要把用户交的钱退给用户)。商家通知飞猪退款金额,飞猪执行退款。 4. 下单失败退款:适用于下单后,因风控拦截等原因下单失败,商家通知飞猪订单关单退款(此场景退全额,商家需要通知飞猪退全额)。 5. 其他类型退款:其他需要给用户退款的场景,商家通知飞猪要退款的金额,飞猪执行退款。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id String 必须 41049398192343324 飞猪订单号
refund_reason String 可选 退款原因 退款原因
refund_type Number 必须 1 1.协商退款 2.提前还车退款 3.免押退款 4.风控失败退款 101.其他
out_order_id String 必须 12312343 供应商订单号
extra Json 可选 {"test":"test"} 额外字段
refund_uniq_key String 必须 123123 供应商退款密等流水号(用户标记一次退款,相同流水号多次调用也只退一次)
refund_amount String 必须 23.23 退款金额单位元,保留两位小数

响应参数

名称 类型 示例值 描述
message_code Number 123 错误码
message String 错误信息 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripRentcarSellerRefundSubmitRequest req = new AlitripRentcarSellerRefundSubmitRequest();
req.setOrderId("41049398192343324");
req.setRefundReason("退款原因");
req.setRefundType(1L);
req.setOutOrderId("12312343");
req.setExtraString("{\"test\":\"test\"}");
req.setRefundUniqKey("123123");
req.setRefundAmount("23.23");
AlitripRentcarSellerRefundSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_rentcar_seller_refund_submit_response>
    <message_code>123</message_code>
    <message>错误信息</message>
</alitrip_rentcar_seller_refund_submit_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

返回
顶部