Запросы, платежи и операции

Работа платёжной платформы строится на проведении платежей. Платежом в рамках платформы считается комплекс действий по выполнению заявки мерчанта на перевод денежных средств между ним и пользователем. Это может быть перевод средств от пользователя к мерчанту (и тогда платёж относится к оплате) либо от мерчанта к пользователю (и тогда платёж относится к выплате). При этом возвраты средств по проведённым оплатам рассматриваются в рамках оплат и не выделяются в отдельный тип платежей. Но вместе с тем к платежам проверка действительности платёжного инструмента, в рамках которой может выполняться условный (нулевой) перевод денежных средств или реальная (ненулевая) блокировка средств с последующей отменой.

Технически всё это сводится к следующим типам платежей:

  • разовая оплата, в одну или в две стадии — purchase;
  • повторяемая оплата со списаниями по запросу или с автоматическими списаниями — recurring (в некоторых случаях — purchase);
  • выплатаpayout;
  • проверка действительности платёжного инструмента — account verification.

Каждый платёж любого из этих типов должен быть инициирован со стороны мерчанта. Это может быть сделано через один из программных интерфейсов платёжной платформы (Gate API или Payment Page API) с помощью запроса или через пользовательский интерфейс (Dashboard) с помощью соответствующего действия, равносильного запросу.

При работе с Payment Page с помощью запросов можно открывать платёжную форму для проведения разовых и повторяемых оплат, а также для проверки действительности платёжных карт. В таких случаях после подтверждения пользователем согласия на проведение платежа в платформе создаётся объект payment и инициируется выполнение соответствующей операции, которая может быть единственной или первой из нескольких.

Рис.: Схема соответствия между запросами, платежами и операциями

Как правило, каждая последующая операция инициируется отдельным запросом со стороны мерчанта, однако в некоторых случаях операции могут быть инициированы автоматически на стороне платёжной платформы. Например, выполнение возврата средств по проведённой оплате необходимо инициировать через интерфейсы Gate или Dashboard, а списание предварительно заблокированных средств может выполняться автоматически по истечении заданного времени.

В рамках такой схемы работы через Payment Page можно выполнять следующие целевые действия:

  • проводить разовые оплаты в одну стадию,
  • блокировать средства в рамках разовых оплат в две стадии,
  • регистрировать повторяемые оплаты разных видов,
  • проверять действительность платёжных инструментов.

В последующих разделах представлена информация о типах платежей, доступных для инициирования через интерфейс Payment Page.