NN游戏试玩
  1. NN发行下单中心
NN游戏试玩
  • 用户端
    • 平台游戏
      • API-V1:平台游戏
        • 平台列表
        • 游戏详情
        • 游戏评论
        • 推荐
        • 游戏同步(爬虫)
      • API-V1:游玩数据
        • 游玩数据
        • 账号绑定社区
      • API-V1:账号授权
        • 绑定用户授权账号
        • 用户授权账号备注
        • 编辑用户授权账号
        • 刷新用户授权账号资料
        • 用户账号授权信息查询
        • 用户账号列表
      • API-V1:游戏成就
        • 成就进度
      • API-V1:测试
        • 测试
      • 管理后台:授权账号管理
        • 查询授权账号信息
        • 查询授权账号明细
      • 管理后台:推荐相关接口
        • 推荐位列表查询
      • 应用宝游戏推荐管理
        • 创建游戏推荐
        • 更新游戏推荐
        • 获取游戏推荐详情
        • 分页查询游戏推荐(不包含推荐明细)
        • 删除游戏推荐
        • 根据位置类型获取推荐游戏列表
      • API-V1:模拟器游戏接口层
        • 根据id查询
        • 根据社区查询
        • 查询多条数据
        • 模拟器启动上报
        • 模拟器启动记录分页查询
        • 根据社区查询游戏推荐
        • 根据社区查询游戏推荐(只取第一个)
    • 试玩模块
      • NN试玩套餐信息
        • nn试玩套餐列表
    • 应用宝
      • API-V1:推荐区社区模式推荐信息
        • 根据社区类型id查询推荐区及游戏信息
      • API-V1:模拟器配置接口层
        • 查询模拟器授权相关配置
      • API-V1:模拟器游戏接口层
        • 模拟器启动上报
        • 模拟器启动记录分页查询
        • 根据社区查询游戏推荐
        • 根据社区查询
        • 根据社区查询游戏推荐(只取第一个)
      • API-V1:模拟器社区开关配置接口层
        • 根据社区查询
  • 薄荷运营后台
    • 授权账号
      • 管理后台:授权账号管理
        • 查询授权账号信息
        • 查询授权账号明细
    • 管理后台:推荐相关接口
      • 推荐位列表查询
      • 是否启用游戏集
      • 游戏集新增
      • 游戏集编辑
      • 游戏集删除
      • 关系查询
      • 关系分页查询
      • 关系新增
      • 关系新增
      • 是否启用关系
      • 通过关系ID关系批量删除
      • 通过code关系删除
    • 管理后台:游戏信息相关接口
      • 分页
      • 新增
      • 修改
      • 删除
      • 详情
      • 评论分页查询
      • 评论编辑
      • 抓取steam游戏配置
  • NN管理后台服务
    • gamehub
      • 游戏发行授权账号管理相关接口
        • 查询授权账号信息
        • 查询授权账号明细
      • 应用宝-社区推荐管理
        • 推荐区 - 分页查询
        • 推荐区 - 新增&编辑
        • 社区推荐 - 分页查询
        • 社区推荐 - 新建/编辑
        • 推荐区 - 删除
        • 社区推荐 - 删除
      • 应用宝-游戏推荐管理
        • 创建游戏推荐
        • 更新游戏推荐
        • 获取游戏推荐详情
        • 分页查询游戏推荐(不包含推荐明细)
        • 删除游戏推荐
        • 游戏推荐上架下架
      • 后台:社区模拟器配置
        • 插入和更新数据
        • 查询社区模拟器配置详情
      • 模拟器游戏后台管理接口层
        • 删除数据
        • 详情
        • 分页查询
        • 新增/保存
        • 启用/禁用
    • 应用宝-游戏推荐管理
  • NN发行接入薄荷接口
    • 用户相关
      • nn发行用户登录薄荷
    • NN发行下单中心
      • 统一下单
        POST
      • 统一支付
        POST
      • 组合订单下单
        POST
      • 查询订单状态
        GET
      • 组合订单下单match(不创建订单)
        POST
      • 订单下单match(不创建订单)
        POST
    • NN发行游戏相关接口
      • 马甲游戏取号相关接口(WEB)
        • 取消排队
        • 获取解锁码
        • 排队心跳
        • 云存档列表查询
        • 上传存档文件链接
        • 获取上传签名
        • 上号心跳
    • NN用户试玩相关接口
      • 用户试玩记录(指定游戏分类)
      • 限时试玩套餐分页
    • NN试玩商品
      • 查询饰品道具列表
      • 查询账号CDK列表
      • 查询游戏币列表
    • 搭配套餐
      • 搭配套餐全局配置查询v2
    • 查询支付弹窗商品列表
      POST
  1. NN发行下单中心

