向用户发放购买物

使用从艾克索拉收到的Webhook中的交易详情和所购商品信息在您的应用程序中实现向用户发放购买物。

注:

艾克索拉侧设置了两种接收网站上的商品购买和退款Webhook的方式——付款及交易数据信息和所购商品信息可以分开发送,也可以合并到一个Webhook中。

了解更多关于Webhook接收方式的信息

在合并Webhook中接收信息:

如果您在2025年1月22日之后在发布商帐户中创建项目,您将在订单支付成功(order_paid)和订单取消(order_canceled) Webhook中接收所有信息。在这种情况下,无需处理支付(payment)和退款(refund) Webhook。

在单独Webhook中接收信息:

如果您在2025年1月22日或之前在发布商帐户中创建项目,您将接收以下Webhook:

您需要处理所有传入的Webhook。

如需切换到接收合并Webhook的新方式,请联系您的客户成功经理或发送邮件至csm@xsolla.com

要实现游戏内商店和支付管理的完整功能,必须实现对主要Webhook的处理:

如您的应用程序侧实现了商品目录个性化,请设置合作伙伴侧目录个性化的处理。

注:
要接收真实付款,只需要实现对支付订单成功支付用户验证Webhook的处理并签署许可协议

在发布商帐户中设置Webhook

  1. 发布商帐户中打开您的项目。
  2. 在侧边栏中单击项目设置,然后前往Webhooks选项卡。
  3. Webhook服务器字段中指定要接收Webhook的服务器URL,格式为https://example.com。您也可以指定在工具中找到的URL来用于测试。
  4. 默认会生成一个用于项目Webhook签名的密钥。如要生成新密钥,请点击刷新图标。
  5. 单击启用Webhook
注意
请使用HTTPS协议传输数据,不支持HTTP协议。

在发布商帐户中测试Webhook

如成功设置了Webhook,Webhook设置区块下方会显示一个Webhook测试区块。

发布商帐户中的测试部分会根据Webhook接收方式不同而有所不同。

在缺少真实值的情况下,可输入任意值。

您还可以测试在沙盒实时模式下进行购买时的Webhook。退款测试只支持实时模式。

向Webhook发送响应

要确认收到Webhook,您的服务器必须返回:

  • 200201204 HTTP代码(成功响应时)。
  • 问题描述400 HTTP代码(如未找到指定用户或传入的签名无效)。

如您的服务器发生临时问题,您的Webhook处理程序也可以返回5xx代码。

注:
Webhook的完整列表和机制以及详细的处理示例见Webhook文档

下一步

  1. 实现获取订阅信息
  2. 设置用户认证

集成过程

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年1月23日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!