免费商品
运行机制
免费商品是一种用户无需使用虚拟货币或真实货币购买即可获得的商品类型,包括:
- 虚拟物品
- 捆绑包
- 虚拟货币套餐
免费商品仅适用于授权用户。未授权用户只能查看免费商品的目录。
使用示例:
- 可在项目的一些重要日子(如项目筹建当天)向用户送出免费商品来回馈用户忠实度。
- 可在商店中送出新手套装来吸引新用户加入游戏。
可在用户已拥有的情况下限制特殊商品的免费发放。
适用对象
- 适用于已有游戏内商店并希望设置免费商品这一新产品类型的合作伙伴。
- 适用于希望提高当前用户忠诚度或吸引新玩家的合作伙伴。
集成过程
通过发布商帐户创建
创建免费商品(以虚拟物品为例):- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店。
- 在虚拟物品窗格中,单击配置。
- 单击 + 并在下拉菜单中选择创建物品。
- 指定:
- 图片
- SKU
- 该物品所属的一个或多个组
- 名称
- 描述
- 物品属性:消耗品、非消耗品或时效性商品
- 在价格设置区块,选择免费商品。
- 如要限制物品对指定用户的可用性,请将限制单个用户可购买此物品的次数开关设置为开,并指定次数。
- 如希望在商品中显示物品,请将在商店中显示物品开关设置为开。
- 单击创建物品。
通过API调用创建
- 要创建免费商品,请使用“管理”子部分下的API调用:创建或编辑商品时,请在请求正文中传入
is_free = true
。 - 如要限制商品对指定用户的可用性,请调用任意创建或编辑商品的API方法,并指定
limits.per_user
参数的值。
设置商店
快速购买
如用户使用快速购买(即不使用购物车),则需调用使用指定免费商品创建订单API来提供获得免费商品的机会。商品在向该方法请求成功后立即发放到用户的物品库(无需打开支付中心支付表单)。商品发放后,艾克索拉会发送一个订单成功支付Webhook。请求示例:Copy
- http
{
"method": "POST",
"url": "https://mybestgame.com/xsolla/notification",
"body": {
"items": [
{
"sku": "gift_direct_game_reward-supercoin",
"type": "virtual_currency",
"is_pre_order": false,
"quantity": 500,
"amount": "0",
"promotions": [
]
},
{
"sku": "package-500_supercoin",
"type": "bundle",
"is_pre_order": false,
"quantity": 1,
"amount": "0",
"promotions": [
]
},
{
"sku": "xsolla-giveaway_offer_11_14_22",
"type": "bundle",
"is_pre_order": false,
"quantity": 1,
"amount": "0",
"promotions": [
]
}
],
"notification_type": "order_paid",
"order": {
"id": 12345678,
"mode": "default",
"currency_type": "unknown",
"currency": null,
"amount": "0",
"status": "paid",
"platform": "xsolla",
"comment": null,
"invoice_id": null,
"promotions": [
]
},
"user": {
"external_id": "1234567812345678",
"email": null
}
},
"headers": {
"Authorization": "Signature 3b840ccefea111dcdfd111db1fdc6df969a3ec11",
"Accept": "application/json",
"Content-Type": "application/json"
},
"type": "webhook_payment",
"callback_parameters": {
"order_id": 12345678
}
}
注:
对于免费商品,order.invoice_id参数设置为
null
。- 如您的监听器正确接受并处理了Webhook — 发送HTTP响应代码200或204.
- 如发生了预期错误 — 发送HTTP响应代码4xx。
- 您的监听器也可能返回5xx HTTP响应代码,表示您的服务器上发生了暂时性错误。此情况下,艾克索拉警报服务将使用重试机制。
注:
此场景下,商品会添加到玩家的物品库,且订单在艾克索拉侧标记为成功。
购物车下单
如用户使用购物车下单:
- 如用户购物车中同时包含付费和免费商品,请调用标准的使用特定购物车中的所有商品创建订单和使用当前购物车中的所有商品创建订单API来创建订单。用户将通过支付中心的支付表单对订单进行支付。
- 如用户购物车中仅包含免费商品,请调用使用免费购物车创建订单和使用特定免费购物车创建订单API来获取免费购物车。此场景下将不使用支付界面。
Webhook示例与快速购买的示例类似。
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。