小程序开放平台

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

[交易组件]结算明细查询

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

支持第三方调用

支持沙箱环境调用

禁止个人开发者调用

不支持直连支付

请求地址

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

公共请求参数

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

业务请求参数

名称
类型
是否必须
描述
order_idstring否指定订单查询
seller_idstring否当前商家
settle_start_timeint64否结算开始时间
settle_start_toint64否结算结束时间
page_numint32否当前页
page_sizeint32否每页数量
settle_biz_typeint32否结算类型
common_settle_statusint32否结算状态

请求示例

{
    "order_id":"string",
    "seller_id":"string",
    "settle_start_time":0,
    "settle_start_to":0,
    "page_num":0,
    "page_size":0,
    "settle_biz_type":0,
    "common_settle_status":0
}

响应参数

名称
类型
是否必须
描述
data
struct否
size
int32是总数量
order_settles
list_struct是结算明细
settle_type
string是结算对象
transaction_settle_status
string是0:不需要结算,1:初始化,2:可结算,3:结算中,4:已结算,5:结算失败,6:结算冲抵
settled_time
int64是结算时间
settle_biz_type
string是0:正向,1:逆向
goods_amount
string是结算金额,对应货款金额
platform_discount
string是平台优惠
commission_amount
string是平台佣金
pay_channel_amount
string是支付渠道费
cps_amount
string是分销佣金
service_commission_amount
string是服务商佣金
transaction_id
int64是结算id
package_id
string是订单号
statement_type
int32是结算方式,0:订单,2:履约单
transaction_biz_type
int32是0:售卖,1:取消,2:退款,3:售后
delivery_id
string是履约单id
transaction_biz_no
string是结算业务单号
return_id
string是returnId
order_time
int64是订单时间
can_settle_time
int64是可结算时间
predictable_settle_time
string是预结算时间
erqing_type
int32是结算账户:0(店铺余额) 2(微信) 1(支付宝)
common_settle_status
int32是结算状态:0(未结算) 1(已结算)
amount
string是动账金额,实际结给商家的钱
pay_amount
string是支付金额
app_promotion
string否---
freight_amount
string否---
no_freight_reason
string否---
tax_amount
string否---
no_tax_reason
string否---
freight_tax_amount
string否---
no_freight_tax_reason
string否---
no_pay_channel_reason
string否---
installment_amount
string否---
no_installment_reason
string否---
extra_amount
string否---
no_extra_reason
string否---
calculate_remark
string否---
settle_record_no
string否---
voucher_code
string否券码
poi_id
string否核销poi(orderId点查才有)
poi_name
string否核销门店名称(orderId点查才有)
ext_order_id
string否三方订单号
settle_zone
string否结算区域
verify_time
string否核销时间
page_num
int32是当前页数
total_page
int32是总共的页数
page_size
int32是每页数量
successbool否是否成功
msgstring否说明,正确响应时为 success,错误响应时为错误描述
codeint32否错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "data":{
        "size":0,
        "order_settles":[
            {
                "settle_type":"string",
                "transaction_settle_status":"string",
                "settled_time":0,
                "settle_biz_type":"string",
                "goods_amount":"string",
                "platform_discount":"string",
                "commission_amount":"string",
                "pay_channel_amount":"string",
                "cps_amount":"string",
                "service_commission_amount":"string",
                "transaction_id":0,
                "package_id":"string",
                "statement_type":0,
                "transaction_biz_type":0,
                "delivery_id":"string",
                "transaction_biz_no":"string",
                "return_id":"string",
                "order_time":0,
                "can_settle_time":0,
                "predictable_settle_time":"string",
                "erqing_type":0,
                "common_settle_status":0,
                "amount":"string",
                "pay_amount":"string",
                "app_promotion":"string",
                "freight_amount":"string",
                "no_freight_reason":"string",
                "tax_amount":"string",
                "no_tax_reason":"string",
                "freight_tax_amount":"string",
                "no_freight_tax_reason":"string",
                "no_pay_channel_reason":"string",
                "installment_amount":"string",
                "no_installment_reason":"string",
                "extra_amount":"string",
                "no_extra_reason":"string",
                "calculate_remark":"string",
                "settle_record_no":"string",
                "voucher_code":"string",
                "poi_id":"string",
                "poi_name":"string",
                "ext_order_id":"string",
                "settle_zone":"string",
                "verify_time":"string"
            }
        ],
        "page_num":0,
        "total_page":0,
        "page_size":0
    },
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码