Раз­ра­бот­чи­кам

Текущее состояние

Сроки не публикуются до подтверждения: объявленная дата становится обязательством.

Что позволяет API

Список ниже описывает состав интерфейса, а не его текущую готовность: состояние каждого компонента — в таблице выше.

• Создавать P2P-операции
• Получать статусы транзакций
• Управлять жизненным циклом операции
• Получать уведомления через webhooks
• Проводить сверку операций
• Работать с доступными платёжными направлениями

Порядок интеграции

1. 01

   Получите доступ

   Оставьте заявку на доступ к инфраструктуре MONTRA.

2. 02

   Интегрируйте API

   Выполните интеграцию по документации API.

3. 03

   Протестируйте сценарий

   Проверьте платёжный сценарий в тестовой среде.

4. 04

   Пройдите процедуры

   Пройдите необходимые проверочные и документарные процедуры подключения.

5. 05

   Запустите переводы

   Запустите P2P-переводы на условиях партнёрского договора.

Принципы, на которых строится интерфейс

Это не описание витрины: спецификация пишется исходя из них, и отклонение от любого пункта считается изменением, а не деталью реализации.

1. REST поверх HTTPS, JSON

   Никакого собственного протокола. HTTP-методы, коды состояния и формат JSON используются в общепринятом значении, а не как декорация.

2. Идемпотентность повторного запроса

   Каждый изменяющий состояние запрос сопровождается ключом идемпотентности, который формирует партнёр. Если связь оборвалась и запрос отправлен повторно, вторая операция не создаётся — возвращается результат первой.

3. Вебхуки с подписью

   Каждое уведомление подписывается, и принимающая сторона может проверить подпись, не доверяя источнику на слово. Доставка повторяется до подтверждения, поэтому получатель должен быть готов увидеть одно и то же уведомление несколько раз.

4. Понятные коды ошибок

   Ошибка возвращается машиночитаемым кодом, человекочитаемым описанием и признаком того, имеет ли смысл повторять запрос. Ответа «ошибка» с HTTP 200 не будет.

5. Отдельная тестовая среда

   Изолированный контур со своими ключами и без реальных денег. Интеграция проверяется в нём до выдачи продуктивного доступа.

6. Версионирование и обратная совместимость

   Изменение, ломающее совместимость, выходит новой версией; предыдущая продолжает работать в течение заранее объявленного срока.

{
  "error": {
    "code": "…",        // машиночитаемый код
    "message": "…",     // описание для человека
    "retriable": false  // имеет ли смысл повторять
  }
}

Чего на этой странице нет и почему

• Базового адреса и работающих эндпоинтов — они не публикуются до фиксации контракта.
• Ключей доступа и тестовых данных — выдаются при открытии тестовой среды.
• SDK и готовых библиотек — не разрабатываются, пока спецификация не устоялась.
• Сроков — публикуется только подтверждённая дата.

Когда откроется тестовая среда

Рассылку мы не ведём и адреса не собираем. Если хотите узнать об открытии тестового контура — напишите нам, и мы сообщим, когда он будет готов.

Напишите: info@montra.kg

P2P-платежи · Участникам системы · Безопасность