小程序开放平台

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

[交易组件]三方优惠券领取流水上报

开发
>
服务端 API
>
本地担保交易能力
>
API列表
>
[交易组件]三方优惠券领取流水上报
>
更新时间:2026-11-09 16:13:39

支持第三方调用

支持沙箱环境调用

上报商家侧领券成功事实,按商家与券实例ID去重,不执行发券或核销

请求地址

POST https://miniapp.xiaohongshu.com/api/rmp/v2/component/deal/coupon/receive/report

公共请求参数

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

业务请求参数

名称
类型
是否必须
描述
open_idstring是被授权应用内的用户标识
discount_idstring是商家侧优惠券实例唯一ID;按商家与此ID去重
discount_typeenum_int32是优惠类型,当前1为三方优惠券
receive_timeint64是领取成功时间,Unix时间戳,单位秒

请求示例

{
    "open_id":"string",
    "discount_id":"string",
    "discount_type":0,
    "receive_time":0
}

响应参数

名称
类型
是否必须
描述
data
struct否
duplicate
bool是首次记录为false;相同领取事实重复上报为true
successbool否是否成功
msgstring否说明,正确响应时为 success,错误响应时为错误描述
codeint32否错误码,正确响应时为 0,错误响应时非0

响应示例

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

业务错误码

参见错误码