Skip to main content

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

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

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

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


Контрагенты

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

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

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

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


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

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

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

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

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

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

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

Поля ответа