Платежи / Получение токена
 На главную

Платежи

  • Руководство по интеграции

  • Тестирование

  • Возможности

  • Инструкции

  • Справочники

  • Получение токена

    Примечание
    Реализуйте получение токена, если на вашем сайте покупку будут осуществлять авторизованные пользователи. Если вы планируете продажи неавторизованным пользователям, подключите продукт Buy Button.

    Для интеграции платежного интерфейса необходимо получить токен. Токен — это строка, в которой содержится информация об игре, пользователе и параметрах покупки.

    API Иксоллы использует базовую HTTP-аутентификацию. Укажите свой ID продавца в качестве username и ключ API в качестве password.

    Чтобы найти эти данные:

    1. Зайдите в Личный кабинет и перейдите в Настройки компании.
    2. На вкладке Компания скопируйте ID продавца.
    3. На вкладке Ключ API скопируйте Kлюч API.

    URL получения токена:

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

    В HTTP POST запросе вы можете указать параметры, которые нужно передать на платежный интерфейс. Передайте информацию о пользователе в параметрах user.id, user.name и user.email метода Получение токена.

    Примечание
    Для параметра user.id используйте идентификатор, который пользователь сможет запомнить и в дальнейшем использовать самостоятельно вне игры (например, при пополнении игрового баланса с помощью push-платежей).
    Справочник API
    Посмотреть полный список параметров.

    Запрос и ответ передаются в формате JSON.

    Ниже указан пример получения токена на PHP с использованием PHP SDK. Если вы разрабатываете на другом языке, можно использовать пример 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')
        ->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"
                }
        }
    }'

    Прогресс интеграции
    Спасибо за обратную связь!

    Продолжить чтение

    Справочник API
    Последнее обновление: 8 августа 2022

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

    Сообщите о проблеме
    Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
    Укажите email-адрес, чтобы мы могли связаться с вами
    Спасибо за обратную связь!