组合订单下单match(不创建订单)

测试环境
http://test1-opapi.nn.com/boheapi/nnorder
测试环境
http://test1-opapi.nn.com/boheapi/nnorder
POST
http://test1-opapi.nn.com/boheapi/nnorder
/nn/release/combine/order/match
NN发行下单中心
最后修改时间:2025-06-05 06:33:07
责任人:未设置

请求参数

Header 参数
busiType
string 
可选
用于平台区分的字段(nn平台,加速器平台)
默认值:
speedPcClient_mzShyYu7
countryCode
integer <int64>
国家区号
可选
默认值:
86
reqChannel
integer <int32>
可选
请求渠道,用于客户端的区分
默认值:
1
sign
string 
签名
可选
默认值:
1
telNum
string 
手机号
可选
默认值:
13600365350
timeStamp
integer <int64>
时间戳-用于加密
可选
默认值:
20202020
token
string 
用户token
可选
默认值:
xxxxxxxxxxxxxxxxxxx
trackId
string 
请求链路ID
可选
默认值:
abc123456789
userId
integer <int64>
用户Id
可选
默认值:
102032
appid
string 
可选
x-access-token
string 
管理后台token
可选
默认值:
{{x-access-token}}
Body 参数application/json
组合下单参数
activityId
integer <int64>
活动id
可选
bannerId
integer <int64>
可选
通过banner位跳转下单页时传
示例值:
12
baseOrderType
integer <int32>
可选
如果是组合单,则取基础单的价格
channelId
integer <int64>
可选
频道ID,打赏订单和带玩订单必传
codeGiveRecordId
integer <int64>
可选
折扣卷ID 当用户选择折扣卷时传
combineOrderParams
array[object (CombineOrderParam) {6}] 
组合单
可选
gameId
integer <int64>
可选
带玩订单/预售 需传 所选游戏Id
goodsId
integer <int64>
可选
商品ID:充值时可不填,消费订单时为商品ID(废弃),加速器订单为套餐ID,开通VIP为VIP套餐的ID(废弃),共享账号订单为游戏ID(废弃),试玩独享订单为游戏ID,试玩会员订单为试玩会员套餐ID,账号购买订单为游戏ID,CDK购买订单为游戏ID,电竞会员订单为电竞会员套餐ID,试玩礼包订单为活动礼包套餐ID 主机会员订单为套餐ID 公会贵宾订单可不填 用户打赏订单为礼物售卖ID 次卡套餐ID
示例值:
1
isPreSaleGame
integer <int32>
可选
是否预售游戏 1是 0否
orderType
integer <int32>
可选
订单类型:1NB充值,2消费订单(废弃),3加速器订单充值,4开通共享游戏VIP订单(废弃),5共享账号订单(废弃),6试玩独享订单(废弃),7试玩会员订单,8账号购买订单,9CDK购买订单,10电竞会员订单 11试玩礼包订单 12电竞会员特权 13主机会员订单 14公会贵宾订单 15用户打赏订单 16薄荷充值订单 17薄荷账号订单 18薄荷会员订单 19次卡订单 20薄荷搭配套餐订单
示例值:
4
qty
integer <int32>
数量默认为1
可选
示例值:
1
valueAddedGoodType
integer <int32>
可选
增值商品类型(1mod 2精品存档 3汉化包)
combined
integer <int32>
可选
是否组合 0不是 1是
combinedPurchaseNum
integer <int32>
组合单商品数量
可选
consumerType
integer <int32>
可选
消费类型:1N币支付,2现金支付,3组合支付 4薄荷组合支付 5薄荷余额支付
discountCode
string 
可选
折扣码 当用户使用折扣码时传
示例值:
SZ78x123a456c789
equityRemark
string 
权益备注
可选
gameId
integer <int64>
可选
带玩订单/预售 需传 所选游戏Id
gameIds
array[integer <int64>]
可选
游戏id【orderType=23或24 (买一送九/特价专区时必传】
goodsId
integer <int64>
可选
商品ID:充值时可不填,消费订单时为商品ID(废弃),加速器订单为套餐ID,开通VIP为VIP套餐的ID(废弃),共享账号订单为游戏ID(废弃),试玩独享订单为游戏ID,试玩会员订单为试玩会员套餐ID,账号购买订单为游戏ID,CDK购买订单为游戏ID,电竞会员订单为电竞会员套餐ID,试玩礼包订单为活动礼包套餐ID 主机会员订单为套餐ID 公会贵宾订单可不填 用户打赏订单为礼物售卖ID 次卡套餐ID 带玩订单传礼物ID 师徒订单传套餐ID
示例值:
1
guidedPop
string 
guidedPop
可选
示例值:
1
hostId
integer <int64>
主持人用户ID
可选
isAccountUpgrade
integer <int32>
可选
是否账号升级 1是 0否
isDeductionAmount
integer <int32>
可选
薄荷-是否抵扣金额(1是 0否)
isDeductionCoupon
integer <int32>
可选
薄荷-是否抵扣优惠券(1是 0否)
isPreSaleGame
integer <int32>
可选
是否预售游戏 1是 0否
isVipDeductionCoupon
integer <int32>
可选
薄荷-是否使用会员立减券(1是 0否)
lastNo
integer <int64>
可选
复购(会员订单)时,上一笔订单(共享,独享)订单号
marketingSource
string 
市场推广来源
可选
示例值:
baidu / 360 / sogou / guanwang / 试玩官网
masterOrderType
integer <int32>
可选
nbAmount
number 
充值时的金额,必填
可选
orderScene
object (OrderScene) 
可选
pageTitle
string 
当前页面名称
可选
refererPageTitle
string 
来源页面名称
可选
sceneType
integer <int32>
可选
下单场景类型(10:奇妙软件卸载下单)
orderType
integer <int32>
可选
订单类型:1NB充值,2消费订单(废弃),3加速器订单充值,4开通共享游戏VIP订单(废弃),5共享账号订单(废弃),6试玩独享订单(废弃),7试玩会员订单,8账号购买订单,9CDK购买订单,10电竞会员订单 11试玩礼包订单 12电竞会员特权 13主机会员订单 14公会贵宾订单 15用户打赏订单 16薄荷充值订单 17薄荷账号订单 18薄荷会员订单 19次卡订单 20搭配套餐 21薄荷合集包 22奇妙修改器会员订单 23薄荷买一送九 24薄荷特价专区 25多用户打赏订单 26陪玩订单 27师徒订单
示例值:
4
packageName
string 
套餐名称
可选
partyPhase
integer <int32>
活动阶段
可选
payType
integer <int32>
可选
支付类型(1-微信扫码 3-支付宝扫码
phone
string 
可选
未登录状态必填的手机号
示例值:
13231118888
qty
integer <int32>
数量默认为1
可选
示例值:
1
receiveCouponId
integer <int32>
可选
当用户购买商品时优惠券可用,但是用户未领取,可传入优惠券模板id自动领取优惠券,并核销
repurchaseId
integer <int64>
复购配置ID
可选
serverId
integer <int64>
可选
社区ID,打赏订单和带玩订单必传
setType
integer <int32>
可选
薄荷合集包使用 1自选合集包 2标签合集包
示例值:
1
stockGameRandomId
string 
可选
薄荷奖品库随机赠送一个共享游戏时使用(官网下单)
targetAccount
string 
可选
目标账号,给他人充值必填
targetId
integer <int64>
可选
目标用户Id,打赏订单和带玩订单必传
timeQty
integer <int32>
可选
带玩订单需传 下单局数
triggerDiscountId
integer <int64>
触发式折扣配置ID
可选
valueAddedGoodType
integer <int32>
可选
增值商品类型(1mod 2精品存档 3汉化包)
vipGoodsId
integer <int64>
薄荷会员商品id
可选
vipGoodsType
integer <int32>
可选
薄荷会员商品类型(1游戏商品 2CDK商品)
ygToken
string 
云游戏token
可选
示例
{
    "goodsId": "9111",
    "orderType": 7,
    "combineOrderParams": [
        {
            "goodsId": "9111",
            "isPreSaleGame": 0,
            "orderType": 7
        },
        {
            "goodsId": 31,
            "orderType": 20,
            "qty": 1
        }
    ],
    "consumerType": 1,
    "qty": 1,
    "marketingSource": "nn_client",
    "payType": 99
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'http://test1-opapi.nn.com/boheapi/nnorder/nn/release/combine/order/match' \
--header 'busiType;' \
--header 'countryCode;' \
--header 'reqChannel;' \
--header 'reqChannel;' \
--header 'sign;' \
--header 'telNum;' \
--header 'timeStamp;' \
--header 'token;' \
--header 'token;' \
--header 'trackId;' \
--header 'userId;' \
--header 'appid;' \
--header 'x-access-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NTEwMTA5MzMsInVzZXJuYW1lIjoiYWRtaW4ifQ.3BIsSwbWedvRhd-GZmhWitrIPQwubGOP1BYuTBoZ458' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goodsId": "9111",
    "orderType": 7,
    "combineOrderParams": [
        {
            "goodsId": "9111",
            "isPreSaleGame": 0,
            "orderType": 7
        },
        {
            "goodsId": 31,
            "orderType": 20,
            "qty": 1
        }
    ],
    "consumerType": 1,
    "qty": 1,
    "marketingSource": "nn_client",
    "payType": 99
}'

返回响应

🟢200成功
application/json;charset=UTF-8
OK
Body
基础返回对象
retCode
string 
响应码
可选
retData
object (统一下单结果) 
可选
appId
string 
可选
苹果渠道,需要appId
balance
number 
余额
可选
boheBalance
number 
薄荷余额
可选
boheCurrency
number 
使用薄荷余额
可选
boheRedBalance
number 
薄荷红包
可选
boheRedpacket
number 
使用薄荷红包
可选
busiType
string 
业务类型
可选
commission
number 
奇妙支付手续费
可选
consumerType
integer <int32>
可选
消费类型:1N币支付,2现金支付,3组合支付,正常情况和下单的保持一致,苹果支付在N币余额不足的情况下会转换成现金全额支付
discountAmount
number 
可选
折扣金额,使用折扣码抵掉的金额
favourablePrice
number 
优惠价格
可选
favourablePriceRel
number 
优惠价格(真)
可选
firstBuy
boolean 
可选
h5PayUrl
string 
h5支付链接
可选
needReceive
integer <int32>
可选
是否需要手动领取 (0.不需要 1.需要)
nnCurrency
number 
使用N币数
可选
nnFavourablePrice
number 
n币优惠价格
可选
nnOriginalPrice
number 
n币原价格
可选
orderExpiredTime
string <date-time>
可选
订单过期时间:格式 2020-10-01 11:00:00
orderNo
string 
订单号
可选
originalPrice
number 
原价格
可选
payChannel
string 
可选
奇妙支付对应的支付通道
payChannel2
string 
可选
奇妙支付对应的支付通道
payRmb
number 
应付RMB数
可选
pop
boolean 
可选
popPartyAct
boolean 
可选
是否需要弹活动弹窗-(派对厅活动弹窗) true弹窗 false不弹窗
priceName
string 
套餐价格名字
可选
reqChannel
integer <int32>
渠道
可选
singleResult
array[object (组合单各子单细节) {4}] 
组合单各子单信息
可选
totalAmount
number 
订单总金额
可选
totalBoheCurrency
number 
总付款薄荷余额
可选
totalBoheRedpacket
number 
总付款薄荷红包
可选
totalNnCurrency
number 
总付款N币数
可选
totalPayAmount
number 
可选
总应付金额=总金额-折扣金额
retMsg
string 
响应信息
可选
retTime
string 
响应时间
可选
success
boolean 
可选
示例
{
    "retCode": "string",
    "retData": {
        "appId": "string",
        "balance": 0,
        "boheBalance": 0,
        "boheCurrency": 0,
        "boheRedBalance": 0,
        "boheRedpacket": 0,
        "busiType": "string",
        "commission": 0,
        "consumerType": 0,
        "discountAmount": 0,
        "favourablePrice": 0,
        "favourablePriceRel": 0,
        "firstBuy": true,
        "h5PayUrl": "string",
        "needReceive": 0,
        "nnCurrency": 0,
        "nnFavourablePrice": 0,
        "nnOriginalPrice": 0,
        "orderExpiredTime": "2019-08-24T14:15:22Z",
        "orderNo": "string",
        "originalPrice": 0,
        "payChannel": "string",
        "payChannel2": "string",
        "payRmb": 0,
        "pop": true,
        "popPartyAct": true,
        "priceName": "string",
        "reqChannel": 0,
        "singleResult": [
            {
                "commission": 0,
                "orderType": 0,
                "totalAmount": 0,
                "totalPayAmount": 0
            }
        ],
        "totalAmount": 0,
        "totalBoheCurrency": 0,
        "totalBoheRedpacket": 0,
        "totalNnCurrency": 0,
        "totalPayAmount": 0
    },
    "retMsg": "string",
    "retTime": "string",
    "success": true
}
🟢201成功
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
修改于 2025-06-05 06:33:07
上一页
查询订单状态
下一页
订单下单match(不创建订单)
Built with