小程序开放平台

文档中心
API 简介
登录
接口调用凭证
小程序码与链接
小程序基础信息
本地担保交易能力
业务接入流程
API列表
商品-获取信息
商品-批量获取信息
商品同步-生活服务
专业号主页商品排序
sku商品-批量删除
sku商品-批量上架
sku商品-批量下架
订单新增
订单-状态同步
获取订单支付token
担保支付订单-获取订单信息
凭证核销
预约单状态同步
发起预约
售后单-新增
同步售后单状态
获取售后订单详情
查询结算
结算咨询
结算明细查询
查询核销信息
通用担保交易能力
电商担保交易能力
地点管理能力
客服能力
群聊能力
小说能力
短剧能力
服务组件能力
直播能力

[交易组件]查询结算

开发
>
服务端 API
>
本地担保交易能力
>
API列表
>
查询结算
>
更新时间:2025-05-22 21:15:31

支持第三方调用

支持沙箱环境调用

禁止个人开发者调用

只支持直连支付

请求地址

POST https://miniapp.xiaohongshu.com/api/rmp/mp/deal/query_settle

公共请求参数

名称
类型
是否必须
描述
app_idstring小程序appid
access_tokenstring小程序调用凭证

业务请求参数

名称
类型
是否必须
描述
out_settle_idstring外部结算单id

请求示例

{
    "out_settle_id":"string"
}

响应参数

名称
类型
是否必须
描述
data
struct
settle_status
string状态,success 成功,processing 进行中
settle_id
string小红书流水id
out_settle_id
string外部流水id
settle_time
int64实际结算时间,对账以这个为准,需要服务商保存,时间戳精确到(秒)
settle_info
struct结算详情
commission_amount
int64技术服务费,单位(分)
commission_info
struct技术服务费详情,单位(分)
red
int64小红书分成技术服务费,单位(分)
service_provider
int64服务商分成技术服务费,单位(分)
cps_commission_amount
int64cps(达人)带货服务费,单位(分)
settle_product_amount
int64结算商品金额
cps_infos
list_struct带货信息
name
stringcps 名称(达人带货昵称)
rate
int64分账(退)比例,单位为万分之一
amount
int64分账(退)金额 = 带货总佣金 * 分账(退)比例,单位(分)
out_sku_id
string外部 sku 商品id
out_sku_name
string外部 sku 商品名称
cps_type
int32带货方式
cps_infos
list_struct分佣详情
name
stringcps 名称(达人带货昵称)
rate
int64分账(退)比例,单位为万分之一
amount
int64分账(退)金额 = 带货总佣金 * 分账(退)比例,单位(分)
out_sku_id
string外部 sku 商品id
out_sku_name
string外部 sku 商品名称
cps_type
int32带货方式
successbool是否成功
msgstring说明,正确响应时为 success,错误响应时为错误描述
codeint32错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "data":{
        "settle_status":"string",
        "settle_id":"string",
        "out_settle_id":"string",
        "settle_time":0,
        "settle_info":{
            "commission_amount":0,
            "commission_info":{
                "red":0,
                "service_provider":0
            },
            "cps_commission_amount":0,
            "settle_product_amount":0,
            "cps_infos":[
                {
                    "name":"string",
                    "rate":0,
                    "amount":0,
                    "out_sku_id":"string",
                    "out_sku_name":"string",
                    "cps_type":0
                }
            ]
        },
        "cps_infos":[
            {
                "name":"string",
                "rate":0,
                "amount":0,
                "out_sku_id":"string",
                "out_sku_name":"string",
                "cps_type":0
            }
        ]
    },
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码