获取令牌

需要令牌才能与订阅集成。令牌是一个包含游戏/用户数据和支付设置的字符串。

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

获取令牌的URL:

Copy
Full screen
Small screen
https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token

请求令牌

可通过包含要向订阅UI传递的参数来更改HTTP POST请求。请求和响应均为JSON格式。

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

Copy
Full screen
Small screen
php
  • php
  • 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');

$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"
    }
}'

您可以在API参考中找到参数的完整列表。

测试支付流程

要测试付款过程,可:

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

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

要测试银行卡支付,请执行以下操作:

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

用于测试的银行卡列表

Note
沙盒模式下的银行卡付款支持以下货币:USD、EUR、RUB、GBP、AED、ALL、AMD、ARS、AUD、AZN、BGN、BRL、BYN、CAD、CHF、CLP、CNY、COP、CZK、DKK、DZD、EGP、GEL、HKD、HRK、HUF、IDR、ILS、INR、ISK、JPY、KES、KGS、KRW、KZT、MAD、MDL、MKD、MNT、MXN、MYR、NGN、PEN、PHP、PKR、PLN、RON、RSD、SAR、SEK、SGD、THB、TRY、TWD、UAH、UYU、UZS、VEF、VND、ZAR。
Notice
要开始接收真实付款,请先删除"mode":"sandbox"

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

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

Notice
要测试包含试用期的订阅付款流程,请使用有效的信用卡完成真实付款。测试银行卡只适用于测试没有试用期的订阅购买流程,因为无法在测试环境中创建账单帐户。
Note
建议使用Visa和MasterCard卡来测试付款过程。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。

继续阅读