易知课堂

Appearance

快速导航

查询退款订单列表 ​

调用方式 ​

POST https://app-api.yizhiknow.com/open-api/orderList/v2

请求头 ​

Content-Type:application/json

请求参数 ​

参数类型长度必填说明
access_tokenstring是凭证，非body参数
pageint否页码
page_sizeint否每页返回条数，最大支持100，默认20
typeint是2退款订单
platformstring否默认全部平台 kt抖音课堂 kskt快手课堂 wxkt微信课堂
out_trade_nostring否内部订单号
trade_nostring否支付单号
out_refund_nostring否退款单号
phonestring否手机号
refund_time_startstring否退款时间开始时间：2022-07-14 00:00:00
refund_time_endstring否退款时间结束时间：2022-07-15 00:00:00
spread_idint否推广号id

日期查询说明 ​

  • 日期字段查询必须同时存在或消失，结束日期必须晚于开始日期，且跨度不能超过31天

请求参数示例 ​

json
{
  "page": 1,
  "page_size": 20,
  "type": 1,
  "refund_time_start": "2022-07-14 00:00:00",
  "refund_time_end": "2022-07-15 00:00:00",
  "platform":"kt",
  "out_trade_no": "40443537063313111111",
  "out_refund_no": "50443537063313111111",
  "trade_no": "2022071222001448281459111111",
  "phone": "12345678901",
  "spread_id": 1
}

返回参数 ​

参数类型长度必填说明
codeint是错误码
msgstring是错误描述
dataobject是

data ​

参数类型长度必填说明
current_pageint是当前页码
per_pageint是每页条数
totalint是总数
data[object]是业务数据

data 业务数据 ​

参数类型长度必填说明
platformstring是订单平台类型 kt：抖音课堂 kskt：快手课堂 wxkt：微信课堂
infoobject是退款订单数据
curriculumobject是课程数据
userobject是下单用户数据
pay_timestring是支付时间：2022-08-26 18:24:50
pay_amountstring是下单金额
refund_timestring是退款时间：2022-08-26 18:24:50
spread_idint是推广号id

info 订单数据 ​

参数类型长度必填说明
out_trade_nostring是内部订单号
trade_nostring是支付单号
out_refund_nostring是退款单号
refund_amountstring是退款金额

curriculum 课程数据 ​

参数类型长度必填说明
curriculum_idint是课程id
titlestring是课程名称
second_categoryint是二级类目

user 下单用户数据 ​

参数类型长度必填说明
user_idint是用户id
nicknamestring是用户名称
phonestring是手机号

返回参数示例 ​

json
{
    "code": 200,
    "msg": "成功！",
    "data": {
        "current_page": 1,
        "per_page": 20,
        "total": 1,
        "data": [
            {
                "spread_id": 1,
                "pay_amount": "1.00",
                "pay_time": "2022-07-14 16:10:10",
                "refund_time": "2023-03-17 14:40:43",
                "info": {
                    "out_trade_no": "40405457685346611200",
                    "trade_no": "2022071222001448281458744854",
                    "out_refund_no": "502303171439331233",
                    "refund_amount": "39.99"
                },
                "user": {
                    "user_id": 7446005,
                    "nickname": "传奇呀",
                    "phone": "18355920059"
                },
                "curriculum": {
                    "curriculum_id": 4105,
                    "title": "【周教练】科目1234全套驾校VIP技巧速记（电子版资料无需快递）",
                    "second_category": 70500
                },
                "platform": "kt"
            }
        ]
    }
}

错误码 ​

错误码描述
200成功
98710101无效 AccessToken
98710102缺少凭证
98710103凭证无效或过期
98710406日期跨度超出限制