Выпускайте подарочные карты и eSIM одним вызовом
Единый каталог для всех типов товаров. Цена заказа рассчитывается в момент его создания и никогда не превышает заданный вами потолок, заказ идемпотентен относительно вашего предоплаченного кошелька, а вебхуки подписаны — поэтому повторы безопасны, а день запуска проходит скучно.
После одобрения рабочего пространства API-ключи выпускаются и управляются в панели мерчанта.
Как проходит заказ
Один короткий цикл — три вызова и подписанный вебхук, — и он одинаков для всех типов товаров.
Найти товар
GET /products
Ищите в едином каталоге подарочных карт, тарифов eSIM и пополнений по категории, стране или тексту — или обновляйте по id ровно те товары, которые продаёте.
Оформить заказ
POST /orders
Передайте товар: цена рассчитывается и заказ оформляется одним вызовом — никогда выше заданного вами потолка. Повторы с тем же ключом возвращают тот же заказ.
Получите вебхук
order.fulfilled
Подписанное событие сообщит вам, как только заказ будет выполнен. Никаких циклов опроса.
Показать код
POST /orders/{id}/fulfillment
Получайте коды и PIN-коды через отдельный эндпоинт с аудитом — без кеширования, каждое открытие кода учитывается.
Ваш язык, обычный HTTPS
Понятный и предсказуемый REST API: JSON на входе, JSON на выходе, заголовок X-Api-Key — и никакого SDK. Найти, заказать, открыть код: ваш первый заказ — это всего три вызова.
const BASE = "https://integration.xegora.com/api/v1";const response = await fetch(`${BASE}/orders`, { method: "POST", headers: { "X-Api-Key": process.env.XEGORA_API_KEY!, "Content-Type": "application/json", "Idempotency-Key": "order-10231", }, body: JSON.stringify({ clientReference: "po-10231", item: { productId, variantId, quantity: 1, currency: "USD" }, maximumTotal: 60.0, // the price your buyer saw }),});const order = await response.json();// 409 price_above_maximum carries quotedTotal — show the new price insteadconsole.log(order.status); // "reserved" — wait for "fulfilled", then reveal- Идемпотентные заказы
- Подписанные вебхуки
- API-ключи с ограниченными правами
- Предоплаченный кошелёк
Основные возможности API от начала до конца
Реальные форматы запросов и ответов — нажмите на любую строку. Выводы средств, история пополнений и изображения товаров дополняют API; полный справочник — на docs.xegora.com.
POST /api/v1/orders
Заказ за счёт предоплаченного кошелька: передайте товар, чтобы рассчитать цену и заказать его одним вызовом (с необязательным maximumTotal), или quoteId. Заголовок Idempotency-Key обязателен — повторный запрос возвращает тот же заказ. Право доступа: orders.create.
{
"id": "0198e000-1111-7abc-9def-222233334444",
"clientReference": "po-10231",
"status": "reserved",
"total": 58.50,
"currency": "USD",
"lines": [
{ "productId": "0198d72d-99d6-75a6-9f12-971050ba7a5f", "variantId": "0198d72d-a15b-7cbf-…",
"productName": "Everyday Digital Gift Card", "variantLabel": "50", "quantity": 1,
"unitPrice": 58.50, "currency": "USD", "faceValue": 50, "faceCurrency": "EUR" }
],
"createdAtUtc": "2026-09-05T12:01:02Z",
"updatedAtUtc": "2026-09-05T12:01:02Z"
}Скучная инфраструктура, которая вам на самом деле нужна
Всё, что нужно интеграции по выпуску кодов, чтобы выдержать реальную нагрузку: идемпотентность, подписи, ключи с ограниченными правами и кошелёк, который не уйдёт в минус.
Единый каталог
У подарочных карт, тарифов eSIM и пополнений телефона общая схема, единый поток цен и один процесс заказа. Интегрируйтесь один раз — и каждый новый товар Xegora автоматически станет доступен вам.
Идемпотентные заказы
И создание заказа, и получение кодов выполнения принимают заголовок Idempotency-Key. Сбой сети, тайм-аут, агрессивные повторы — отправляйте запрос сколько угодно раз, заказ будет ровно один.
Подписанные вебхуки
order.processing, order.fulfilled, order.failed, order.refunded и wallet.credited доставляются по HTTPS с подписью HMAC-SHA256 (X-Xegora-Signature), повторяются по схеме «хотя бы один раз» и дедуплицируются по стабильному X-Xegora-Event-Id.
Ключи с минимальными правами
У каждого ключа явный набор прав доступа — чтение каталога, получение предложений цены, заказы, чтение кошелька и операции с деньгами разделены — плюс необязательный белый список CIDR и срок действия. Отзыв ключа срабатывает мгновенно.
Предоплаченный кошелёк
Заказы резервируют средства на предоплаченном балансе, а списание происходит при выполнении; при сбое резерв снимается автоматически. Пополняйте баланс в блокчейне на постоянный адрес для пополнения, а неиспользованные средства выводите только на собственные зарегистрированные реквизиты для выплат.
Каталог, удобный для подбора
Ищите по категории, стране или тексту, оставляйте только фиксированные или произвольные суммы и обновляйте продаваемые товары по id одним вызовом — у каждого товара есть инструкция по активации и другие страны бренда, а цены указаны в вашей валюте продажи.
Оптовые цены без сюрпризов
Предложение цены — это и есть цена. Все остальные коммерческие условия согласовываются при настройке вашего рабочего пространства мерчанта.
- Оптовые цены на товары в вашей валюте продажи — с кошелька списывается ровно итоговая сумма предложения цены
- Никаких скрытых комиссий за вызовы; единый лимит — 120 запросов в минуту на рабочее пространство
- Тариф вашего рабочего пространства (плата за подключение и условия) согласовывается при онбординге мерчанта
- Условия вывода неиспользованных средств прозрачны — комиссия, сумма к получению и дата выплаты известны заранее
Готовы оформить первый заказ?
Подайте заявку на рабочее пространство мерчанта из своего аккаунта, дождитесь одобрения и выпустите в панели API-ключи с нужными правами — и до первого заказа останется всего три вызова. Полный справочник ждёт вас на docs.xegora.com.