Создание платежа

Запрос

POST https://age.trading/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	Уникальный id вашего клиента (до 36 символов)
merchant_request_id*	string	Ваш ID заявки (до 50 символов)
initial_amount*	float/string/integer	Изначальная сумма заявки
success_redirect_url*	string	Ссылка для редиректа пользователя при успешном статусе заявки
failure_redirect_url*	string	Ссылка для редиректа пользователя при отмене заявки
webhook_url*	string	Адрес, на который по завершению заявки будет отправлен коллбек
payment_method	integer	Метод оплаты, который будет оторбажаться на странице оплаты для клиента

* — обязательое поле

Пример ответа

202 ACCEPTED

{
    "id": 123,
    "request_proprietary_id": "456789ab-89ab-cdf-0123-466789abcdf0",
    "merchant_request_id": "SDFG-TRR3U-HNGF-ST-UIKN",
    "initial_amount": "1000.00",
    "created": "2024-05-30T00:37:53.672461+03:00", 
    "redirect_url": "https://age.trading/payment?id=456789ab-89ab-cdf-0123-466789abcdf0",
    "payment_method": 1
}

Параметр	Тип	Описание
id	integer	Порядковый номер заявки (сервиса)
request_proprietary_id	UUID	Внутренний UUID4 заявки (сервиса)
merchant_request_id	string	Ваш ID заявки (до 50 символов)
initial_amount	string	Изначальная сумма заявки/выплаты
created	string	ISO timestamp создания заявки с часовым поясом
redirect_url	string	Ссылка на страницу оплаты
payment_method	integer	Метод оплаты, который будет оторбажаться на странице оплаты для клиента

Инфо

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

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

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

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

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

30 x 4^(банов подряд -1) минут.

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

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

Copy

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