Buy Now Pay Later

Обзор

Введение

Buy Now Pay Later — метод, позволяющий проводить платежи в фунтах стерлингов с использованием рассрочки в Великобритании. Условия рассрочки определяются в результате взаимодействия пользователя и провайдера. Для этого метода в платёжной платформе ecommpay поддерживаются оплаты.

В этой статье представлена информация о работе с методом Buy Now Pay Later: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач.

Характеристика


Тип платёжного метода	банковские платежи
Платёжные инструменты	платёжные карты
Регионы использования	GB
Валюты платежей	GBP
Конвертация валют	на стороне ecommpay
Разовые оплаты	+
Повторяемые оплаты	–
Полные возвраты	+
Частичные возвраты	+
Выплаты	–
Опротестования	–
Особенности	возвраты выполняются только через заявки в сервисе провайдера, при этом рассмотрение отдельной заявки занимает не более одного рабочего дня, но все заявки обрабатываются последовательно и каждая очередная заявка принимается только после обработки предыдущей
Организация и стоимость подключения	по согласованию с курирующим менеджером ecommpay

Схема работы

В проведении отдельного платежа с использованием метода Buy Now Pay Later задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также технические средства сервиса провайдера.

Основные операции

Для проведения платежей и выполнения операций с использованием метода Buy Now Pay Later могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page, Gate и Dashboard (с применением платёжных ссылок). При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.

При работе с методом Buy Now Pay Later, независимо от используемых интерфейсов, актуальны следующие свойства и ограничения.


	Суммы, GBP		Время ¹
	минимум	максимум	базовое	предельное
Оплаты	1,00	30 000,00	5 минут	24 часа

Прим.:

Базовое и предельное время определяются следующим образом:
- Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя (там, где они необходимы). Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа (подробнее).
- Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус decline. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки ecommpay.

Сценарии использования

Проведение оплат с использованием метода Buy Now Pay Later осуществляется перенаправлением пользователей к сервису провайдера.

Сценарии выполнения операций через основные интерфейсы платёжной платформы соответствуют представленным на схемах. При использовании дополнительных возможностей (таких как платёжные ссылки) сценарии выполнения операций методом Buy Now Pay Later соответствуют специфике этих возможностей.

Оплаты через Payment Page

Общая информация

Для проведения оплаты через Payment Page с использованием метода Buy Now Pay Later со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. Полная схема проведения оплаты выглядит следующим образом.

Рис. 3. Проведение оплаты через Payment Page. Описание шагов

Пользователь на стороне веб-сервиса инициирует оплату.
От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение оплаты через Payment Page.
Запрос на проведение оплаты поступает в платёжную платформу.
В платёжной платформе выполняется приём запроса, с проверкой наличия обязательных параметров и корректной подписи.
Осуществляется подготовка к открытию платёжной формы согласно параметрам проекта и вызова.
Пользователю отображается платёжная форма.
Пользователь выбирает для оплаты метод Buy Now Pay Later.
В платёжную платформу передаётся запрос на проведение оплаты с использованием метода Buy Now Pay Later.
В платёжной платформе выполняются обработка полученного запроса и его отправка в сервис провайдера.
В сервисе провайдера выполняется обработка запроса на оплату.
От сервиса провайдера к платёжной платформе передаются данные для перенаправления пользователя к сервису провайдера.
Данные для перенаправления пользователя передаются к Payment Page.
Пользователь перенаправляется к сервису провайдера.
Пользователь выполняет необходимые действия для регистрации договора на рассрочку и оплаты.
В сервисе провайдера выполняется обработка информации.
Информация о результате отображается пользователю в сервисе провайдера.
Пользователь перенаправляется к Payment Page.
От сервиса провайдера к платёжной платформе направляется информация о результате оплаты.
От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
От платёжной платформы к Payment Page направляется информация о результате оплаты.
Информация о результате оплаты отображается пользователю на Payment Page.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом Buy Now Pay Later через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье Организация взаимодействия.

