Apollopayment API
Русский
Русский
  • Авторизация
  • Подпись запросов
  • Список кодов ошибок
  • Webhooks
  • IFrame ордер
  • Виджет приема оплаты
  • Telegram MiniApp
  • API Reference
    • Базовый функционал
      • Проверка корректности подписи x-api-signature
      • Получение монет доступных для приема/отправки транзакций
      • Запрос текущей цены
      • Поиск операции по TX-хешу
      • Проверка корректности адреса
      • Получение истории транзакций
    • Авансовый счет
      • Получение аккаунтов текущего пользователя
      • Получение аккаунта по его ID
      • Получение адреса для пополнения баланса аккаунта
    • Блокчейн-адреса
      • Поиск по ID
      • Отслеживание транзакций
      • Поиск по адресу
      • Мета-данные
      • Транзакции адреса
      • Последняя транзакция адреса
      • Получение списка PayIn адресов
      • Получение списка бизнес адресов
      • Получение рекуррентных адресов
      • Получение списка PayOut адресов
      • Создание нового адрес бизнес кошелька
      • Создание нового адрес PayOut кошелька
    • Персональные адреса
      • Создание пользователя
      • Получение адреса
      • Получение списка адресов
      • Получение пользователя
      • Добавление доверенного адреса
      • Получение списка доверенных адресов
      • Удаление доверенного адреса
    • Ордера
      • Создание ордера
      • Получение информации об ордере
      • Получение списка ордеров
    • Выводы
      • Получение комиссии для проведения вывода
      • Синхронный вывод
      • Асинхронный вывод
      • Получение информации о выводе
    • Счета
      • Создание счета на оплату
      • Запрос получения информации об инвойсе
      • Получение списка счетов
    • Авто обмены
      • Создание авто-обмена
      • Поиск авто-обмена по ID
    • Выплаты 2.0
      • Создание авто-вывода
      • Поиск авто-вывода по ID
      • Дополнительное подтверждение вывода
    • Мост
      • Получение лимиов для кроссчейн перевода
      • Получение информации о кроссчейн переводе
      • Формирование токена комисси
      • Создание кроссчейн перевода
    • Обмены
      • Получение лимитов для кроссчейн обмена
      • Получение информации о кроссчейн обмене
      • Формирование токена комисси
      • Создание кроссчейн обмена
    • Рекуррентные платежи
      • Создание платежной связки
      • Получение платежной связки
      • Получение платежных связок по пользователю
      • Отключение платежной связки
      • Создание подписки
      • Получение подписки
      • Отключение подписки
      • Создание платежа
    • KYT
      • Проверка рисков транзакции
      • Проверка рисков вывода
      • Проверка риска вывода на указанный адрес
    • Партнерское API
      • Создание пользователя
      • Получение пользователя
      • Получение всех пользователей
      • Создание организации
      • Получение списка организаций
      • Получение авансовых балансов пользователя
      • Пополнение авансового баланса пользователя
      • Получение общих тарифов
      • Создание/обновление индивидуального тарифа
      • Получение индвидуальных тарифов
      • Создание API ключа
      • Получение API ключей
      • Удаление API ключа
    • Вебхуки
      • Получение вебхука
      • Получение вебхука (расширенный)
    • Сиротские транзакции
      • Получение транзакции
      • Получение списка транзакций
      • Получение токена комиссии
      • Вывод
    • Адресная книга
      • Добавление адреса
      • Удаление адреса
      • Обновление адреса
      • Получение списка адресов
Powered by GitBook
On this page
  • Параметры
  • Подключение
  • 1. Платежная кнопка через скрипт
  • Подключение скрипта
  • Параметры тэга платежной кнопки
  • 2. Прямая ссылка

Telegram MiniApp

Теперь в Telegram можно принимать криптовалютные платежи через сеть TON с помощью нашего мини-приложения. Оно легко подключается, позволяет работать с клиентами прямо в Telegram и открывает новые возможности для бизнеса в экосистеме TON.


Параметры

Для управления создаваемым платежом доступны следующие параметры:

Параметр
Обязательный
Описание

apiKey

НЕТ

Публичная часть API-ключа (используется для подписи вебхуков о платеже)

orderId

ДА

Идентификатор платежа

description

НЕТ

Описание платежа

organizationId

ДА

Id организации

amount

НЕТ

Сумма к оплате

payerEmail

НЕТ

Почта плательщика

returnUrl

НЕТ

URL возврата после успешного платежа

API ключ вы можете получить в личном кабинете в разделе интеграции


Подключение

Доступно два удобных способа подключения нашего мини-приложения для приема крипто платежей.

1. Платежная кнопка через скрипт

Вы можете интегрировать платежную систему на ваш сервис или мини-приложение, добавив готовый скрипт кнопки. Это удобное решение, которое позволяет быстро настроить процесс оплаты через сеть TON в самых используемых кошельках.

Подключение скрипта

Для работы платежной кнопки нужно подключить скрипт на ваш сервис

<script src="https://cdn.apollopayment.io/images/PaymentButtonMiniApp.js"></script>

Пример тега платежной кнопки с необходимыми параметрами:

<payment-button
    data-orderid="test"
    data-organizationid="your_organization_id"
    data-description="test"
    data-payeremail="email@test.mail"
    data-apikey="your_public_api_key"
    data-label="Оплатить"
    data-accentcolor="red"
    data-returnurl="https://example.com/success"
>
</payment-button>

Обратите внимание! data-атрибуты должны быть написаны в lowercase


Параметры тэга платежной кнопки

data-label

Текст, отображаемый на кнопке.

Пример: data-label="Оплатить"

data-accentcolor

Цвет кнопки. Доступные значения: purple, orange, green, red, yellow, blue

2. Прямая ссылка

В качестве альтернативы можно использовать прямую ссылку, которую необходимо вставить на ваш сервис или мини-приложение. Эта ссылка перенаправит пользователя на наше приложение оплаты внутри Telegram.

Для того чтобы открыть мини-приложение оплаты, вам необходимо сформировать из параметров base64 строку и вставить в query-параметр startapp

Пример формирования base64 строки на JavaScript:

const encodeObjectToUrlString = (obj) => { 
  const jsonString = JSON.stringify(obj); // Преобразуем объект в строку JSON 
  return encodeURIComponent(btoa(jsonString)); // Кодируем в Base64 и делаем безопасным для URL 
};

// Пример использования:
const params = {
  apiKey: "apiKey",
  orderId: "Payment#1234",
  description: "Some payment description",
  organizationId: "organizationId",
  payerEmail: "email@mail.ru",
  returnUrl: "https://example.com/success"
};

const base64Params = encodeObjectToUrlString(params);

Пример ссылки:

https://t.me/apollopayment_app_bot/apollopayment?startapp=${base64Params}

Ссылку доступно открыть через window.open функцию

window.open(`https://t.me/apollopayment_app_bot/apollopayment?startapp=${base64Params}`)

Вставьте результат из функции в base64Params в строке.


Доступные валюты для оплаты USDT (TON), TON (TON)

Обратите внимание! При открытии мини-приложения оплаты, ваше мини приложение закроется

PreviousВиджет приема оплатыNextБазовый функционал

Last updated 5 months ago