Оплата зарубежных сервисов

Данный функционал позволяет оплачивать иностранные игровые и digital-сервисы напрямую со своего баланса AlfaBit (как Личного, так и Бизнес), без использования банковских карт и внешних платёжных провайдеров. Оплата выполняется в автоматическом режиме через фиатный платёжный контур AlfaBit и по логике аналогична фиатному выводу: выбирается сервис, указывается сумма, система рассчитывает итог с учётом комиссии и создаёт платёжный заказ.

Доступные сервисы

На текущий момент доступны следующие зарубежные сервисы:

• Steam — оплата и пополнение аккаунтов Steam, непакетная услуга

• Genshin Impact (Voucher) — покупка ваучеров Genshin Impact, пакетная услуга

• APEX Legends (Xbox) — пополнение APEX Legends (платформа Xbox), пакетная услуга

• Roblox EU — пополнение Roblox (EU-регион), пакетная услуга

• Minecraft — пополнение Minecraft, пакетная услуга

• PUBG: New State — пополнение PUBG: New State, пакетная услуга

• Call of Duty: Warzone — пополнение Call of Duty Warzone, пакетная услуга

• Blizzard (USA) — пополнение сервисов Blizzard (регион USA), пакетная услуга

Каждый сервис представлен в API отдельным serviceCode и обрабатывается по единому сценарию интеграции. Добавление новых сервисов не требует изменений в логике интегратора — только использование нового кода сервиса.

Схема процесса оплаты зарубежного сервиса

Интеграция оплаты зарубежных сервисов в AlfaBit построена по трёхшаговой модели и полностью повторяет логику фиатного вывода.

Шаг 1:

Получить список фиатных способов вывода и приема по всем валютам

get

Header parameters

x-api-keystringRequired

Responses

200

Эндпоинт позволяет получить список доступных способов для вывода и приема фиатных средств для мерчанта.

application/json

400

Некорректный запрос

application/json

401

Необходимо авторизоваться для запроса

application/json

403

Недостаточно прав

application/json

500

Системная ошибка

application/json

get

/api/v1/integration/merchant/fiat-config

HTTPcURLJavaScriptPython