Формат запросов

При формировании запросов на открытие платёжной формы с применением метода Buy Now Pay Later необходимо учитывать следующее:

Должен использоваться базовый минимум параметров, обязательный для любого платежа:
- project_id — идентификатор проекта, полученный от ecommpay при интеграции;
- payment_id — идентификатор платежа, уникальный в рамках проекта;
- payment_currency — код валюты платежа в формате ISO-4217 alpha-3;
- payment_amount — сумма оплаты в дробных единицах валюты;
- customer_id — идентификатор пользователя в рамках проекта.
Должен использоваться базовый минимум параметров: project_id, payment_id, payment_currency, payment_amount, customer_id.
Должны указываться имя и фамилия пользователя в параметрах customer_first_name и customer_last_name.
Для предварительного выбора метода Buy Now Pay Later необходимо указывать код этого метода в параметре force_payment_method — bnpl-humm.
Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page (подробнее).
После указания всех целевых параметров необходимо составлять подпись (подробнее).

Таким образом, корректный запрос на открытие платёжной формы с применением метода Buy Now Pay Later должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), информацию о пользователе, а также подпись.

{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 3000,
   "payment_currency": "GBP",
   "customer_id": "customer1",
   "customer_first_name": "John",
   "customer_last_name": "Doe",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}

Рис. 4. Пример достаточного набора данных для запроса на оплату

{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 3000,
   "payment_currency": "GBP",
   "customer_id": "customer1",
   "customer_first_name": "John",
   "customer_last_name": "Doe",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}

Формат оповещений

Для оповещений о результатах оплат с применением метода Buy Now Pay Later используется типовой формат, описание которого представлено в статье Оповещения. При этом в параметре type объекта payment может указываться значение bnpl.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 59051 была проведена оплата на 10,00 GBP.

Рис. 5. Пример данных из оповещения о проведении оплаты

{
        "customer": {
            "id": "zxc",
            "phone": "07811123331"
        },
        "project_id": 59051,
        "payment": {
            "id": "TEST_PAYMENT_600055",
            "type": "bnpl",
            "status": "success",
            "date": "2024-11-14T11:20:31+0000",
            "method": "bnpl",
            "sum": {
                "amount": 1000,
                "currency": "GBP"
            },
            "description": "TEST_PAYMENT_600055"
        },
        "operation": {
            "sum_initial": {
                "amount": 1000,
                "currency": "GBP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "GBP"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 16891,
                "payment_id": "Twp7saulXXF05mzi",
                "auth_code": ""
            },
            "id": 29741010169841,
            "type": "sale",
            "status": "success",
            "date": "2024-11-14T11:20:31+0000",
            "created_date": "2024-11-14T11:08:10+0000",
            "request_id": "497a5edb8ba907ae27d12f508c3d2ba096-00029742"
        },
        "signature": "XV7CVXtQv7n53zvg3jlt1ThyVdedpUKg3UX/9i6jWLPiA=="
    }

В следующем примере оповещение свидетельствует об отклонённой оплате.

Рис. 6. Пример данных из оповещения об отклонении оплаты

{
        "customer": {
            "id": "zxc"
        },
        "project_id": 59051,
        "payment": {
            "id": "TEST_PAYMENT_577285",
            "type": "bnpl",
            "status": "decline",
            "date": "2024-11-14T11:49:55+0000",
            "method": "bnpl",
            "sum": {
                "amount": 1000,
                "currency": "GBP"
            },
            "description": "TEST_PAYMENT_577285"
        },
        "operation": {
            "sum_initial": {
                "amount": 1000,
                "currency": "GBP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "GBP"
            },
            "code": "20000",
            "message": "General decline",
            "provider": {
                "id": 16891,
                "payment_id": "xAIr1FeVlr1QGo4h",
                "auth_code": ""
            },
            "id": 35876010169968,
            "type": "sale",
            "status": "decline",
            "date": "2024-11-14T11:49:55+0000",
            "created_date": "2024-11-14T11:39:57+0000",
            "request_id": "f5313e75fade8bb5076a05692a9c82-00035877"
        },
        "signature": "C3I7F8GCUMf/7MJjQszBerLdVWYncTyi+ZAD9uKDQDg=="
    }

