Купить eSIM автономно. Строка активации в ответе.
Заказы на этом сайте оформляет человек: POST /api/public/create-order принимает запросы только со страниц магазина, остальным отвечает 403 turnstile_required. Агент может искать товары и читать цены через API, MCP и A2A, а купить их должен человек на странице товара. Примеры покупки через API ниже здесь не сработают.
Агент забронировал перелёт и отель. Пассажир садится в Стамбуле через 6 часов, а интернета на месте нет. 4 HTTP-запроса решают это без человека: последний ответ содержит строку активации LPA, которую телефон принимает напрямую.
Покрытие - 80+ стран. Тарифы различаются объёмом и сроком, цены лежат в ответе каталога, а заказ идёт через тот же API без аккаунта, что и всё остальное.
# 1. which countries have coverage
curl "https://kodshop.cloud/api/public/esim/countries"
# 2. bundles for the destination
curl "https://kodshop.cloud/api/public/esim/bundles?country=TR"
# -> [{"name":"...","data_gb":5,"duration_days":30,"price":...}]Как выглядит доставка
Ответ завершённого заказа содержит объект esim: iccid, qr_code_data (строка LPA вида LPA:1$rsp.example.com$TOKEN), название тарифа, объём и срок. Телефон или модем с eSIM принимает строку LPA напрямую.
Нужен QR картинкой, чтобы передать человеку? GET /api/public/order/{id}/esim-qr.png?token=... отрисует его на сервере. Агент передаёт ссылку и не генерирует QR сам.
Как выбрать тариф
Сначала список стран, потом тарифы по стране назначения. В каждой строке - data_gb, duration_days и цена. Каталог собран из 2 сетей, в каждой ячейке побеждает более дешёвая, так что агент выбирает тариф, а не поставщика.
Заказывайте с bundle_name ровно в том виде, в котором его вернул каталог, плюс country_code. Создание заказа сверяет тариф с живым каталогом до списания денег.
Оплата и сроки
Способы оплаты те же, что и во всём магазине: крипто-инвойс (USDT, минимум 10 RUB на заказ) или карта на сайте для человека. Большинство eSIM приходит в течение 5 минут после оплаты. Часть стран выдаёт профиль асинхронно: заказ висит в fulfilling, и цикл опроса ловит completed обычно за несколько минут.
Про eSIM подробнее
Как быстро приходит eSIM после оплаты?
Обычно в течение 5 минут. Часть направлений выдаёт профиль асинхронно: заказ висит в fulfilling и переключается в completed, когда профиль готов, как правило за минуты. Опрашивайте эндпоинт заказа, статус там первичен.
Агент получает QR-код или строку активации?
И то и другое. qr_code_data в ответе заказа - сырая строка LPA, а эндпоинт esim-qr.png отрисовывает тот же payload картинкой для людей.
Можно проверить покрытие до покупки?
Да. /api/public/esim/countries перечисляет страны, /api/public/esim/bundles?country=XX - конкретные тарифы с объёмом, сроком и ценой. Оба бесплатны и без авторизации.
А если трафик кончится?
Закажите ещё один тариф тем же способом. Заказы независимы: докупка - это вторая покупка из тех же 4 запросов.
Возврат автоматический, если профиль не выдался?
Нет. Сорвавшийся заказ показывает failed в ответе, а возврат делает человек: support@support.kodshop.cloud, укажите номер заказа.