Расщепление платежей

Расщепление платежа – это способ, при котором оплата, совершаемая потребителем, разбивается на уровне платежного агента, и он распределяет поступившие средства по поставщикам услуг.

1.png

Схема "Расщепление платежей"

1. Пользователь заходит на веб-сайт услуги, указывает сумму, которую хочет оплатить. Выбирает "оплата банковской картой".

2. Пользователь нажимает на кнопку "оплатить" и инициирует вызов платежного виджета. В клиентской части веб-сервиса формируется набор параметров вызова виджета и передаётся к серверной части.

3. На стороне платёжной платформы выполняются подготовка виджета с учётом параметров вызова.

4. На стороне платежной платформы Vepay происходит расщепление платежа (платежный агент сам задает сумму платежа на каждого партнера, указывая в параметрах его id).

5. Платёжная форма отображается в пользовательском интерфейсе. Пользователь вводит реквизиты карты для оплаты, нажимает оплатить.

6. От виджета к платёжной платформе отправляется запрос на выполнение целевого действия с учётом всех данных, введённых пользователем.

7. На стороне платёжной платформы выполняется регистрация номера карты (если требуется) и регистрация платежа. Данные передаются в платёжную среду.

8. В платёжной среде открывается страница банка-эмитента. Пользователь подтверждает платеж с помощью кода из sms. Нажимает "оплатить". Выполняются проверка карты и обработка платежа. В платёжную платформу поступает информация о результате.

9. В платёжной платформе обрабатывается итоговая информация. Происходит отправка частей платежа получателям.

10. Платежному агенту на заданный URL (если указан колбэк) отправляется программное оповещение о платеже.

11. Происходит перенаправление пользователя на страницу клиента в соответствии с результатом оплаты.

 

Описание API Расщепления платежей

1. На метод https://vepay.online/merchant/pay-parts поступает запрос, формата:


{
  "type":1,
  "extid":"166224",
  "descript":"descript..",
  "successurl":"http://example.com/s.php",
  "canselurl":"http://example.com/e.php",
  "failurl":"http://example.com/e.php",
  "timeout":50,
  "fullname":"Test TEst Test1",
  "document_id":"Test document",
  "parts":[
    {
      "merchant_id":1,
      "amount":800
    },
    {
      "merchant_id":2,
      "amount":200
    }
  ]
}

Где указывается идентификатор услуги поставщика.

2. Возвращается ответ:


{
  "status":1,
  "id":2000049,
  "url":"http://vepay.online/pay/form/2000049",
  "message":""
}

3. Пользователь переходит по ссылке, указывает данные карты и оплачивает заказ.

4. В случае успеха, во время распределения средств по счету, у счета проверяется наличие частей и распределение осуществляется согласно их содержанию.

Пользовательский сценарий можно посмотреть в разделе: Платежный виджет

Параметры запроса:

Параметры Значение
type (опционально) Тип шлюза - 0 – ECOM, 1 – ЖКХ
extid Внешний идентификатор запроса от платежного агента, который инициирует запрос
descript Описание платежа 
successurl Адрес Url для возврата после завершения платежа (успех)
cancelurl Адрес Url для возврата после отказа от оплаты
failurl Адрес Url для возврата после завершения платежа (ошибка)
timeout Тайм-аут ожидания оплаты, от 10 до 60 минут
fullname Полное имя плательщика
merchant_id
Идентификаторы партнеров (поставщиков услуг) между которыми будет поделен платеж
document_id Идентификатор документа. Указывается для основания платежа
amount Cумма платежа, руб

Параметры ответа:

Параметры Значение
status Статус (0 – ошибка 1 - принят)
id идентификатор запроса
url Cсылка для перехода на форму оплаты
message Сообщение ошибки
Войти в кабинет
Техническая поддержкаinfo@vepay.online
Контактный телефон+7 499 954-84-95
Присоединяйтесь
VKInstagramFacebookTelegramYandex Zen