集成付款解决方案

要跟踪协作推广者带来的引荐数并向其支付佣金，需先集成艾克索拉支付中心。要求：

1. 支付中心集成在经过性能优化的着陆页上。
2. 支付中心是通过流量联盟活动导流的游戏着陆页上使用的唯一付款方式。

获取令牌

要打开支付UI，您需要先获取令牌。令牌是一个包含游戏和用户加密数据的字符串。您需要实现获取令牌来识别用户身份以允许其进行购买。

在您的应用程序后端，实现获取用户认证令牌。方法是使用包含基本HTTP认证的HTTP POST请求，并在请求正文中传入必需参数。

API参考

查看完整参数列表。

令牌的有效期是自最后一次调用艾克索拉API后14小时。请实现令牌过期后重新获取令牌的逻辑。建议在后台获取新令牌，这样用户就无须重新登录应用。

基本HTTP认证

艾克索拉API使用基本认证。所有发送到API的请求必须包含Authorization: Basic <your_authorization_basic_key>头，其中<your_authorization_basic_key>是按照Base64标准加密的商户ID: API密钥对。请前往发布商帐户找到以下参数：

• 商户ID在以下位置显示：
  • 在项目设置 > Webhooks部分。
  • 在公司设置 > 公司部分。
  • 在发布商帐户任意页面的浏览器地址栏的URL中。URL的格式如下：https://publisher.xsolla.com/​商户ID/发布商帐户部分。

• API密钥仅在创建它时在发布商帐户中显示一次，必须存储在己侧。您可以在以下部分中创建新的密钥：
  • 公司设置 > API密钥
  • 项目设置 > API密钥

请求正文

在请求正文中传入以下必要参数：

为提升用户体验，还可以传入以下参数：

获取用户认证令牌请求的示例

curl -i -X POST \
  -u 2340:ZHgbSDVP6LtAJVWu \
  https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": {
      "currency": "USD",
      "language": "en",
      "project_id": <project_id>,
      "ui": {
        "size": "medium"
      }
    },
    "user": {
      "email": {
        "value": "<user_email>"
      },
      "id": {
        "value": "<user_id>"
      },
      "name": {
        "value": "<user_name>"
      }
    }
  }'

响应中收到的用户认证令牌示例

{
    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}

打开支付UI

新建窗口

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

您也可以通过其他方式打开支付UI：

• 使用Pay Station Embed。缺点：在游戏内浏览器(WebView)中打开可能会有问题。
• 在iframe中打开。缺点：在游戏内浏览器(WebView)或应用程序的移动版本中打开可能会有问题。

Pay Station Embed

示例：异步脚本加载

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

Pay Station Embed允许通过postMessage获取支付UI事件。您可以将事件发送到分析系统。如要在分析系统中设置事件处理，请联系帐户经理或发送电子邮件至am@xsolla.com。

艾克索拉团队创建了一个小组件，帮助您简化将支付UI集成到网站的过程。小组件脚本在我们的GitHub存储库中提供。

用于脚本初始化的参数列表：

脚本使您可以跟踪支付UI发生的事件。根据事件的类型，可以在网页上执行各种操作。

事件列表：

如要初始化支付UI的打开，请使用以下链接：https://secure.xsolla.com/paystation3/?access_token=TOKEN。

如要进行测试，请使用以下URL：https://sandbox-secure.xsolla.com/paystation3/?access_token=TOKEN。

Iframe

要在iframe中打开支付UI：

1. 实现postMessage机制以接收支付UI的事件。
2. 在使用支付组中的API调用创建订单时获取令牌。在请求中传入：
   • 设备类型（桌面或移动设备）（settings.ui.version参数中）
   • 支付UI大小（settings.ui.size参数中）：

3. 使用链接https://sandbox-secure.xsolla.com/paystation2/?access_token=TOKEN打开支付UI，其中TOKEN是收到的令牌。

设置Webhook

如希望接收事件通知（如支付状态变化），请在发布商帐户中设置Webhook：

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

推荐实现以下Webhook：

• 用户验证
• 付款
• 购买时获取购物车内容
• 退款
• 部分退款

要确认已收到Webhook，您的服务器必须作出如下响应：

• 不带消息正文的HTTP代码204。
• 描述问题的HTTP代码400（如果指定用户未找到或传入的签名无效）。

测试支付流程

要测试支付过程，您可以使用沙盒模式。沙盒模式是一个独立环境，支持除真实付款和拒绝支付外实时环境的所有功能。获得令牌后，您可以通过发送"mode":"sandbox"来进入沙盒模式。

在沙盒模式下，可使用以下方式测试付款过程：

• 银行卡
• PayPal

测试银行卡支付

1. 以沙盒模式打开支付UI。
2. 选择信用卡/借记卡付款方式组。
3. 输入银行卡详细信息。在其余字段中输入任意值。您也可以指定不正确的细节（卡号或到期日）以生成错误。
4. 单击立即支付。

测试银行卡列表

查看测试银行卡列表。

测试PayPal支付

创建测试用PayPal帐户

要测试支付过程，您需要为PayPal沙盒模式创建一个帐户：

1. 打开PayPal开发者网站。
2. 登录您的帐户或新建帐户。
3. 前往Sandbox accounts选项卡。
4. 在Sandbox test accounts页面上单击Create account。
5. 选择Personal (Buyer Account)帐户类型并选择国家/地区。
6. 单击Create。

创建的帐户在沙盒帐户列表中显示。

您也可以使用现有沙盒帐户的信息：

进行测试性支付

1. 在沙盒模式下打开支付UI。
2. 选择PayPal支付方式。
3. 在Mock Response Code字段中，输入0或将该字段留空。
4. 在邮政编码字段中，任意输入5个数字。

5. 点击支付。您将跳转到一个PayPal帐户登录窗口。
6. 输入沙盒帐户的信息：输入Email ID作为邮箱地址，输入System Generated Password作为密码。要找到该信息：
   1. 在PayPal开发者网站上登录您的帐户。
   2. 前往Sandbox accounts选项卡。
   3. 在Sandbox test accounts页面上选择一个沙盒帐户。
   4. 单击•••，然后选择View/Edit account。您将在随后打开的模态窗口中看到该信息。
7. 完成测试支付。

上线

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

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