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

Создает заявку с передачей в ответе ссылки для перенаправления пользователя (страница оплаты), для обработки оплаты на собственном сайте см. H2H заявки.

Для коллбеков требуется настроить секретный ключ для HMAC подписи

Запрос

POST https://aispay.pro/api/requests/create/

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

{
    "client": "3264de6db1f90fc0db9c7cdf1034baf7",
    "merchant_request_id": "SDFG-TRR3U-HNGF-ST-UIKN",
    "initial_amount": "1000.00",
    "success_redirect_url": "https://example.com",
    "failure_redirect_url": "https://example.com",
    "webhook_url": "https://example.com",
    "payment_method": 1
}
Параметр
Тип
Описание

client

string [длина < 36]

уникальный ID вашего клиента

merchant_request_id

string [длина < 50]

уникальный UUID/ID вашей заявки

initial_amount

string [Decimal] ИЛИ float

Сумма заявки/выплаты

success_redirect_url

string

Ссылка для редиректа пользователя при успехе

failure_redirect_url

string

Ссылка для редиректа пользователя при отмене

webhook_url

string

адрес, на который по завершению заявки будет отправлен коллбек (Коллбек не будет отправлен если не настроен секретный ключ для HMAC подписи)

payment_method

integer [PaymentMethod]

Метод оплаты клиентом

Инфо

Заявки, созданные этим способом не учитывают наличие\отсутствие реквизитов: если при инициализации депозита не произошло ошибок, ответ всегда будет со статусом 202, даже если на платформе нет ни единого активного трейдера\реквизита.

Если требуется другое поведение при создании заявки, создавайте платежи через h2h методы: СБП, Счёт+БИК, Карта

Возможные коды ошибок: 400, 500

Поиск реквизитов происходит в фоне и актуальное состояние депозита отображается на странице оплаты. Обычно, поиск занимает 0.2-1 секунд, а максимальное время ожидания - 5 минут.

При повторном создании с уже существющим merchant_request_id, ответ вернётся с ошибкой 400.

Если у клиента clientна момент запроса будет иметься незакрытая заявка (ожидающая платежа), то в ответе будут возвращены данные предыдущей незакрытой заявки. Чтобы клиент мог создать новую заявку, ему сначла придётся отменить старую, или дождаться таймаута в 10 минут. Если у клиента все 4 последние заявки будут отменёнными, то при создании 5-ой клиент отправится в таймаут на

минут.

Пока клиент в бане, все созданные им заявки будут сразу же отменяться, минуя поиск реквизитов, а на странице оплаты будет уведомлен, что его платёж был отменён.

Администратор может выключить ваш трафик. При попытке создания платежа в таком случае, вернётся 400 с характерным сообщением

{"detail": "Administrator has disabled you."}

Last updated