小程序开放平台

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

[交易组件]结算咨询

开发
>
服务端 API
>
本地担保交易能力
>
API列表
>
结算咨询
>
更新时间:2025-08-05 11:18:46

支持第三方调用

支持沙箱环境调用

只支持直连支付

请求地址

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

公共请求参数

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

业务请求参数

名称
类型
是否必须
描述
order_idstring指定订单查询

请求示例

{
    "order_id":"string"
}

响应参数

名称
类型
是否必须
描述
data
struct
size
int32总数量
settle_info_details
list_struct结算明细
transaction_settle_status
string结算状态:1 -待结算;2-结算中;3-已结算;4-结算失败;5-正逆冲抵无需结算
settled_time
string结算时间戳(毫秒)
settle_biz_type
string交易类型:0:结算入账,1:退款分账(核销后退款会产生退款分账数据)
goods_amount
string商品实付/实退,单位分
platform_discount
string平台优惠,单位分(非商家承担的实际补贴,指平台券、津贴等)
commission_amount
string平台佣金,单位分,平台佣金=(商品实付+平台优惠)*费率-返利激励
pay_amount
string结算金额,单位分(参与分账的总金额)
cps_amount
string分销佣金,单位分(指推广给达人的分销佣金)
service_commission_amount
string服务商佣金,单位分(指分账给服务商的佣金)
package_id
string小红书订单id
amount
string动账金额,单位分(即商家最终入账金额)
voucher_code
string核销的券码code(本地担保支付有,若为通用担保支付,则没有券码的概念,该字段值为空)
poi_id
string核销的门店id(本地担保支付有,若为通用担保支付,则没有核销门店的概念,该字段值为空)
poi_name
string核销的门店名称(本地担保支付有,若为通用担保支付,则没有核销门店的概念,该字段值为空)
ext_order_id
string三方订单id
settle_zone
string结算对象:集团、门店、区域
verify_time
string核销完成/订单完成时间戳,毫秒(通用担保支付为订单状态到达已完成的时间,本地担保支付为券码核销完成时间
develop_service_commission_amount
string技术服务商佣金
successbool是否成功
msgstring说明,正确响应时为 success,错误响应时为错误描述
codeint32错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "data":{
        "size":0,
        "settle_info_details":[
            {
                "transaction_settle_status":"string",
                "settled_time":"string",
                "settle_biz_type":"string",
                "goods_amount":"string",
                "platform_discount":"string",
                "commission_amount":"string",
                "pay_amount":"string",
                "cps_amount":"string",
                "service_commission_amount":"string",
                "package_id":"string",
                "amount":"string",
                "voucher_code":"string",
                "poi_id":"string",
                "poi_name":"string",
                "ext_order_id":"string",
                "settle_zone":"string",
                "verify_time":"string",
                "develop_service_commission_amount":"string"
            }
        ]
    },
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码