集成付款解决方案

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

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

获取令牌

需要令牌才能与支付UI集成。访问令牌是一个识别游戏、用户和购买参数的字符串。

艾克索拉API使用基本认证。请指定您的商户ID作为用户名，API密钥作为密码。

获取令牌的URL：

https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token

可通过包含要向支付UI传递的参数来更改HTTP POST请求。请在创建令牌方法的user.id、user.name、user.email参数中传入相关用户信息。

Note

对于user.id参数，请使用用户容易记住的标识符，以便之后其自行在游戏外使用（例如在游戏余额充值等客户发起型支付情境）。

API参考

查看完整参数列表。

请求与响应均为JSON格式。

以下为通过艾克索拉PHP SDK获得PHP令牌的范例代码。如使用其他编程语言，请单击CURL选项卡查看CURL示例。

<?php

use Xsolla\SDK\API\XsollaClient;
use Xsolla\SDK\API\PaymentUI\TokenRequest;

$tokenRequest = new TokenRequest($projectId, $userId);
$tokenRequest->setUserEmail('email@example.com')
    ->setExternalPaymentId('12345')
    ->setSandboxMode(true)
    ->setUserName('USER_NAME')
    ->setPurchase(9.99, 'USD');

$xsollaClient = XsollaClient::factory(array(
    'merchant_id' => MERCHANT_ID,
    'api_key' => API_KEY
));
$token = $xsollaClient->createPaymentUITokenFromRequest($tokenRequest);

curl -v https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token \
-X POST \
-u your_merchant_id:merchant_api_key \
-H 'Content-Type:application/json' \
-H 'Accept: application/json' \
-d '
{
    "user": {
        "id": {
            "value": "1234567"
        },
        "email": {
            "value": "email@example.com"
        }
    },
    "settings": {
        "project_id": 14004,
        "mode": "sandbox"
    },
    "purchase": {
            "checkout": {
                "amount": 9.99,
                "currency": "USD"
            }
    }
}'

打开支付UI

有三种打开支付UI的方法：

• Pay Station Embed脚本
• Iframe
• 新建窗口

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，请从我们的CDN下载脚本。请使用该URL将脚本集成到您的网站。如需更多信息，请访问我们的GitHub存储库。

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

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

事件列表：

如果您想要自行初始化打开支付UI，请使用此链接：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN。

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

Iframe

需在您的代码侧实现以下机制：

• 检查设备类型（桌面或移动设备）并将其包含在令牌的settings.ui.version参数中发送。
• 通过postMessage获取支付UI的事件。可将这些事件发送给分析系统。要在分析系统中设置事件处理，请联系帐户经理或发送电子邮件至am@xsolla.com。

如要在iframe中打开支付UI，请使用下列链接：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN，其中ACCESS_TOKEN是在上一步中获得的令牌。对于测试，请使用此URL：https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN。

新建窗口

如要在新窗口中打开支付UI，请使用下列链接：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN，其中ACCESS_TOKEN是在上一步中获得的令牌。对于测试，请使用此URL：https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN。

设置Webhook

需为支付中心实现以下Webhook：

• 用户验证
• 付款
• 退款

Webhook列表

了解Webhook的更多信息，如示例等。

通过发送不带消息正文的HTTP代码204来确认收到Webhook。

如要测试Webhook处理程序，请打开项目设置 > Webhook部分。

测试支付流程

要测试付款过程，可：

• 使用沙盒
• 进行真实付款，然后通过发布商帐户发起退款

艾克索拉沙盒是一个独立环境，支持除真实付款外实时环境的所有功能。获得令牌后，您可以通过发送"mode":"sandbox"来访问沙盒。

要测试银行卡支付，请执行以下操作：

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

测试银行卡列表

查看测试银行卡列表。

如要通过进行真实付款来测试付款过程，同样建议使用银行卡：

1. 打开支付UI。
2. 选择信用卡/借记卡付款方式组。
3. 输入有效的银行卡详细信息。
4. 付款完成后，前往发布商帐户中的交易搜索部分。
5. 选择该测试交易，然后单击退款（交易状态必须为已完成）。

上线

要开始处理真实付款：

1. 确保已经与艾克索拉签订了合约。
2. 通过secure.xsolla.com链接打开支付中心。或在Pay Station Embed脚本中将sandbox-secure.xsolla.com改为secure.xsolla.com。
3. 获取令牌时去掉"mode":"sandbox"部分。