向用户发放购买物
使用从艾克索拉收到的Webhook中的交易详情和所购商品信息在您的应用程序中实现向用户发放购买物。
艾克索拉侧设置了两种接收商品购买和退款Webhook的方式——付款及交易数据信息和所购商品信息可以分开发送,也可以合并到一个Webhook中。
如需切换到接收合并Webhook的新方式,请联系您的客户成功经理或发送邮件至csm@xsolla.com。
要实现游戏内商店和支付管理的完整功能,必须实现对主要Webhook的处理:
如您的应用程序侧实现了商品目录个性化,请设置合作伙伴侧目录个性化的处理。
在发布商帐户中设置Webhook
- 在发布商帐户中打开您的项目,前往项目设置 > Webhooks部分。
- 在Webhook服务器字段中指定要接收Webhook的服务器URL,格式为
https://example.com
。您也可以指定在工具中找到的URL来用于测试。 - 默认会生成一个用于项目Webhook签名的密钥。如要生成新密钥,请点击刷新图标。
- 单击启用Webhook。
在发布商帐户中测试Webhook
如成功设置了Webhook,Webhook设置区块下方会显示一个Webhook测试区块。
发布商帐户中的测试部分会根据Webhook接收方式不同而有所不同。
在缺少真实值的情况下,可输入任意值。
您还可以测试在沙盒或实时模式下进行购买时的Webhook。退款测试只支持实时模式。
向Webhook发送响应
要确认收到Webhook,您的服务器必须返回:
200
、201
或204
HTTP代码(成功响应时)。- 带问题描述的
400
HTTP代码(如未找到指定用户或传入的签名无效)。
如您的服务器发生临时问题,您的Webhook处理程序也可以返回5xx
代码。
下一步
配置Webhook中的商品信息
您可以通过items数组配置在订单成功支付和订单取消Webhook中包含的商品数据。
启用附加参数包含
启用以下附加参数的包含功能以标识:
- 商品是否免费(
is_free
) - 商品是否为奖励(
is_bonus
) - 商品是否为捆绑包内容(
is_bundle_content
)
要接收这些参数,您需要使用更新Webhook设置信息API调用将Webhook切换到版本2
。在版本1
(默认版本)中,这些参数不可用。
包含附加参数的items数组示例:
- json
1
2"items": [
3 {
4 "sku": "com.xsolla.item_new_1",
5 "type": "bundle",
6 "is_pre_order": false,
7 "is_free": false,
8 "is_bonus": false,
9 "Is_bundle_content": false,
10 "quantity": 1,
11 "amount": "1000",
12 "promotions": []
13 },
14 {
15 "sku": "com.xsolla.gold_1",
16 "type": "virtual_currency",
17 "is_pre_order": false,
18 "is_free": false,
19 "is_bonus": false,
20 "is_bundle_content": true,
21 "quantity": 1500,
22 "amount": "[null]",
23 "promotions": []
24 }
25 ],
禁用捆绑包内容包含
默认情况下,Webhook会将捆绑包中的所有商品作为单独商品列表包含在内。您可以将Webhook配置为仅包含捆绑包本身,而不列出其内容。
在这种情况下,捆绑包中包含的商品不会出现在items数组中。在上面的数组中,SKU为com.xsolla.gold_1
的商品(作为捆绑包的一部分)未被包含。
禁用捆绑包内容时的items数组示例:
- json
1
2"items": [
3 {
4 "sku": "com.xsolla.item_new_1",
5 "type": "bundle",
6 "is_pre_order": false,
7 "is_free": false,
8 "is_bonus": false,
9 "Is_bundle_content": false,
10 "quantity": 1,
11 "amount": "1000",
12 "promotions": []
13 }
14 ],
如需禁用捆绑包内容包含功能,请联系您的客户成功经理或发送邮件至csm@xsolla.com。
有用链接
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。