REST API v1
API для пополнения мобильного: Автоматическая отправка на предоплаченные телефоны в 161 странах
Подключайтесь напрямую к 552 операторам и 4,330 продуктам с вашего сервера, приложения или платформы электронной коммерции. Те же цены MobileTopup, в среднем на 35% ниже номинальной стоимости, начните мгновенно с одного ключа.
- Базовый URL
- /api/v1
- Формат
- JSON
- Аутентификация
- X-Api-Key
- Ограничения по частоте запросов
- 300 запросов в минуту на ключ
Самый доступный API для пополнения для бизнеса
Те же самые низкие цены, как указано
Цены API точно совпадают. Все продукты стоят 30%+ ниже номинальной стоимости без комиссий за отправку. Пример: Philippines Globe 50 PHP (значение $0.78), цена API $0.54 (30% ниже номинала).
Начните мгновенно без одобрения
Зарегистрируйтесь и создайте свой API-ключ прямо в панели управления после первого пополнения кредита. Никаких контрактов или минимальных заказов.
Глобальное покрытие сразу
Отправляйте баланс и пакеты данных в 161 стран и на 552 операторов по всему миру с помощью одного и того же простого процесса.
Не беспокойтесь о дублировании платежей
Прикрепите номер вашего заказа к полю ссылки, даже если один и тот же запрос поступит дважды, мы обработаем его только один раз и вернем исходный результат.
Кредит возвращается мгновенно в случае сбоя
Если оператор отклоняет пополнение, сумма вашего платежа немедленно возвращается в виде кредита с четкими кодами ошибок.
Полные записи с квитанциями
Пополнения, отправленные через API, отображаются в истории вашей панели управления с квитанциями, кодами пополнения и номерами ссылок оператора.
Эндпоинты
Процесс: выберите страну, оператора и продукт, отправьте пополнение, затем проверьте статус и квитанции с помощью полученного кода пополнения.
Начало работы
- Шаг 1
Регистрация
Зарегистрируйтесь с помощью всего одного токена аккаунта. Никаких электронных писем или документов не требуется.
- Шаг 2
Пополнить баланс
Пополните кредит через 12 методов, включая USDT, USDC, BTC и ETH. Первое пополнение приносит бонусный кредит в зависимости от суммы.
- Шаг 3
Создать API-ключ
Создавайте API-ключи в вашей панели управления. Полные ключи показываются только один раз, сохраните их непосредственно в переменные среды вашего сервера.
- Шаг 4
Отправить пополнение
Отправляйте ключи через заголовок X-Api-Key и POST /v1/recharges для отправки пополнений.
Отправить пополнение (cURL)
curl -X POST https://mobiletopup.io/api/v1/recharges \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+639171234567","operator_id":"PH-GB","product_id":"ph-gb-a15c6dd","reference":"order-1042"}'Ответ (201)
{ "ok": true, "data": {
"code": "RC-7KQ2-M9XD-4PWA", "status": "completed",
"phone": "+639171234567", "operator_id": "PH-GB",
"receive": "50 PHP", "price": "0.54", "currency": "USD",
"reference": "order-1042", "duplicate": false
} }Часто задаваемые вопросы по API мобильного пополнения
Кто может использовать API?
Любой участник MobileTopup. Регистрация занимает 1 минуту с использованием только токена аккаунта. После обработки вашего первого пополнения кредита вы можете сразу же сгенерировать ключи API в вашем личном кабинете, без необходимости подачи заявки или одобрения.
Цены API такие же, как указано?
Да, идентичные. Те же продукты, те же цены, те же правила, что и при отправке пополнений из вашего личного кабинета. Все продукты стоят 30%+ ниже номинальной стоимости (в среднем экономия 35%), без дополнительных комиссий при отправке. Платежи списываются напрямую с вашего кредита.
Как предотвращаются дублирующиеся заказы?
Укажите ваш идентификатор заказа в качестве ссылки при отправке пополнений. Если сетевые проблемы вызывают дублирующиеся запросы, мы обработаем только первый и вернем его результат для последующих попыток ("duplicate": true).
Есть ли ограничения по частоте запросов?
Каждый ключ позволяет 300 запросов в минуту. Превышение этого лимита возвращает HTTP 429 с Retry-After (секунды). Соответственно распределяйте массовые запросы.
Что происходит, если пополнение не удается?
Если оператор отклоняет пополнение, ваш платеж мгновенно возвращается в виде кредита. Коды ошибок в ответе остаются неизменными для автоматизированной обработки.
Как защищены ключи API?
Ключи хранятся в хэшированном виде и отображаются только один раз при генерации. Регенерация ключей немедленно делает предыдущие недействительными. Мы рекомендуем использовать ключи только на стороне сервера.