抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 代运营
  • 团购退款
  • 抖音码核销后退款审批
  • 售后单详情查询
  • 抖音码退款申请通知
  • 退款单列表查询
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 退款单列表查询

    收藏
    我的收藏

    接口说明

    使用场景:

    通过接口查询指定范围的退款单列表:

    1、查询指定状态的退款单列表,用于核对逆向订单或差异单最新状态确认;

    2、查询指定退款单详情,用于接口补偿处理;


    使用方式:

    服务商通过接口查询订单详情,支持三种查询方式:

    (1)根据订单状态和商户 id,查询指定退款单创建时间内该商户下的退款单列表,入参:商户 id、订单状态、创单起止时间;

    (2)根据订单状态和商户 id,查询指定退款单完成时间内该商户下的退款单列表,入参:商户 id、订单状态、退款完成起止时间;

    使用限制

    1、接口只能保证准实时(数据平均延时 2s 可查到最新状态,负载较高时 p99 可达 min 级别),建议用于实时性不高的统计类查询。

    2、单页查询最大 100 条

    指标

    数值

    可承载最大qps

    200

    单个开发者限流

    10QPS

    响应耗时pct99

    1s

    服务目标可用性

    99.9%

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/goodlife/v1/akte/after_sale/order/query/
    HTTP Method
    GET
    Scope
    life.capacity.catering_after_sale_order

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    固定值"application/json"
    Query展开全部子属性
    account_id必填String
    商户ID,响应参数仅返回该商户ID的账单信息,不支持树级结构查询(入参总店账户ID,不会返回分店收款的账户数据)
    page_size必填Int32
    页大小,取值范围1~100
    create_order_end_timeInt64
    退款创单结束时间(秒时间戳,创单起止时间必须同时传入)
    create_order_start_timeInt64
    退款创单起始时间(秒时间戳,创单起止时间必须同时传入)
    cursorString
    查询游标,第一页查询传0,翻页查使用上一次查询返回cursor
    refund_done_end_timeInt64
    退款完成起始时间(秒时间戳,修改起止时间必须同时传入)
    refund_done_start_timeInt64
    退款完成起始时间(秒时间戳,修改起止时间必须同时传入)
    refund_statusEnum
    初始化 INIT=9;审核中 AUDITING=10;已审核 AUDITED=20;已拒绝 REJECTED=25;平台仲裁 ARBITRATE=30;取消退款 CANCEL=40;退款成功 SUCCESS=50;退款失败 FAIL=59
    展开子属性
    请求示例
    curl --location --request GET '/goodlife/v1/akte/after_sale/order/query/?account_id=sJTcu9tqhl&page_size=6867180929198489063&refund_status=1&create_order_start_time=6200195535920907065&create_order_end_time=3378106340340952438&refund_done_start_time=1365711909184163051&refund_done_end_time=730555438693202053&cursor=lCa8Nrr1d0' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \

    响应参数

    Body展开全部子属性
    dataStruct
    展开子属性
    extraStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "data": { "cursor": "c45AiWN7Gm", "has_more": false, "after_sale_order_list": [ { "status": 1, "user_refund_amount": 853201324127883900, "after_sale_id": "L7p2YdJE06", "order_id": "QC9woBKnkK", "create_time": 4476526864228789000, "reject_reason": "asBXFzZmYe", "order_type": 298527037821671400, "user_deduct_fee_amount": 3575190906430856000, "real_refund_amount": 8003522701172058000, "deduct_fee_amount": 7269866378770614000, "update_time": 7360656677823337000, "audit_time": 7083066525311184000, "refund_type": 7157211458919387000, "audit_result": "KtBGh3xZdL", "market_deduct_fee_amount": 2000776212456336600, "trade_type": 2134501481065970400, "refund_amount": 6691642869639914000, "out_refund_payment_id": "cugzMuO3PO", "reason": { "reason_code": [ 7045162331222579000 ], "desc": "ugMYDCQ4y3", "show_reason": [ { "reason_code": 6331690959913961000, "msg": "HT3ZVX9hzy" } ] }, "merchant_account_id": 4197010930186701300, "total_refund_amount": 1720892424897253600, "refund_info_list": [ { "market_refund_amount": 4034224588673075000, "times_card_refund_info_list": [ { "deduct_fee_amount": 2261933493995814700, "platform_market_amount": 5868566366116695000, "serial_number": 3799693836802107400, "refund_amount": 1210433464329160400, "marketing_amount": 942601413769923200, "user_deduct_fee_amount": 1474120903735620400, "platform_market_deduct_fee_amount": 6002900401540442000, "origin_amount": 7964937464678845000, "user_amount": 6529701015442235000 } ], "market_deduct_fee_amount": 2011444928217820200, "refund_id": "qXDWMjYlIs", "certificate_id": "dS793cixKJ", "deduct_fee_amount": 7605072069276279000, "platform_market_refund_amount": 6185583458309400000, "total_refund_amount": 6129986125219023000, "order_item_id": "HS4o15RA5e", "user_refund_amount": 4388396309898983400, "real_refund_amount": 9108881242268622000, "user_deduct_fee_amount": 8481326409929657000, "code": "JLaG2MTLgD", "platform_market_deduct_fee_amount": 5162593513021638000, "refund_status": 1 } ], "complete_time": 1901865044521915000, "out_biz_after_sale_id": "LaxPdhqVNz", "market_refund_amount": 8860562151927634000 } ], "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202412051117509BFD1D4685CFEB7A5359", "now": 1733368670 } }

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2002100001
    未知错误
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100004
    系统繁忙,此时请开发者稍候再试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100005
    参数不合法
    更换参数
    2002190002
    access_token无效
    调用接口重新生成access_token
    2002190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    2002190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    2002119001
    参数不合法
    更换参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2004000001
    根据实际业务错误返回
    补充参数
    2004000002
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    2005000001
    服务器打瞌睡了,请稍后再试。
    2003000001
    以实际错误信息为准