快速指南

集成过程

要集成付款解决方案：

1. 在发布商帐户中创建项目。一个项目对应一个游戏。如有多个游戏，请为每个游戏各创建一个项目。
2. 将要销售的商品添加到艾克索拉侧的目录。
3. 测试创建模拟用户要支付的订单。
4. 进行测试性购买并设置通知。
5. 在发布商帐户中签署与艾克索拉的协议以开始处理真实支付。

创建目录

虚拟物品是用户可使用真实或虚拟货币购买的游戏内内容。在艾克索拉侧创建虚拟物品目录可以自定义区域价格和限制，还可以使用艾克索拉的促销活动系统及定期增加和更新的其他功能。

创建虚拟物品

• 在发布商帐户中配置
• 通过API配置

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中，单击商店。
3. 在虚拟物品窗格中，单击：
   • 连接 — 如之前未配置虚拟物品。
   • 配置 — 如之前已配置虚拟物品。
4. 单击创建物品。

5. 指定物品的信息。必填字段：
   • SKU — 唯一物品ID
   • 物品名称
   • 描述
   • 真实货币价格
6. 将在商店中显示物品开关设置为开。
7. 单击创建物品。

接下来的步骤将需要用到创建的物品的SKU：

要设置虚拟物品，请使用虚拟物品和货币组管理子部分下的API调用。

注：

关于使用此API调用的详细信息，请参阅集成指南。

获取物品列表

要获取物品列表，请调用获取虚拟物品列表API方法。在请求中传入project_id参数，即可在发布商帐户中找到的项目ID：

在响应中，您将收到项目中创建的虚拟物品的详细信息。后续订单创建中您需要该物品的SKU来传入items.sku参数。

创建订单

订单由用户要在商店中购买的商品组成。支付订单后，用户将收到商品。要进行支付，用户必须授权登入游戏。

选择游戏适合的集成方式，然后查看相应的设置说明。

• 服务器侧
• 客户端侧

调用为购买创建支付令牌API方法，然后在该方法中传入用户和商品信息。您可以使用该API调用一次销售单个或多个商品。

要使用沙盒模式，请在获取令牌的请求正文中传入"sandbox": true参数。

请求示例：

Copy

Full screen

Small screen

curl -i -X POST \
  -u 224575:MYAPIKEY \
  https://sandbox-secure.xsolla.com/api/v2/project/224575/admin/payment/token \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "id": {
        "value": "myUserID"
      }
    },
    "purchase": {
      "sandbox": true,
      "items": [
        {
          "sku": "mySKU",
          "quantity": 1
        }
      ]
    }
  }'

集成艾克索拉登录管理器：

1. 创建一个项目。
2. 在发布商帐户中设置登录管理器项目。
3. 连接用户数据存储。
4. 在您的应用程序侧集成解决方案。

使用配置的登录管理器方法创建并保存身份认证令牌以接收支付令牌。支付令牌用于打开支付UI及进行支付。

要测试支付流程，请通过使用指定商品创建订单API调用创建订单：

1. 如要在API文档网站上进行测试，请单击Try it打开创建请求的界面。
2. 在Security区块的Bearer Token字段中，输入完成认证过程时获得的令牌。
3. 在Body区块中，传入商品数量等订单详细信息。要访问沙盒模式，请传入"sandbox": true。
4. 在Parameters区块中，传入
   • project_id — 可在发布商帐户中找到的项目ID。
   • item_sku — 商品SKU。

在响应中，您将收到后续操作需要的数据：

• token — 支付令牌

请求示例：

Copy

Full screen

Small screen

curl -i -X POST \
  'https://store.xsolla.com/api/v2/project/{project_id}/payment/item/{item_sku}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sandbox": true,
    "quantity": 5,
    "settings": {
      "ui": {
        "theme": "63295a9a2e47fab76f7708e1",
      }
    },
    "custom_parameters": {
      "character_id": "ingameUsername"
    }
  }'

注：

要调用艾克索拉API，您可以使用针对各游戏引擎和平台的现成SDK：

• Unity
• 虚幻引擎
• Cocos Creator
• Android

进行测试性购买

在沙盒模式下打开支付UI

要在新窗口中打开支付UI，请使用以下URL：https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN，其中TOKEN是创建订单时获得的令牌。

要使用其他方法打开支付UI，请参阅文档。

进行测试性支付

1. 在沙盒模式下打开支付UI。
2. 选择银行卡付款方式。
3. 输入银行卡详细信息。对于其他字段（如名称或地址），可输入任意数据。您也可以指定不正确的细节（卡号或到期日）以测试是否会产生错误。
4. 单击支付。

测试银行卡列表

查看测试银行卡列表。

设置Webhook

如在服务器侧设置集成，需通过在对Webhook的响应中发送相应代码来验证创建的订单。如在服务器侧设置集成，可通过Webhook来接收已配置事件的通知（如支付状态更改等）。

PHP SDK

使用现成的类来处理Webhook。

要在艾克索拉侧设置Webhook：

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击项目设置，然后前往Webhooks。
3. 将Webhooks开关设置为开。
4. 指定Webhook URL。
5. 默认会生成一个用于项目Webhook签名的密钥。如要生成一个新密钥，请单击刷新图标。
6. 单击保存设置。

要接收用户验证和成功支付的通知，请配置以下Webhook：

• 用户验证 — 通知确认用户已在游戏中注册。
• 支付 — 通知用户已付款。

配置Webhook监听器

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

发布

签署许可协议

签署许可协议后即可通过艾克索拉支持的付款方式接收真实付款。要签署许可协议：

1. 打开您的发布商帐户。
2. 在侧边栏中，前往协议与税务信息 > 协议部分。
3. 在许可协议选项卡中单击填写申请表。
4. 在相应字段中提供您的信息。

您的申请将在3个工作日内进行审核。如在审核过程中有任何问题，艾克索拉将联系申请中所写的联系人。艾克索拉侧的审核程序完成后，您的协议状态将更改为已签署。

切换到生产环境

完成前面的步骤后，即可开始接收真实付款：

1. 请确保已签署艾克索拉许可协议。
2. 删除获取令牌时请求正文中的"sandbox": true参数。
3. 通过以下链接打开支付UI：https://secure.xsolla.com/paystation4/?token=TOKEN。

为此页面评分

我们还有其他可改进之处吗？ 发送

不想回答

感谢您的反馈！