🔌 API Migom (v1)

REST-API для продавцов и интеграций: управляйте товарами, стоком, заказами и автовыдачей программно.

Базовый адрес

https://migom.org/api/v1/

Все ответы — JSON. Все эндпоинты работают только с данными владельца ключа.

🔑 Авторизация

Создайте ключ в кабинете: Кабинет → API и webhooks (после входа). Ключ показывается один раз — сохраните его.

Передавайте ключ одним из заголовков:

Authorization: Bearer <ВАШ_КЛЮЧ>
# или
X-API-Key: <ВАШ_КЛЮЧ>

GET/ping

Проверка ключа. Возвращает имя владельца.

curl -H "Authorization: Bearer $KEY" https://migom.org/api/v1/ping
→ {"ok": true, "user": "yourname"}

GET/listings · POST/listings

Список ваших товаров / создание нового.

title *	заголовок
service *	код сервиса (привязка стока)
price *	цена
currency	RUB (по умолчанию) / USDT / CNY
category	slug категории
description, is_active	необязательно

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title":"ChatGPT Plus","service":"chatgpt","price":"990","category":"ai-chatgpt"}' \
  https://migom.org/api/v1/listings
→ {"id": 42, "title": "ChatGPT Plus"}

GET/stock · POST/stock

Остатки по сервисам / добавить единицу своего легального стока (см. правила площадки).

service *	код сервиса
login , password	данные доступа
login_url	необязательно

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"service":"chatgpt","login":"a@b.c","password":"***"}' \
  https://migom.org/api/v1/stock
→ {"id": "…", "service": "chatgpt"}

GET/orders

Последние ваши продажи (до 200).

curl -H "Authorization: Bearer $KEY" https://migom.org/api/v1/orders
→ {"orders": [{"id": 7, "listing": "ChatGPT Plus", "amount": "990.00",
              "status": "completed", "created_at": "…"}]}

POST/fulfill

Зарезервировать единицу стока и получить одноразовую ссылку выдачи /d/<token> — для коннекторов: оплата прошла на внешней площадке, а товар выдаёт Migom.

service *	код сервиса
buyer_ref, external_ref	ваши метки заказа

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"service":"chatgpt","external_ref":"funpay#123"}' \
  https://migom.org/api/v1/fulfill
→ {"order_id":"…","token":"…","delivery_url":"https://migom.org/d/…"}   # 409 если стока нет

GET/delivery/verify · POST/delivery/verify

Верификация одноразового кода выдачи — для продавцов с собственным сайтом выдачи. После оплаты покупатель автоматически перенаправляется на ваш URL для авто-выдачи с параметрами ?code=TOKEN&order=N. Ваш сайт передаёт код сюда — Migom подтверждает заказ, код сгорает, деньги уходят в эскроу продавца.

code * токен из параметра ?code=

curl -H "Authorization: Bearer $KEY" \
  "https://migom.org/api/v1/delivery/verify?code=TOKEN"
→ {
    "ok": true,
    "order_id": "…",
    "order_number": "MG-00042",
    "listing_title": "Яндекс.Плюс 4 мес",
    "quantity": 1,
    "buyer_note": "",
    "paid_at": "2026-08-25T10:00:00Z"
  }

# Ошибки:
# {"error": "invalid_code"}   — код не существует
# {"error": "already_used"}   — код уже был использован
# {"error": "not_paid"}       — заказ ещё не оплачен
# {"error": "not_your_order"} — код от чужого заказа

Настройте URL авто-выдачи в карточке товара: Мои товары → Изменить → Ручная выдача → URL для авто-выдачи.

🔔 Webhooks

События (order.paid, dispute.opened, выдача и др.) можно получать на свой URL. Эндпоинты настраиваются в кабинете — Кабинет → API и webhooks.

← на главную