小程序开放平台

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

[交易组件]担保支付订单新增

开发
>
服务端 API
>
本地担保交易能力
>
API列表
>
订单新增
>
更新时间:2025-05-22 21:15:13

支持第三方调用

支持沙箱环境调用

禁止个人开发者调用

请求地址

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

公共请求参数

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

业务请求参数

名称
类型
是否必须
描述
out_order_idstring指定外部订单号
open_idstringopenId
pathstring小程序path路径
biz_create_timeint64业务创建时间
biz_update_timeint64业务更新时间
order_expired_timeint64订单超时时间
product_infos
list_struct下单商品信息
out_product_id
string外部商品id
out_sku_id
stringoutSkuId
num
int32购买商品数量,必须大于0
sale_price
int64售卖价格
real_price
int64实际价格
image
string图片地址
discount_infos
list_struct折扣信息
name
string折扣名称
price
int64优惠金额
num
int32优惠的数量
price_info
struct价格信息
order_price
int64订单金额
freight_price
int64运费
discount_price
int64优惠金额
extra_price_infos
list_struct附加金额
name
string名称
price
int64金额
num
int32数量
biz_id
string业务id
biz_type
string业务类型,。附加费场景传固定值INDEPENDENT,可以单独进行费用项的退款

请求示例

{
    "out_order_id":"string",
    "open_id":"string",
    "path":"string",
    "biz_create_time":0,
    "biz_update_time":0,
    "order_expired_time":0,
    "product_infos":[
        {
            "out_product_id":"string",
            "out_sku_id":"string",
            "num":0,
            "sale_price":0,
            "real_price":0,
            "image":"string",
            "discount_infos":[
                {
                    "name":"string",
                    "price":0,
                    "num":0
                }
            ]
        }
    ],
    "price_info":{
        "order_price":0,
        "freight_price":0,
        "discount_price":0,
        "extra_price_infos":[
            {
                "name":"string",
                "price":0,
                "num":0,
                "biz_id":"string",
                "biz_type":"string"
            }
        ]
    }
}

响应参数

名称
类型
是否必须
描述
data
struct
out_order_id
string外部订单id
order_id
string小红书订单id
final_price
int64订单最终总价格
pay_token
string订单支付用 token,用于拉起小程序支付api
expired_time
int64订单支付到期时间,时间戳精确到秒
open_pay_type
string订单支付类型,跟商家的交易能力匹配,direct:直连支付,life_gpay:担保支付(本地生活)
successbool是否成功
msgstring说明,正确响应时为 success,错误响应时为错误描述
codeint32错误码,正确响应时为 0,错误响应时非0

响应示例

{
    "data":{
        "out_order_id":"string",
        "order_id":"string",
        "final_price":0,
        "pay_token":"string",
        "expired_time":0,
        "open_pay_type":"string"
    },
    "success":true,
    "msg":"string",
    "code":0
}

业务错误码

参见错误码