Flow работы с FirstPay

Взаимодействие с FirstPay происходит в соответствии с предоставленным API, основанным на системе "Postback". Далее ниже описаны последовательные шаги по взаимодействию с API, подробнее с каждым шагом можно ознакомиться в разделах слева на сайдбаре.

Регистрация мерчанта

Первое, что необходимо сделать - зарегистрироваться в системе FirstPay. Создать сущность своего мерчанта, указать необходимые параметры. Из важных параметров будет указание url: postback_url. На этот url система FirstPay будет присылать запросы о полученных платежах от мерчанта. Также этот url можно будет передавать параметром при создании платежа.

Авторизация

При регистрации для мерчанта будут также сгенерированы public и private ключи. Эти ключи необходимы для верификации запросов как со стороны мерчанта, так и со стороны FirstPay при postback запросах. Ко всем запросам от мерчанта необходимо будет прикладывать public key. Подробнее про работу с ключами в разделе Авторизация.

Получение платежных методов

После регистрации мерчанта в системе, к нему подключаются платежные методы. Список доступных методов будет доступен по методу из API. Каждый метод хранит необходимую информацию для пользователя, а также набор полей с валидацией, которые будет ожидать FirstPay при отправке запроса на создание платежа.

Отправление запроса с платежом

Так как взаимодействие с FirstPay происходит по API, то мерчант самостоятельно реализует на своей стороне UI, где пользователь будет заполнять поля, согласно выбранному платежному методу. После заполнения всех полей и подтверждения платежа со стороны пользователя, мерчант вызывает метод отправки платежа из API, передав необходимые параметры.

Отправление запроса с жалобой

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

Работа с postback запросами

На предыдущем шаге FirstPay получает от мерчанта запрос с платежом, который нужно подтвердить или отклонить. После валидации платежа FirstPay отправляет запрос на зарегистрированный url мерчанта (postback_url). Мерчант согласно контракту принимает информацию от FirstPay и производит дальнейшие действия.

Вспомогательные запросы

В системе FirstPay у мерчанта есть возможность использовать дополнительные API эндпоинты. Например, проверка баланса, проверка статуса платежа и т.д.