Создание заявки
Endpoint для создания заявки на прием платежа:Обязательные параметры
Опциональные параметры
Контрагенты
Передача поляcustomerId при создании заявки активирует механизм Контрагентов: один и тот же клиент всегда платит на одни и те же реквизиты.
Как это работает
- Первая заявка с новым
customerId: система выбирает подходящий реквизит из пула VIP-доступных реквизитов и закрепляет его за этим клиентом. - Все последующие заявки с тем же
customerIdнаправляются строго на закреплённый реквизит. Клиент видит те же банковские реквизиты при каждой оплате — это повышает доверие и снижает риск отказа от платежа. - Привязка постоянная, пока трейдер или администратор не отвяжет клиента от реквизита.
Пример запросач
Пример ответа (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безопасен. Если ваш клиент не дождался ответа, повторите запрос — вы получите ту же заявку с реквизитами, а не дубль.