Запросы, платежи и операции
Работа платёжной платформы строится на проведении платежей. Платежом в рамках платформы считается комплекс действий по выполнению заявки мерчанта на перевод денежных средств между ним и пользователем. Это может быть перевод средств от пользователя к мерчанту (и тогда платёж относится к оплате) либо от мерчанта к пользователю (и тогда платёж относится к выплате). При этом возвраты средств по проведённым оплатам рассматриваются в рамках оплат и не выделяются в отдельный тип платежей. Но вместе с тем к платежам проверка действительности платёжного инструмента, в рамках которой может выполняться условный (нулевой) перевод денежных средств или реальная (ненулевая) блокировка средств с последующей отменой.
Технически всё это сводится к следующим типам платежей:
- разовая оплата, в одну или в две стадии —
purchase
; - повторяемая оплата со списаниями по запросу или с автоматическими списаниями —
recurring
(в некоторых случаях —purchase
); - выплата —
payout
; - проверка действительности платёжного инструмента —
account verification
.
Каждый платёж любого из этих типов должен быть инициирован со стороны мерчанта. Это может быть сделано через один из программных интерфейсов платёжной платформы (Gate API или Payment Page API) с помощью запроса или через пользовательский интерфейс (Dashboard) с помощью соответствующего действия, равносильного запросу.
При работе с Payment Page с помощью запросов можно открывать платёжную форму для проведения разовых и повторяемых оплат, а также для проверки действительности платёжных карт. В таких случаях после подтверждения пользователем согласия на проведение платежа в платформе создаётся объект payment
и инициируется выполнение соответствующей операции, которая может быть единственной или первой из нескольких.
Как правило, каждая последующая операция инициируется отдельным запросом со стороны мерчанта, однако в некоторых случаях операции могут быть инициированы автоматически на стороне платёжной платформы. Например, выполнение возврата средств по проведённой оплате необходимо инициировать через интерфейсы Gate или Dashboard, а списание предварительно заблокированных средств может выполняться автоматически по истечении заданного времени.
В рамках такой схемы работы через Payment Page можно выполнять следующие целевые действия:
- проводить разовые оплаты в одну стадию,
- блокировать средства в рамках разовых оплат в две стадии,
- регистрировать повторяемые оплаты разных видов,
- проверять действительность платёжных инструментов.
В последующих разделах представлена информация о типах платежей, доступных для инициирования через интерфейс Payment Page.