设置订单状态跟踪

注：
参考测试Web应用作为实现示例：

要将商品发放给用户，需确保付款已成功。

要跟踪所创建订单的状态并进行验证，需在应用程序的服务器侧配置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的完整列表及常规使用信息，请参阅Webhook文档。

PHP SDK
使用现成的类来处理Webhook。

设置Webhook的发送

要在艾克索拉侧配置Webhook：

  1. 在发布商帐户中打开您的项目。
  2. 在侧边栏中单击项目设置，然后前往Webhooks部分。
  3. 在Webhook URL字段中，指定艾克索拉要向其发送Webhook的URL。
注意
要接收Webhook，请以https://example.com格式指定您服务器的URL。请使用HTTPS协议传输数据，不支持HTTP协议。
注：
要测试Webhook，您还可以选择任意专门网站（如webhook.site）或平台（如ngrok）。对于真实项目，您需要添加购买验证逻辑。
  1. 单击启用Webhook。

添加Webhook监听器

Webhook监听器是一个程序代码，可以在指定的URL地址接收传入的Webhook、生成签名及向艾克索拉Webhook服务器发送响应。

生成签名

接收Webhook时，应确保数据传输的安全性。为此，必须从Webhook数据生成一个签名并确保它与HTTP请求头中发送的签名匹配。

要生成签名：

  1. 将请求正文中的JSON与项目密钥串联起来。
  2. 对第一步中得到的字符串应用SHA-1加密散列函数。

向Webhook发送响应

要确认收到Webhook，您的服务器必须返回：

  • 200、201或204 HTTP代码（成功响应时）。
  • 带问题描述的400 HTTP代码（如未找到指定用户或传入的签名无效）。

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

如果艾克索拉服务器未收到对订单成功支付或订单取消Webhook的响应，或收到了包含5xx代码的响应，将根据以下规则重新发送Webhook：

  • 间隔5分钟尝试2次
  • 间隔15分钟尝试7次
  • 间隔60分钟尝试10次

自首次尝试起，12小时内最多尝试发送Webhook20次。

如果艾克索拉服务器未收到支付Webhook或退款Webhook的响应，或收到5xx代码的响应，也将尝试重新发送Webhook且重试的间隔逐渐拉长。12小时内最多尝试12次。

如果艾克索拉服务器未收到用户验证Webhook的响应，或收到400或5xx代码的响应，将不会重新发送用户验证Webhook。

该情况下会向用户显示一个错误，且不会发送支付和订单成功支付Webhook。

注：
Webhook的完整列表和机制以及详细的处理示例见Webhook文档。
本文对您的有帮助吗？
谢谢！
我们还有其他可改进之处吗？ 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年1月23日

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

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