English
РусскийПродавайте eSIM и номера своим клиентам
SIMAREA — это один аккаунт, один предоплаченный баланс и один API. Пополните баланс, выпустите ключ и заказывайте из своего магазина, бота или приложения. Ничего не нужно устанавливать, а для старта не нужен договор.
Впервые здесь? Вот что вы будете продавать
SIMAREA — это одна платформа с двумя продуктами: тарифы eSIM и виртуальные номера. Оба — в одном аккаунте. Оба оплачиваются с одного предоплаченного баланса в долларах США, а пополнить его можно криптовалютой.
Быть реселлером здесь — значит покупать с этого баланса по API-ключу. У вас остаются свой магазин, свои цены и свои клиенты. Мы поставляем номера и трафик и обеспечиваем выдачу; вы решаете, как выглядит продукт и сколько он стоит. Каждый заказ, оформленный вашим ключом, попадает в тот же аккаунт, в который вы можете войти и всё посмотреть.
Что можно продавать
Два продукта, по одному предложению на каждый. Каждая карточка ведёт на страницу с подробным описанием.
Тарифы eSIM
Мобильный интернет за границей без пластиковой SIM-карты, которую нужно присылать по почте. Клиент выбирает направление, платит посуточно или за тариф и устанавливает его, отсканировав QR-код на телефоне с поддержкой eSIM.
Смотреть направленияВиртуальные номера
Выделенная линия (не VoIP) с арендой на срок. Это один номер, который остаётся у клиента, пока он продлевает аренду; он принимает сообщения от любых сервисов и хранит всю историю сообщений.
Смотреть виртуальные номера| Продукт | Что получает клиент | Что выбирается | В API сегодня |
|---|---|---|---|
| Тарифы eSIM | Мобильный интернет на телефоне с поддержкой eSIM, установка по QR-коду | Направление и длительность поездки | Пока нет — см. примечание ниже |
| Виртуальные номера | Выделенная линия (не VoIP), которая хранит все полученные сообщения | Страна, сервис и срок аренды | Да — покупка, чтение и отмена |
Тарифы eSIM пока не продаются.
Цены на eSIM зависят от нерешённого вопроса с нашим поставщиком, поэтому ни у одного тарифа нет цены и ни один не выставлен на продажу — ни в API, ни на сайте. Маршрут пакетов работает, ваш ключ проходит аутентификацию, а список, который он возвращает, действительно пуст. Попытка купить eSIM сегодня будет отклонена, и деньги не спишутся.
Список направлений тем временем возвращается полностью, так что вы можете уже сейчас построить и протестировать сопоставление направлений и добавить пакеты в тот день, когда у них появятся цены. Виртуальные номера можно купить уже сегодня. В справочнике API то же самое сказано рядом с самим маршрутом.
Как устроена перепродажа сегодня
Ни портала, ни созвона для подключения, ни отдельной системы. Четыре простых факта, и ни один из них — не планы на будущее.
Один обычный аккаунт
Отдельной регистрации для реселлеров нет, и никто не должен вас одобрять. Вы создаёте такой же бесплатный аккаунт SIMAREA, как любой клиент, и он становится реселлерским в тот момент, когда вы выпускаете ключ.
Один предоплаченный баланс
Вы пополняете его в долларах США, криптовалютой. Всё, что вы покупаете потом, списывается с него — и через API, и на сайте. Нет счёта в конце месяца, и не нужно оформлять кредитную линию.
Один ключ на интеграцию
Ключи вы выпускаете сами, в панели API-ключей в своём аккаунте. Ключ показывается один раз, при создании, и прочитать его снова нельзя — поэтому сохраните его, прежде чем закрыть окно.
Один HTTP API
Ваш магазин, бот или приложение покупает, отправляя запрос. Кроме HTTP-клиента ничего не нужно устанавливать, не нужно внедрять SDK и подписывать договор до первого заказа.
С чего начать
Четыре шага. Все четыре вы можете сделать сами, сегодня, ни с кем не разговаривая.
Создайте аккаунт
Такой же бесплатный аккаунт SIMAREA, как у любого клиента. Нет заявки для реселлеров, минимального заказа и платы за открытие.
Пополните баланс
Внесите деньги один раз, криптовалютой. С этого предоплаченного баланса потом оплачивается каждая покупка — и через API, и на сайте.
Выпустите API-ключ
Откройте панель API-ключей в аккаунте и создайте ключ. Он показывается один раз и больше не читается, поэтому сохраните его, прежде чем закрыть окно.
Вызовите API
Передайте ключ как bearer-токен, прочитайте каталог и покупайте. В справочнике есть каждый маршрут, каждый код ошибки и рабочий пример для копирования.
Почему на этом можно строить бизнес
Каждое утверждение здесь — свойство работающей системы, а не намерение. Именно от этого зависит, можно ли оставить интеграцию без присмотра на ночь.
API тратит тот же баланс, что и вы
Нет отдельного реселлерского кошелька, который нужно пополнять, сверять и отслеживать. Маршрут баланса возвращает тот же предоплаченный баланс, который тратит сайт, а покупка, которая увела бы его в минус, отклоняется до того, как что-либо куплено, — и в отказе указана нехватка, так что пополнение можно автоматизировать.
Заказ через API — обычный заказ
Заказ, оформленный вашим ключом, — такая же запись, как заказ, оформленный вручную на сайте: тот же аккаунт, тот же список заказов, те же сообщения, та же кнопка отмены. Когда клиент спросит вас, что случилось, вы можете войти и посмотреть — вы видите сами данные, а не их копию.
Деньги не искажаются при передаче
Каждая сумма передаётся как целое число центов внутри строки, никогда как JSON-число, и каждая сумма — в долларах США. JSON-число — это число с плавающей точкой, а деньги его не переживают. Ваш клиент разбирает строку один раз, намеренно.
Повтор запроса никогда не спишет деньги дважды
Каждая покупка должна содержать заголовок Idempotency-Key, который выбираете вы; запрос без него сразу отклоняется. Повторите запрос с тем же ключом и тем же заказом — и получите первый заказ без повторного списания. Используйте этот ключ для другого заказа — и запрос будет отклонён, а не угадан.
Честные правила, включая то, которое вы предпочли бы не читать
Ничего не спрятано. Все пять правил заложены в код, поэтому работают одинаково и в загруженную ночь, и в спокойную.
Сбой возвращает деньги сам. Если виртуальный номер не удалось подключить после оплаты, деньги автоматически возвращаются на ваш баланс — вам не нужно это замечать или об этом просить. Номер, отменённый до прихода любого сообщения, возвращается так же. Один случай не возвращается, и лучше вы прочитаете о нём здесь, чем узнаете сами: арендованный номер, отработавший весь срок, — это завершённая продажа, поэтому его отмена возвращает ноль, а не ошибку.
Лимиты запросов привязаны к ключу, а не к аккаунту. Лимит считается для каждого ключа, в минуту. Выпустите по ключу на каждую интеграцию, и пиковый час в одной из них не замедлит остальные — счётчик назван по ключу, а не по вам. Каждый успешный ответ сообщает, сколько осталось в вашем окне и когда оно обнулится, так что корректному клиенту не нужно гадать.
Отозванный ключ перестаёт работать со следующего же запроса. Ничего о ключе нигде не кешируется ни на какой срок — ни на минуту, ни на секунду. Это сознательная цена, которую мы платим за каждый запрос, потому что «отозван немедленно» незаметно превращается в «отозван, когда истечёт кеш», как только кто-нибудь начнёт оптимизировать. Отзовите утёкший ключ — и он мёртв, а не умирает.
Мы никогда не называем своих поставщиков. Названия поставщиков и операторов не встречаются ни в одном поле ни одного ответа API, поэтому ничто из того, что вы передаёте клиенту, не может их содержать. Какой поставщик выполняет заказ — наша задача, которую мы решаем и перерешаем; вашей интеграции не нужно это моделировать, и ваш клиент этого никогда не увидит.
Ключа в URL не бывает никогда. Ключ передаётся в заголовке Authorization, и запасного варианта через строку запроса нет. Строки запроса оседают в журналах веб-серверов, в истории браузера, в заголовках Referer при переходах по внешним ссылкам и в отчётах об ошибках каждого прокси по пути — ключ, попавший в журнал, уже утёк.
Продажа продуктов SIMAREA регулируется нашими условиями использования. Если вы хотите зарабатывать, приводя к нам клиентов, а не перепродавая своим, партнёрская программа — совсем другое устройство: ваш читатель покупает у SIMAREA, а вы получаете комиссию, поэтому вам не нужно пополнять баланс, назначать цену и отвечать на вопросы поддержки.
Для кого это
Интегрироваться может любой. Но вот четыре типа бизнеса, которым это подходит лучше всего.
Интернет-магазины и маркетплейсы
У вас уже есть оформление заказа и клиенты, которые ему доверяют. Добавьте номера и интернет к ассортименту, и пусть ваш процесс заказа вызывает наш — по цене, которую назначите вы.
Агентства и команды по работе с аккаунтами
Команды, которые открывают и ведут множество аккаунтов для клиентов. Один баланс покрывает всех, а каждый номер и каждое сообщение видны в одном месте, а не в таблице.
Боты и автоматизация
Бот в Telegram, бот в Discord или внутренний скрипт. Купить номер — один запрос, отменить — другой, поэтому бот может предлагать весь продукт без панели управления за спиной.
SaaS-продукты
Продукты, которым нужен номер для подтверждения внутри собственного онбординга, тестирования или QA. Покупайте номер в нужный момент и автоматически получайте деньги обратно, если код так и не пришёл.
Что мы ещё не решили
Прайс-листа для реселлеров нет, и мы не станем его выдумывать.
Три коммерческих вопроса пока открыты: объёмные цены, условия расчётов и обязательства поддержки. Ни один из них не согласован, поэтому ни один не опубликован ни здесь, ни где-либо ещё на сайте. Всё, что сказано выше о работе продукта, — реально и работает. Всего, что касается оплаты для реселлеров, пока не существует.
Вы всё равно можете начать сегодня — по обычным ценам, которые уже видите на сайте, и в API ничего не изменится, когда появятся условия. Если хотите договориться о чём-то напрямую уже сейчас, напишите на [email protected] и расскажите, что и примерно в каком объёме планируете продавать.
Когда условия будут согласованы, мы опубликуем их на этой странице и в наших условиях использования. До тех пор, пожалуйста, не рассматривайте эту страницу как оферту.
Поддержка и что дальше
Напишите на [email protected]. Расскажите, что хотите продавать, какой из двух продуктов вам нужен и где ваши клиенты. Этого достаточно, чтобы мы дали полезный ответ, а не брошюру. Если вы уже знаете, что вам нужно что-то сверх стандартной схемы, скажите об этом в первом же письме.
Чтобы начать, ждать ответа не нужно. Создайте аккаунт, пополните баланс, выпустите ключ и прочитайте справочник. API работает и покупает через ровно тот же код, что и кнопки самого сайта, — второго, урезанного пути для реселлеров нет, поэтому и ошибки исправлять одни, и возвратам доверять одним.
Мы не согласовали обязательства по времени ответа, поэтому и не публикуем их. Это то же правило, что и для всего остального на этой странице: если что-то не решено, оно не появится здесь под видом обещания.
Всё, что нужно для старта, уже включено
Аккаунт, баланс, ключ и один HTTP API. В справочнике есть каждый маршрут, каждый код ошибки и пример, который можно вставить в терминал.
Вопросы реселлеров
Что такое SIMAREA?
SIMAREA — это одна платформа с двумя продуктами связи: тарифы eSIM для мобильного интернета за границей и виртуальные номера, которые арендуются как выделенная линия.
Оба находятся в одном аккаунте и оплачиваются с одного предоплаченного баланса в долларах США. Это верно и для человека, который покупает один номер на сайте, и для бизнеса, который покупает тысячи через API, — это один и тот же аккаунт и один и тот же баланс.
Как стать реселлером?
Создайте обычный аккаунт SIMAREA, пополните его и выпустите API-ключ в панели API-ключей этого аккаунта. Отдельной регистрации для реселлеров нет, заявку писать не нужно, и никто не должен вас одобрять.
С этого момента ваша интеграция может покупать. С вашей стороны не нужно устанавливать ничего, кроме HTTP-клиента, и подписывать договор перед стартом тоже не нужно.
Как оплачивать то, что я продаю?
С предоплаченного баланса. Вы пополняете его криптовалютой, и каждая покупка вашего ключа списывается с него. Нет счёта в конце месяца и нет кредитной линии.
Это тот же баланс, который тратит сайт, поэтому его можно посмотреть, войдя в аккаунт, или запросить через API. Если его не хватает, покупка отклоняется до того, как что-либо куплено, а в отказе точно указано, сколько не хватает, — этого достаточно, чтобы автоматизировать пополнения.
Есть ли скидка для реселлеров или цена за объём?
Пока нет, и мы не будем делать вид, что есть. Объёмные цены, условия расчётов и обязательства поддержки не согласованы, поэтому графика скидок нет ни на этой странице, ни где-либо ещё на сайте. Всё, что здесь сказано о работе продукта, — правда; о том, сколько платит реселлер, пока просто нечего сказать.
Вы можете начать сегодня по обычным ценам, которые уже видите, и в API ничего не изменится, когда условия будут согласованы. Если хотите договориться о чём-то напрямую уже сейчас, напишите на [email protected] и расскажите, что и примерно в каком объёме планируете продавать.
Можно ли продавать тарифы eSIM через API сегодня?
Нет, пока нельзя. Цены на eSIM зависят от нерешённого вопроса с нашим поставщиком, поэтому ни у одного тарифа нет цены и ни один не выставлен на продажу. Маршрут пакетов намеренно возвращает пустой список — ваш ключ работает, маршрут работает, а список действительно пуст. Попытка купить eSIM сегодня будет отклонена, и деньги не спишутся.
Список направлений при этом возвращается полностью, поэтому вы можете уже сейчас построить и протестировать сопоставление направлений и добавить пакеты в тот день, когда у них появятся цены. Виртуальные номера можно купить уже сегодня.
Что не даст повтору запроса списать деньги дважды?
Каждая покупка должна содержать заголовок Idempotency-Key, который выбираете вы, а запрос без него отклоняется. Мы не генерируем ключ за вас, и в этом весь смысл: ключ, придуманный сервером, новый при каждой попытке, так что каждый повтор становился бы вторым заказом — а в этом продукте это второе списание и второй номер.
Отправьте тот же ключ с тем же заказом ещё раз — после таймаута или обрыва соединения — и получите первый заказ без повторного списания. Отправьте тот же ключ с другим заказом — и запрос будет отклонён, а не получит в ответ прежний заказ. Повторять запрос всегда безопасно; ошибка всегда заметна.
Что будет, если заказ не удался или SMS так и не пришло?
Деньги сами вернутся на ваш баланс. Виртуальный номер, который не удалось подключить, возвращается автоматически, а номер, отменённый до прихода любого сообщения, тоже возвращается. Ни в одном из случаев не нужно открывать тикет или следить за этим.
Один случай намеренно не возвращается: арендованный номер, отработавший весь срок. Это завершённая продажа, а не невыполненная доставка, поэтому его отмена возвращает ноль, а не ошибку. Номер, на который уже пришло SMS, тоже нельзя вернуть — код, за который вы заплатили, пришёл.
Узнают ли мои клиенты, что номера поставляет кто-то другой?
От нас — нет. Названия поставщиков и операторов не встречаются ни в одном поле ни одного ответа API, поэтому ничто из того, что вы передаёте клиенту, не может их содержать. Мы проверяем это автоматической проверкой, а не полагаемся на свою память.
Как представлять продукт — решать только вам. Мы не выходим к вашим клиентам и не связываемся с ними.
Что делать, если ключ утёк?
Отзовите его в панели API-ключей. Отзыв срабатывает со следующего же запроса, потому что ничего о ключе не кешируется — нет промежутка, в котором отозванный ключ продолжает покупать.
Выпускайте по ключу на каждую интеграцию, а не один ключ на всё, — тогда отзыв утёкшего ключа остановит одну интеграцию, а не все. Лимиты запросов тоже считаются по ключу, так что отдельные ключи ещё и не дают загруженной интеграции замедлять остальные.
Есть ли вебхуки?
В этой версии нет. Вы опрашиваете созданный заказ, и каждый успешный ответ содержит ваше окно лимита запросов, так что вы можете решать, как часто спрашивать, не гадая.
Заказ, который вы получаете, всегда актуален: он заново читается из базы данных, а не собирается из того, что было верно мгновение назад, поэтому сообщение, пришедшее в промежутке, будет видно.