小程序开放平台

文档中心
API 简介
登录
接口调用凭证
小程序码与链接
小程序基础信息
本地担保交易能力
通用担保交易能力
电商担保交易能力
API列表
商品同步-实物电商
担保支付订单新增
订单-状态同步
获取售后订单详情
获取订单支付token
售后单-新增
同步售后单状态
结算明细查询
获取订单信息
商品上架
批量下架
地点管理能力
客服能力
群聊能力
小说能力
短剧能力
服务组件能力
直播能力

[交易组件]售后单-新增

开发
>
服务端 API
>
电商担保交易能力
>
API列表
>
售后单-新增
>
更新时间:2025-05-22 21:15:35

支持第三方调用

支持沙箱环境调用

禁止个人开发者调用

关于售后价格计算 1、售后单价格 refund_price = 所有商品 price 价格总和 + 运费 + 附件费和 2、对同一订单可以多次发起售后,但所有售后单的总价格,必须小于原订单支付价格 3、售后单必须存在商品,运费、附加费等费用,可以随商品进行退款 4、单个商品的退款价格之和不得超过原订单该商品的实付之和

请求地址

POST https://miniapp.xiaohongshu.com/api/rmp/mp/deal/order/after_sales_order/add

公共请求参数

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

业务请求参数

名称
类型
是否必须
描述
out_order_idstring外部订单id(担保支付下日历商品保持与book_id一致)
out_after_sales_order_idstring外部售后单id
open_idstring用户id
typeint32售后类型:1:退款,2:退款退货
reasonstring售后原因
biz_create_timeint64售后单创建时间,时间戳到秒
price_info
struct售后单-退款价格信息
refund_price
int64售后单-退款总价,单位到(分)
freight_price
int64售后单-退运费价格,单位到(分)
extra_price_infos
list_struct售后单-退附加费信息
name
string退附加费名称
price
int64退附加费,该项附加费退费之和,单位(分)
num
int32退附加费数量,必须大于0
product_infos
list_struct售后单商品信息
out_product_id
string外部商品id
out_sku_id
string外部sku商品id
num
int32退货数量,必须大于0
price
int64退商品价格,该商品退货价格之和,单位(分)
refund_voucher_detail
list_struct退款的凭证信息,支持预售券和团购券,注意和refund_book_detail不能同时传
voucher_code
string凭证ID
refund_price
int64退款价格,单位到(分)
refund_book_detail
list_struct退款的预约单信息,支持日历商品的预约订单和预售券的预约单,注意和refund_voucher_detail不能同时传
book_id
string小红书侧预约单订单ID
refund_price
int64退款价格,单位到(分)
product_typeint32本地商品类型,1=团购券,2=预售券,3=日历商品,担保支付必填,电商担保无此限制
auto_confirmbool本地商家,false-需要二次商家确认 true-不需要商家确认,直接发起退款
refund_rule_typeint32本地商家:退款规则,0-默认不退资源 1-退资源

请求示例

{
    "out_order_id":"string",
    "out_after_sales_order_id":"string",
    "open_id":"string",
    "type":0,
    "reason":"string",
    "biz_create_time":0,
    "price_info":{
        "refund_price":0,
        "freight_price":0,
        "extra_price_infos":[
            {
                "name":"string",
                "price":0,
                "num":0
            }
        ]
    },
    "product_infos":[
        {
            "out_product_id":"string",
            "out_sku_id":"string",
            "num":0,
            "price":0
        }
    ],
    "refund_voucher_detail":[
        {
            "voucher_code":"string",
            "refund_price":0
        }
    ],
    "refund_book_detail":[
        {
            "book_id":"string",
            "refund_price":0
        }
    ],
    "product_type":0,
    "auto_confirm":true
}

响应参数

名称
类型
是否必须
描述
successbool是否成功
msgstring说明,正确响应时为 success,错误响应时为错误描述
codeint32错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码