如何向好友发送礼物

运行机制

本功能允许用户用真实货币购买虚拟货币套餐、虚拟物品、游戏密钥或订阅作为礼物送给游戏中的好友。成功付款后,送礼人会收到付款凭证,而收礼人会收到包含礼物详细信息的电子邮件。送礼人可选择隐藏身份,匿名送出礼物。

Note
购买虚拟货币套餐或虚拟物品作为礼物的功能仅适用于禁用了艾克索拉侧用户数据存储的项目。

适用对象

  • 集成了Buy Button并启用了虚拟物品/虚拟货币/游戏密钥模块的合作伙伴。
  • 集成了订阅的合作伙伴。

Info
本功能只适用于使用Checkout API(已淘汰)方法的项目。请前往项目设置 > 集成设置并确保集成Commerce API开关设置为

如何获取

要启用该功能,请执行以下操作:

  1. 配置虚拟货币套餐虚拟物品游戏密钥套餐订阅
  2. 选择并实现以下方式之一来发送好友列表:通过API方法通过令牌
  3. 成功购买Webhook中实现purchase.gift参数处理。
  4. 联系帐户经理完成设置。

通过令牌发送好友列表

如要让送礼人从建议列表中选择收礼人,请将用户好友列表作为获取令牌请求中的purchase.gift.friends参数传递。然后在您的应用中显示收到的列表。如果该列表只包含一位用户,则自动将该用户定义为收礼人。

要添加收礼人的信息,请在获取令牌请求中传入purchase.gift.giver_idpurchase.gift.messagepurchase.gift.hide_giver_from_receiver参数。

礼物为虚拟货币的令牌示例:

Copy
Full screen
Small screen
"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
Full screen
Small screen
"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并生成一个签名。要生成签名:

  1. 确保已在发布商帐户 > 项目设置 > Webhooks中指定了Webhook URL
  2. 生成请求签名
  3. 在API请求处理过程中,确保生成的签名与sign参数中传入的签名一致。

请求示例:

Copy
Full screen
Small screen
$ 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
Full screen
Small screen
[
  {
  "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
  }
]

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。