Amazon Pay
Обзор
Amazon Pay — платёжный метод позволяющий осуществлять выплаты пользователям с помощью электронных кошельков. Выплаты осуществляются через Gate и Dashboard.
Характеристика
Тип платёжного метода | платежи с использованием электронных кошельков |
---|---|
Платёжные инструменты | электронные кошельки |
Регионы использования | IN |
Валюты платежей | INR, USD |
Конвертация валют | На стороне ecommpay |
Оплаты | – |
Выплаты | + |
Оплаты по сохранённым данным | – |
Полные возвраты | – |
Частичные возвраты | – |
Опротестования | – |
Особенности | – |
Организация и стоимость подключения | по согласованию с курирующим менеджером ecommpay |
Схема работы
В проведении отдельного платежа с использованием Amazon Pay задействуются веб-сервис мерчанта, Gate и платёжная платформа ecommpay, а также технические средства Amazon Pay, обеспечивающие взаимодействие с сервисами банков.
Основные операции
Интерфейсы | Суммы в INR | |||||
---|---|---|---|---|---|---|
Payment Page | CMS Plug-ins | Gate | Dashboard | минимум | максимум | |
Выплаты | – | – | + | + | 1,00 | 400 000,00 |
Сценарии использования
Проведение выплат с использованием метода Amazon Pay выполняется с уведомлением пользователей через веб-сервис мерчанта.
Рис.: Выплата через Gate
Детальные сведения о том, что необходимо делать со стороны мерчанта для проведения платежей, а также о том, что можно использовать для анализа информации о проведённых платежах и операциях, представлены далее.
Выплаты через Gate
Общая информация
Для выплаты через Gate с использованием метода Amazon Pay со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате выплаты. Полная схема проведения выплаты представлена далее.
Рис.: Проведение выплаты через Gate
- Пользователь на стороне веб-сервиса инициирует выплату через Amazon Pay.
- От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение выплаты через Gate.
- Запрос на проведение выплаты поступает в платёжную платформу.
- Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
- От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее см. в разделе Формат ответа.
- В платёжной платформе выполняются дальнейшая обработка запроса и его отправка в сервис провайдера.
- На стороне провайдера выполняется обработка платежа.
- От провайдера к платёжной платформе направляется оповещение о результате.
- От платёжной платформы к веб-сервису направляется оповещение о результате.
- От веб-сервиса пользователю направляется результат выплаты.
Информация о формате запросов и параметрах инициации выплат методом Amazon Pay через Gate, а также о формате оповещений о результатах выплат приведена далее, общая информация о работе с API см. в разделе Работа с API.
Формат запросов
При работе с запросами на выплаты с применением метода Amazon Pay необходимо учитывать следующее:
- Должен использоваться запрос
/v2/payment/wallet/amazonpay/payout
, отправляемый методом POST. Этот запрос относится к группе запросов на проведение платежей через электронный кошелёк /v2/payment/wallet/{payment_method}/payout. - В запросе должны использоваться следующие объекты и параметры:
- general — объект, содержащий основные идентификационные сведения запроса:
- project_id — идентификатор проекта, полученный от ecommpay при интеграции,
- payment_id — идентификатор платежа, уникальный в рамках проекта,
- signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
- payment — объект, содержащий сведения о платеже:
- amount — сумма платежа в дробных единицах валюты,
- currency — валюта платежа в формате ISO-4217 alpha-3;
- customer — объект, содержащий сведения о пользователе:
- id — идентификатор пользователя на стороне веб-сервиса,
- ip_address — используемый IP-адрес,
- first_name — имя,
- last_name — фамилия,
- email — адрес электронной почты,
- address — почтовый адрес;
- account — объект, содержащий сведения о кошельке получателя выплаты:
- number — номер телефона, привязанный к кошельку.
- general — объект, содержащий основные идентификационные сведения запроса:
- Дополнительно могут использоваться все параметры, указанные в спецификации.
Таким образом, корректный запрос на выплату с применением метода Amazon Pay должен содержать идентификаторы проекта и платежа, подпись, номер счёта и данные пользователя, валюту и сумму платежа, а также сведения о счёте получателя:
Рис.: Пример запроса на выплату
{ "general": { "project_id": 818, "payment_id": "ORDER_I1558600157", "signature": "+K6jllym+PtObocZ1yS...xfWJTXdESkijfsBeR6bKROUsslA==" }, "payment": { "amount": 150000, "currency": "INR" }, "customer": { "id": "24900", "ip_address": "1.2.3.4", "first_name": "Ada", "last_name": "Lovelace", "email": "Lovelace@mail.com", "address": "Delhi, Main st., 20" }, "account": { "number": "9811181996" } }
Формат оповещений
Для оповещений о результатах выплат с применением метода Amazon Pay используется стандартный формат, описание которого представлено в разделе Оповещения.
В следующем примере оповещение свидетельствует о том, что в рамках проекта 197
была успешно проведена выплата в размере 100,00 INR
.
Рис.: Пример оповещения о проведении выплаты
{ "project_id": 197, "payment": { "id": "Payout-test-2-2209", "type": "payout", "status": "success", "date": "2020-09-22T08:50:56+0000", "method": "amazonpay", "sum": { "amount": 10000, "currency": "INR" }, "description": "" }, "account": { "number": "9811181996" }, "customer": { "id": "1", "phone": "9811181996" }, "operation": { "id": 77184010013601, "type": "payout", "status": "success", "date": "2020-09-22T08:50:56+0000", "created_date": "2020-09-22T08:50:51+0000", "request_id": "0584a6d51e85-00077185", "sum_initial": { "amount": 10000, "currency": "INR" }, "sum_converted": { "amount": 10000, "currency": "INR" }, "code": "0", "message": "Success", "provider": { "id": 1811, "payment_id": "161818558", "auth_code": "", "date": "2020-09-22T08:50:55+0000" } }, "signature": "Rgj9JJvd+qF3DeORTLYTv9j77kUKJCGX+ke/PssMBtYNomcgE/lGPKDEqXzxcGyxg/MOk+l62uanWEo1T2Me0w==" }
В следующем примере выплата была отклонена.
Рис.: Пример оповещения об отказе в проведении выплаты
{ "project_id": 197, "payment": { "id": "Payout-test-1-2209", "type": "payout", "status": "decline", "date": "2020-09-22T07:52:30+0000", "method": "amazonpay", "sum": { "amount": 100, "currency": "INR" }, "description": "" }, "account": { "number": "9811181996" }, "customer": { "id": "1", "phone": "9811181996" }, "operation": { "id": 72455010013601, "type": "payout", "status": "decline", "date": "2020-09-22T07:52:30+0000", "created_date": "2020-09-22T07:52:27+0000", "request_id": "cbac006fd0a891571e020690f6cef1c39002d916-a52fb6bcda08b86a4fdb6271feb7d364b58a98e7-00072456", "sum_initial": { "amount": 100, "currency": "INR" }, "sum_converted": { "amount": 100, "currency": "INR" }, "code": "20000", "message": "General decline", "provider": { "id": 1811, "payment_id": "", "auth_code": "" }, "signature": "UvYafKv8g7aXBIqVVEWAl7KCF8y...Wt8F+7erV2ugNHq6Wv3lJE8Q==" }
Дополнительные материалы
Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:
Выплаты через Dashboard
При использовании интерфейса Dashboard можно проводить одиночные и массовые выплаты методом Amazon Pay с единичной и пакетной отправкой запросов, называемые соответственно одиночными и массовыми.
- Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры (включая метод), отправить запрос и убедиться в проведении выплаты.
-
Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.
При этом должен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе Сведения о массовых платежах, а параметры выплат — должны соответствовать требованиям, представленным в разделе Выплаты через Gate этой статьи (за исключением пункта о подписи).
Более подробная информация о проведении выплат через Dashboard представлена в отдельной статье.
Анализ результатов проведения платежей
Как и при работе с другими платёжными методами, которые предоставляет ecommpay, при использовании метода Amazon Pay доступны разные способы анализа информации о платежах и операциях с применением этого метода — как в отдельности, так и в совокупности с другими методами.
Всю необходимую информацию можно получать и анализировать средствами Dashboard, в том числе с помощью аналитических панелей на вкладке Analytics.
Также можно выгружать нужную информацию для последующего анализа с помощью специализированных аналитических средств сторонних разработчиков:
- Dashboard позволяет выгружать данные в форматах CSV и XLS с помощью инструментов на вкладке Платежи. При этом можно выполнять разовые выгрузки информации на локальный компьютер и задействовать периодическую выгрузку и отправку информации на заданные адреса электронной почты.
- Data API позволяет получать информацию в формате JSON и отправлять ее на заданный URL — для этого применяются запросы /operations/get.
С любыми вопросами о возможностях анализа можно обращаться в службу технической поддержки ecommpay.