Дополнительные материалы

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

Организация взаимодействия — о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page.
Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
Модель проведения платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
Разовая оплата в одну стадию — о том, как проводить разовые оплаты через Payment Page.
Информация о выполнении операций — о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций.

Оплаты через Gate

Общая информация

Для проведения оплаты через Gate с использованием метода Buy Now Pay Later со стороны веб-сервиса необходимо:

Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay.
Принять промежуточное оповещение от платёжной платформы и осуществить перенаправление пользователя к сервису провайдера.
Принять итоговое оповещение от платёжной платформы.

Полная схема проведения оплаты выглядит следующим образом.

Рис. 7. Проведение оплаты через Gate. Описание шагов

Пользователь на стороне веб-сервиса инициирует оплату с использованием метода Buy Now Pay Later.
От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение оплаты через Gate.
Запрос на проведение оплаты поступает в платёжную платформу ecommpay.
В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности (подробнее).
В платёжной платформе выполняются дальнейшая обработка запроса (с проверкой согласованности параметров) и его оправка в сервис провайдера.
В сервисе провайдера выполняется обработка запроса на оплату.
От сервиса провайдера к платёжной платформе передаются данные для перенаправления пользователя к сервису провайдера.
От платёжной платформы к веб-сервису направляется оповещение с данными для перенаправления пользователя к сервису провайдера.
Пользователь перенаправляется к сервису провайдера.
Пользователь выполняет необходимые действия для регистрации договора на рассрочку и оплаты.
В сервисе провайдера выполняется обработка информации.
Пользователю отображается информация о результате оплаты.
Пользователь перенаправляется к веб-сервису.
От сервиса провайдера к платёжной платформе направляется информация о результате оплаты.
От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
На стороне веб-сервиса обеспечивается информирование пользователя о результате оплаты.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом Buy Now Pay Later через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.

Формат запросов

При работе с запросами на оплаты с применением метода Buy Now Pay Later необходимо учитывать следующее:

Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке /v2/payment/bnpl/humm/sale.
В каждом запросе должны использоваться следующие объекты и параметры:
- general — объект, содержащий основные идентификационные сведения запроса:
  - project_id — идентификатор проекта, полученный от ecommpay при интеграции;,
  - payment_id — идентификатор платежа, уникальный в рамках проекта;,
  - signature — подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью); (подробнее),
- payment — объект, содержащий сведения о платеже:
  - amount — сумма платежа в дробных единицах валюты;,;
  - currency — код валюты платежа в формате ISO-4217 alpha-3;,
- customer — объект, содержащий сведения о пользователе:
  - id — идентификатор пользователя, уникальный в рамках проекта;,
  - ip_address — IP-адрес пользователя, актуальный для инициируемого платежа;,
  - first_name — имя пользователя;,
  - last_name — фамилия пользователя.
Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на оплату с применением метода Buy Now Pay Later должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), информацию о пользователе, а также подпись.

{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej/UG0Di8hTng6JvipTv+AWoXW/9MTO8yJA=="
  },
  "payment": {
    "amount": 30000,
    "currency": "GBP"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0",
    "first_name": "John",
    "last_name": "Doe"
  }
}

Рис. 8. Пример достаточного набора данных для запроса на оплату

{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej/UG0Di8hTng6JvipTv+AWoXW/9MTO8yJA=="
  },
  "payment": {
    "amount": 30000,
    "currency": "GBP"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0",
    "first_name": "John",
    "last_name": "Doe"
  }
}

Формат оповещений для перенаправления пользователей