GET /api/v1/integration/merchant/fiat-config HTTP/1.1
Host: 
x-api-key: text
Accept: */*

{
  "message": "ok",
  "data": [
    {
      "name": "Все карты",
      "code": "RUB_SERVICE_32",
      "paymentMethod": "card",
      "currency": "RUB",
      "currencyOutCode": "USD",
      "paymentType": "deposit",
      "providersOut": [
        {
          "name": "Сбербанк",
          "code": "111000011",
          "aliasCode": "sber"
        }
      ],
      "providersIn": [
        {
          "name": "Сбербанк",
          "code": "111000011",
          "aliasCode": "sber"
        }
      ],
      "amountMin": "10.00",
      "amountMax": "1000.00",
      "feePercent": "1.5",
      "isPackageService": true,
      "requiredFields": [
        "first_name",
        "last_name"
      ],
      "categories": [
        "phone",
        "transfer_bank_card"
      ],
      "minFeeAmount": "10.00",
      "additionalPercentForMinFee": "2"
    }
  ],
  "count": 1
}

Шаг 2: Расчёт параметров оплаты сервиса (оценка)

Предварительный расчёт без создания реального заказа:

• проверяет корректность параметров,

• рассчитывает итоговую сумму и комиссию,

• возвращает параметры, которые будут использованы при создании платежа.

Результат используется для:

• отображения суммы пользователю,

• проверки лимитов,

• принятия решения о создании платежа.

Оценка входа фиатного сервиса

post

Header parameters

x-api-keystringRequired

Body

application/json

codestringOptional

Код способа вывода

Example: RUB_SERVICE_32

providerOutAliasCodestringRequired

Услуга

Example: ROBLOX100

requisitesstringRequired

Аккаунт зачисления

Example: [e-mail]

amountstringOptional

Сумма к зачислению (для непакетных услуг)

Example: 15

Responses

200

Успешная оценка входа фиатного сервиса

application/json

400

Некорректный запрос

application/json

401

Необходимо авторизоваться для запроса

application/json

403

Недостаточно прав

application/json

500

Системная ошибка

application/json

post

/api/v1/integration/orders/estimate-fiat-service-in

HTTPcURLJavaScriptPython

POST /api/v1/integration/orders/estimate-fiat-service-in HTTP/1.1
Host: 
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "code": "RUB_SERVICE_32",
  "providerOutAliasCode": "ROBLOX100",
  "requisites": "[e-mail]",
  "amount": 15
}

{
  "message": "ok",
  "data": {
    "rate": "5",
    "amount": "100"
  },
  "count": 1
}

Заказ на втором шаге ещё не создаётся.

Шаг 3: Создание заявки на оплату сервиса

Создание фиатного вывода сервиса

post

Header parameters

x-api-keystringRequired

Body

application/json

codestringOptional

Код способа вывода

Example: RUB_SERVICE_32

providerOutAliasCodestringRequired

Услуга

Example: ROBLOX100

requisitesstringRequired

Аккаунт зачисления

Example: [e-mail]

amountstringOptional

Сумма к зачислению (для непакетных услуг)

Example: 15

callbackUrlstring · min: 5Optional

Callback url для отправки хуков

Example: https://api.myip.com

commentstringOptional

Комментарий к переводу. Опциональное поле

Example: Оплата сервера за 07.2023

idempotencyKeystring · max: 255Optional

Ключ идемпотентности для предотвращения дублирования заявок при сетевых разрывах и состоянии гонки. Должен быть уникальным для каждого мерчанта.

Example: unique-request-id-12345

Responses

200

Успешное создание фиатного вывода сервиса

application/json

400

Некорректный запрос

application/json

401

Необходимо авторизоваться для запроса

application/json

403

Недостаточно прав

application/json

500

Системная ошибка

application/json

post

/api/v1/integration/orders/fiat-payment-service-order

HTTPcURLJavaScriptPython

POST /api/v1/integration/orders/fiat-payment-service-order HTTP/1.1
Host: 
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 239

{
  "code": "RUB_SERVICE_32",
  "providerOutAliasCode": "ROBLOX100",
  "requisites": "[e-mail]",
  "amount": 15,
  "callbackUrl": "https://api.myip.com",
  "comment": "Оплата сервера за 07.2023",
  "idempotencyKey": "unique-request-id-12345"
}

{
  "message": "ok",
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2026-01-26T17:25:09.626Z",
    "updatedAt": "2026-01-26T17:25:09.626Z",
    "deletedAt": "2026-01-26T17:25:09.626Z",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "merchantId": 6547,
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDTERC20",
    "currencyOutCode": "USDT",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "isDone": false,
    "apiMode": "ui",
    "risk": "24",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesMemoTag": "80576",
    "requisitesMemoTagIn": "80576",
    "requisitesMemoTagOut": "80576",
    "billingTag": "[e-mail]",
    "requisitesQrCode": "https://example.com/img-name.png",
    "assetInCode": "BTC",
    "assetOutCode": "USDT",
    "networkInCode": "ETH",
    "networkOutCode": "NEAR",
    "balanceAfter": "44",
    "balanceAccountAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "refundTxId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2026-01-26T17:25:09.626Z",
    "isImPayed": false,
    "isBayerPaysService": false,
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "requisitesInUrl": "https://example.com/requisites",
    "orderCurrencyType": "crypto",
    "paymentMethod": "sbp",
    "providerCode": "123123123123",
    "providerAliasCode": "text",
    "paymentSettingsName": "text",
    "providerName": "text",
    "amlReportExists": false,
    "minFeeTriggerAmount": "500",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "signature": "f9ced1e5a6fa7c5dc7ac5453c31eccef1f821153db9dc8f7eb81b28503d9772",
    "warningCode": "101",
    "giftCode": "4BAF32"
  },
  "count": 1
}