文档中心 > API类目 > 电影票API

taobao.film.data.third.party.refund.order (退票接口)

淘票票第三方退票接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_id Number 必须 3714018795 淘宝账号ID,此ID是一串数字。可自行百度查看如何获取或者咨询淘票票技术人员提供
platform Number 必须 3 淘票票分配的渠道码
ext_user_id String 必须 222222222 退票身份ID,用于标识一个购票用户的身份,该参数需要跟锁座接口的ext_order_id参数一致,否则下单会失败。外部渠道需保证该参数的唯一性及准确性,下单出票接口会利用该参数做冥等性判断,如果由于外部渠道自身传入的参数有问题而导致的下单出票接口返回的结果有误,需要外部渠道自己承担损失
ext_order_id String 必须 111111111 退款时候需要传入第三方的订单号。外部渠道需保证该参数的唯一性和准确性
tb_order_id Number 必须 111111 下单时返回的淘宝订单号参数
refund_amount Number 必须 100 退款金额,以分为单位,为指定的退款订单的金额
refund_service_fee Number 必须 0 退款服务费,目前都为0
params Json 可选 {} 目前可以暂时不填参数

响应参数

名称 类型 示例值 描述
result ResultGeneralModel json result
  • └ return_message
  • String
  • 非法参数
  • 调用失败描述信息
  • └ return_code
  • String
  • 0
  • 0代表接口调用成功,其他值表示调用失败,错误信息可详见接口文档
  • return_value
  • TopRefundOrderStatus
  • json
  • returnValue
  • └ status
  • String
  • REFUNDING
  • 退款中,其他状态可详见接口文档
  • └ tb_order_id
  • String
  • 14234856846434949
  • tbOrderId
  • └ message
  • String
  • 退款中
  • message

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmDataThirdPartyRefundOrderRequest req = new FilmDataThirdPartyRefundOrderRequest();
req.setUserId(3714018795L);
req.setPlatform(3L);
req.setExtUserId("222222222");
req.setExtOrderId("111111111");
req.setTbOrderId(111111L);
req.setRefundAmount(100L);
req.setRefundServiceFee(0L);
req.setParamsString("{}");
FilmDataThirdPartyRefundOrderResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_data_third_party_refund_order_response>
    <result>
        <return_message>非法参数</return_message>
        <return_code>0</return_code>
        <return_value>
            <status>REFUNDING</status>
            <tb_order_id>14234856846434949</tb_order_id>
            <message>退款中</message>
        </return_value>
    </result>
</film_data_third_party_refund_order_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

返回
顶部