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

taobao.bus.tvmrefundorder.set (线下自助机逆向退款接口)

汽车票线下自助机 逆向退票接口;用于已出票完成后,再发起退款(注意这是售后退款,如出票异常但是告诉我们出票成功,后续给客户退款,需要调用这个接口,一般开放给财务。出票过程中的失败,请直接调用出票接口并且传递false标志,我们会自动退款。)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
alitrip_order_id String 必须 1000000001 飞猪订单号
refund_account_in_details RefundAccountInDetail [] 可选
  • 最大列表长度:20
  • 分账退款明细
    • └ alipay_account
    • String
    • 可选
    • 123456789
    • 收款账户支付宝ID 必传
    • └ alipay_account_id
    • String
    • 可选
    • xx@126.com
    • 收款装好支付宝账号,注意和上面的支付宝ID 要对应好
    • └ refund_amount
    • Number
    • 可选
    • 50
    • 分为单位;退多少钱
    • └ refund_batch_no
    • String
    • 可选
    • A_124
    • 退款批次号须唯一
    refund_amount Number 必须 100 退款金额(单位分)
    refund_reason String 可选 退款原因 退款原因
    refund_batch_no String 必须 A_124 批次号必须唯一,同一批次号只能退款一次 (多账号分润的该值 填写refundAccountInDetails中批次号的任意一个即可

    响应参数

    名称 类型 示例值 描述
    result_code String 9999 errorCode 错误码
    result_msg String 退款失败 errorMsg 错误信息
    is_success Boolean 是否成功 success true 成功 false 失败

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    BusTvmrefundorderSetRequest req = new BusTvmrefundorderSetRequest();
    req.setAlitripOrderId("1000000001");
    List<RefundAccountInDetail> list2 = new ArrayList<RefundAccountInDetail>();
    RefundAccountInDetail obj3 = new RefundAccountInDetail();
    list2.add(obj3);
    obj3.setAlipayAccount("123456789");
    obj3.setAlipayAccountId("xx@126.com");
    obj3.setRefundAmount(50L);
    obj3.setRefundBatchNo("A_124");
    req.setRefundAccountInDetails(list2);
    req.setRefundAmount(100L);
    req.setRefundReason("退款原因");
    req.setRefundBatchNo("A_124");
    BusTvmrefundorderSetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <bus_tvmrefundorder_set_response>
        <result_code>9999</result_code>
        <result_msg>退款失败</result_msg>
        <is_success>是否成功</is_success>
    </bus_tvmrefundorder_set_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

    返回
    顶部