运行机制
本功能允许用户用真实货币购买虚拟货币套餐、虚拟物品、游戏密钥或订阅作为礼物送给游戏中的好友。成功付款后,送礼人会收到付款凭证,而收礼人会收到包含礼物详细信息的电子邮件。送礼人可选择隐藏身份,匿名送出礼物。
Note:
购买虚拟货币套餐或虚拟物品作为礼物的功能仅适用于禁用了艾克索拉侧用户数据存储的项目。
使用者
- 集成了Buy Button并启用了虚拟物品/虚拟货币/游戏密钥模块的合作伙伴。
- 集成了订阅的合作伙伴。
Info:
本功能只适用于使用Checkout API(已淘汰)方法的项目。请前往项目设置 > 集成设置并确保集成Commerce API 开关设置为关。
如何获取
要启用该功能,请执行以下操作:
- 配置虚拟货币套餐,虚拟物品、游戏密钥套餐或订阅。
- 选择并实现以下方式之一来发送好友列表:通过API方法或通过令牌。
- 在成功购买Webhook中实现
purchase.gift
参数处理。 - 联系帐户经理完成设置。
通过令牌发送好友列表
如要让送礼人从建议列表中选择收礼人,请将用户好友列表作为获取令牌请求中的purchase.gift.friends
参数传递。然后在您的应用中显示收到的列表。如果该列表只包含一位用户,则自动将该用户定义为收礼人。
要添加收礼人的信息,请在获取令牌请求中传入purchase.gift.giver_id
、purchase.gift.message
、purchase.gift.hide_giver_from_receiver
参数。
礼物为虚拟货币的令牌示例:
Copy
- http
"purchase":{
"virtual_currency":{
"quantity":100
},
"description":{
"value":"Test Purchase"
},
"gift":{
"giver_id":"John Smith",
"message":"GG WP",
"hide_giver_from_receiver" : true,
"friends": [
{
"id": "123",
"name": "captain",
"email": "captain@ship.com"
}]
}
}
礼物为订阅的令牌示例:
Copy
- http
"purchase": {
"gift": {
"giver_id": "John Smith",
"message": "GG WP",
"hide_giver_from_receiver": true,
"friends": [
{
"id": "123",
"name": "captain",
"email": "captain@ship.com"
}
]
}
}
通过API请求传递好友列表
实现传递好友列表的API并生成一个签名。要生成签名:
- 确保已在发布商帐户 > 项目设置 > Webhooks中指定了Webhook URL。
- 生成请求签名。
- 在API请求处理过程中,确保生成的签名与
sign
参数中传入的签名一致。
请求示例:
Copy
- http
$ curl -v 'https://your.webhook.url?notification_type=friends_list&user=user_id&query=frien&offset=10&limit=20&sign=12dfg3f5gdsf4g5s6dfg2sdg1' \
-X GET \
-u merchant_id:merchant_api_key
响应示例:
Copy
- http
[
{
"friends": [
{
"id": "1",
"name": "John Carter",
"email": "carter@xsolla.com",
"image_url": "https://partner/link/doctor.jpg"
},
{
"id": "2",
"name": "John Smith",
"email": "smith@xsolla.com",
"image_url": "https://partner/link/cook.jpg"
}
],
"total": 10
}
]
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。为此页面评分
为此页面评分
不想回答
感谢您的反馈!
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。