Skip to main content

Создание заявки

Endpoint для создания заявки на прием платежа:

Обязательные параметры

Опциональные параметры


Контрагенты

Передача поля customerId при создании заявки активирует механизм Контрагентов: один и тот же клиент всегда платит на одни и те же реквизиты.

Как это работает

  1. Первая заявка с новым customerId: система выбирает подходящий реквизит из пула VIP-доступных реквизитов и закрепляет его за этим клиентом.
  2. Все последующие заявки с тем же customerId направляются строго на закреплённый реквизит. Клиент видит те же банковские реквизиты при каждой оплате — это повышает доверие и снижает риск отказа от платежа.
  3. Привязка постоянная, пока трейдер или администратор не отвяжет клиента от реквизита.

Пример запросач


Пример ответа (H2H интеграция)

HTTP Status: 201 Created При создании заявки без redirectUrls — стандартный H2H-ответ с реквизитами:
Поля isVip и customerId присутствуют в ответе всегда, даже для обычных не-VIP заявок. В этом случае isVip: false и customerId: null.

Пример ответа (Redirect интеграция)

HTTP Status: 201 Created При создании заявки с redirectUrls — ответ содержит paymentUrl для редиректа клиента на hosted-страницу оплаты:

Медленная выдача реквизитов (FTD_QR)

Касается только метода FTD_QR при прямой H2H-интеграции. Менять интеграцию не нужно — ответы те же, что и всегда.
Провайдер FTD_QR формирует платёжную ссылку до 15 секунд. Meridian ждёт за вас и возвращает обычный ответ: Единственное практическое отличие: создание заявки по FTD_QR может занять до 18 секунд. Убедитесь, что таймаут вашего HTTP-клиента не меньше 30 секунд — иначе вы разорвёте соединение до того, как придёт успешный ответ с QR.

Важные детали

  • Отсчёт времени на оплату начинается в момент выдачи реквизитов, а не в момент создания заявки, поэтому клиент всегда получает полное окно.
  • Сумма может измениться. Провайдер иногда корректирует сумму на несколько рублей, чтобы различить платежи по общему QR. Всегда используйте amount из ответа, а не тот, что вы отправляли.
  • Повторный запрос с тем же internalId безопасен. Если ваш клиент не дождался ответа, повторите запрос — вы получите ту же заявку с реквизитами, а не дубль.

Примеры ошибок

Ошибка: Нет доступных реквизитов

HTTP Status: 503 Service Unavailable Эта ошибка возникает когда все трейдеры с подходящими реквизитами заняты

Поля ответа