Для перенаправления пользователей от веб-сервиса мерчанта к сервису провайдера при проведении каждого платежа с использованием метода Buy Now Pay Later необходимо принять промежуточное оповещение от платёжной платформы и использовать информацию из него, включённую в объект redirect_data. Формат таких оповещений является типовым (подробнее), при этом в состав объекта redirect_data включаются следующие объекты и параметры:

body — объект с данными для отправки в теле запроса;
method — параметр с указанием HTTP-метода отправки запроса (GET или POST);
url — параметр со ссылкой для перенаправления.

Рис. 9. Пример объекта redirect_data

  "redirect_data": {
    "body": {},
    "method": "POST",
    "url": "https://www.example.com/pay"
  }

Формат оповещений

Для оповещений с применением метода Buy Now Pay Later используется типовой формат, описание которого представлено в статье Оповещения. При этом в параметре type объекта payment может указываться значение bnpl.

Рис. 10. Пример данных из оповещения о проведении оплаты

{
        "customer": {
            "id": "zxc",
            "phone": "07811123331"
        },
        "project_id": 59051,
        "payment": {
            "id": "TEST_PAYMENT_600055",
            "type": "bnpl",
            "status": "success",
            "date": "2024-11-14T11:20:31+0000",
            "method": "bnpl",
            "sum": {
                "amount": 1000,
                "currency": "GBP"
            },
            "description": "TEST_PAYMENT_600055"
        },
        "operation": {
            "sum_initial": {
                "amount": 1000,
                "currency": "GBP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "GBP"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 16891,
                "payment_id": "Twp7saulXXF05mzi",
                "auth_code": ""
            },
            "id": 29741010169841,
            "type": "sale",
            "status": "success",
            "date": "2024-11-14T11:20:31+0000",
            "created_date": "2024-11-14T11:08:10+0000",
            "request_id": "497a5edb8ba907ae27d12f508c3d2ba096-00029742"
        },
        "signature": "XV7CVXtQv7n53zvg3jlt1ThyVdedpUKg3UX/9i6jWLPiA=="
    }

В следующем примере оповещение свидетельствует об отклонённой оплате.

Рис. 11. Пример данных из оповещения об отклонении оплаты

{
        "customer": {
            "id": "zxc"
        },
        "project_id": 59051,
        "payment": {
            "id": "TEST_PAYMENT_577285",
            "type": "bnpl",
            "status": "decline",
            "date": "2024-11-14T11:49:55+0000",
            "method": "bnpl",
            "sum": {
                "amount": 1000,
                "currency": "GBP"
            },
            "description": "TEST_PAYMENT_577285"
        },
        "operation": {
            "sum_initial": {
                "amount": 1000,
                "currency": "GBP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "GBP"
            },
            "code": "20000",
            "message": "General decline",
            "provider": {
                "id": 16891,
                "payment_id": "xAIr1FeVlr1QGo4h",
                "auth_code": ""
            },
            "id": 35876010169968,
            "type": "sale",
            "status": "decline",
            "date": "2024-11-14T11:49:55+0000",
            "created_date": "2024-11-14T11:39:57+0000",
            "request_id": "f5313e75fade8bb5076a05692a9c82-00035877"
        },
        "signature": "C3I7F8GCUMf/7MJjQszBerLdVWYncTyi+ZAD9uKDQDg=="
    }

Дополнительные материалы

Для организации работы с оплатами через Gate также могут быть полезны следующие материалы:

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

Анализ результатов проведения платежей

Для анализа информации о платежах и операциях, как в отдельности по методу Buy Now Pay Later, так и в совокупности с другими методами, можно использовать:

инструментарий интерфейса Dashboard, с различными реестрами и аналитическими панелями;,
отчёты в формате CSV, выгружаемые (как разово, так и периодически) через раздел Отчёты интерфейса Dashboard;,
данные в формате JSON, получаемые по программным запросам через интерфейс Data API.

С вопросами по анализу информации можно обращаться к разделам документации (Dashboard и Использование Data API) и специалистам ecommpay.