Vietnamese ATM cards (NAPAS)
Обзор
Введение
Vietnamese ATM — метод, позволяющий проводить платежи во вьятнамских донгах с использованием платёжных карт, брендированных местным поставщиком платёжных услуг NAPAS, во Вьетнаме. Обычные внутренние карты во Вьетнаме ограничиваются функциями выплаты заработной платы и снятия наличных, но с возможностью проведения внутренних покупок через платежную сеть NAPAS. Для этого метода в платёжной платформе ecommpay поддерживаются оплаты и выплаты. Для проведения оплат используется два канала. Номер подключённого канала необходимо уточнять у курирующего менеджера ecommpay. Проведение выплат проходит по общему каналу.
В этой статье представлена информация о работе с методом Vietnamese ATM: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач.
Характеристика
Тип платёжного метода | банковские платежи |
---|---|
Платёжные инструменты | платёжные карты |
Регионы использования | VN |
Валюты платежей | VND |
Конвертация валют | – |
Разовые оплаты | + |
Оплаты по сохранённым данным | – |
Полные возвраты | по запросу в службу технической поддержки ecommpay |
Частичные возвраты | – |
Выплаты | + |
Опротестования | – |
Особенности | |
Организация и стоимость подключения | по согласованию с курирующим менеджером ecommpay |
Схема работы
В проведении отдельного платежа с использованием метода Vietnamese ATM задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также технические средства сервиса банка.
Основные операции
Для проведения платежей и выполнения операций с использованием метода Vietnamese ATM могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page, Gate и Dashboard (с применением платёжных ссылок), а выплаты — через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.
При работе с методом Vietnamese ATM, независимо от используемых интерфейсов, актуальны следующие ограничения.
Суммы, VND ¹ | ||
---|---|---|
минимум | максимум | |
Оплаты | 2 000 * |
Канал 1: ограничение карты пользователя Канал 2: 20 000 000 000 |
Выплаты | 100 000 | 100 000 000 |
Сценарии использования
Проведение оплат с использованием метода Vietnamese ATM осуществляется с перенаправлением пользователей к сервису банка, проведение выплат — с уведомлением пользователей через веб-сервис мерчанта.
Рис.: Оплата через Payment Page
Рис.: Оплата через Gate
Рис.: Выплата через Gate
Сценарии выполнения операций через основные интерфейсы платёжной платформы соответствуют представленным на схемах. При использовании дополнительных возможностей (таких как платёжные ссылки) сценарии выполнения операций методом Vietnamese ATM соответствуют специфике этих возможностей.
Вместе с тем, к особенностям работы с методом Vietnamese ATM можно отнести то, что для каждого платежа с использованием этого метода должен быть выбран конкретный банк. При работе через Payment Page, как правило, выбор банка осуществляется пользователем уже в платёжной форме, но при вызовах Payment Page с предварительным выбором метода и банка, а также при инициировании оплат и выплат через Gate банк должен быть выбран на стороне веб-сервиса и в запросах должен указываться идентификатор этого банка. Возможные варианты выбора банка при работе через Payment Page описаны в разделе Оплаты через Payment Page этой статьи, а способы работы с идентификаторами банков — в следующем подразделе, Поддержка со стороны банков.
Вместе с тем, для оплат этим методом поддерживаются разные варианты выбора банка; они описаны в разделе Оплаты через Payment Page этой статьи.
Поддержка со стороны банков
В следующей таблице в ознакомительных целях приведены названия и идентификаторы банков, поддерживающих работу с методом Vietnamese ATM. В зависимости от канала различается список доступных банков.
Банк | ID | Оплаты | Выплаты |
---|---|---|---|
Agribank | 139 | + | + |
An Binh Commercial Joint Stock Bank (ABBANK) | 465 | + | + |
ANZ bank | 464 | – | + |
Asia Commercial Bank | 150 | + | + |
Bac A Commercial Joint Stock Bank (Bac A Bank) | 439 | + | + |
Bank for Investment and Development of Vietnam | 136 | + | + |
Bao Viet Bank | 453 | – | + |
Citibank | 454 | – | + |
Dai A Joint-stock Commercial Bank | 466 | + | + |
DongA Joint Stock Commercial Bank | 130 | + | + |
Eximbank Vietnam | 135 | + | + |
Global Petro Commercial Joint Stock Bank (GPBank) | 444 | + | + |
Global Trust Bank | 459 | – | + |
HoChiMinh City Development Joint Stock Commercial Bank (HDBank) | 448 | + | + |
HSBC Vietnam | 462 | – | + |
Joint Stock Commercial Bank for Foreign Trade of Vietnam (Vietcombank) | 133 | + | + |
KB Kookmin Bank | 458 | – | + |
Kien Long Commercial Joint - Stock Bank | 455 | + | + |
LienVietPostBank | 706 | + | – |
Military JSC Bank (MB) | 447 | + | + |
Nam A commercial joint stock bank (NamABank) | 452 | + | + |
Nam Viet Bank (NaviBank) | 441 | + | – |
National Citizen Bank | 442 | – | + |
Ocean Commercial One Member Limited Liability Bank (OceanBank) | 450 | + | + |
Orient Commercial Bank (PhuongDong Bank) | 467 | + | + |
Petrolimex Group Commercial Joint Stock Bank (PGBank) | 443 | + | + |
Public Bank Vietnam | 3981 | + | – |
Sai Gon Joint Stock Commercial Bank (SCB) | 460 | + | + |
Sai Gon Thuong Tin Commercial Joint Stock Bank | 131 | + | + |
SAIGON Bank | 137 | + | + |
Saigon Hanoi Commercial Joint Stock Bank (SHB) | 451 | + | + |
SHINHAN bank | 461 | + | + |
SouthEast Asia Joint Stock Commercial Bank (SeaBank) | 468 | + | + |
Standard Chartered Bank | 463 | – | + |
Tien Phong Commercial Joint Stock Bank (TienPhongBank) | 445 | + | + |
VietinBank | 134 | + | + |
Vietnam Asia Commercial Joint Stock Bank (VietA Bank) | 446 | + | + |
Vietnam International Bank | 138 | + | + |
Vietnam Maritime Commercial Joint Stock Bank (MaritimeBank) | 440 | + | + |
Vietnam Prosperity Bank (VPBank) | 449 | + | + |
Vietnam Public Joint-stock Commercial Bank | 457 | + | + |
Vietnam Technological and Commercial Joint- stock Bank | 132 | + | + |
Vietnam-Russia Joint Venture Bank | 4691 | + | – |
Банк | ID | Оплаты | Выплаты |
---|---|---|---|
Agribank | 139 | + | + |
An Binh Commercial Joint Stock Bank (ABBANK) | 465 | + | + |
ANZ bank | 464 | – | + |
Asia Commercial Bank | 150 | + | + |
Bac A Commercial Joint Stock Bank (Bac A Bank) | 439 | + | + |
Bank for Investment and Development of Vietnam | 136 | + | + |
Bao Viet Bank | 453 | – | + |
Citibank | 454 | – | + |
Dai A Joint-stock Commercial Bank | 466 | – | + |
DongA Joint Stock Commercial Bank | 130 | – | + |
Eximbank Vietnam | 135 | + | + |
Global Petro Commercial Joint Stock Bank (GPBank) | 444 | + | + |
Global Trust Bank | 459 | – | + |
HoChiMinh City Development Joint Stock Commercial Bank (HDBank) | 448 | + | + |
HSBC Vietnam | 462 | – | + |
Joint Stock Commercial Bank for Foreign Trade of Vietnam | 456 | – | + |
Joint Stock Commercial Bank for Foreign Trade of Vietnam (Vietcombank) | 133 | + | + |
KB Kookmin Bank | 458 | – | + |
Kien Long Commercial Joint - Stock Bank | 455 | – | + |
Military JSC Bank (MB) | 447 | + | + |
Nam A commercial joint stock bank (NamABank) | 452 | + | + |
Nam Viet Bank (NaviBank) | 441 | + | – |
National Citizen Bank | 442 | – | + |
Ocean Commercial One Member Limited Liability Bank (OceanBank) | 450 | + | + |
Orient Commercial Bank (PhuongDong Bank) | 467 | + | + |
Petrolimex Group Commercial Joint Stock Bank (PGBank) | 443 | + | + |
SAIGON Bank | 137 | + | + |
Saigon Hanoi Commercial Joint Stock Bank (SHB) | 451 | + | + |
Sai Gon Joint Stock Commercial Bank (SCB) | 460 | + | + |
Sai Gon Thuong Tin Commercial Joint Stock Bank | 131 | + | + |
SHINHAN bank | 461 | – | + |
SouthEast Asia Joint Stock Commercial Bank (SeaBank) | 468 | + | + |
Standard Chartered Bank | 463 | – | + |
Tien Phong Commercial Joint Stock Bank (TienPhongBank) | 445 | + | + |
VietinBank | 134 | – | + |
Vietnam Asia Commercial Joint Stock Bank (VietA Bank) | 446 | + | + |
Vietnam International Bank | 138 | + | + |
Vietnam Maritime Commercial Joint Stock Bank (MaritimeBank) | 440 | + | + |
Vietnam Prosperity Bank (VPBank) | 449 | + | + |
Vietnam Public Joint-stock Commercial Bank | 457 | – | + |
Vietnam Technological and Commercial Joint-stock Bank | 132 | + | + |
Поскольку со временем состав доступных банков может меняться, для получения актуальной информации рекомендуется использовать POST-запрос к конечным точкам /v2/info/banks/atm/vietnam/sale/list
(для оплат) и /v2/info/banks/atm/vietnam/payout/list
(для выплат), которые относятся к группе конечных точек /v2/info/banks/{payment_method}/{operationType}/list
Gate API. В этом запросе должны указываться идентификатор проекта, идентификатор, валюта и сумма платежа и подпись к этим данным; при этом рекомендуется передавать реальные данные о платеже, но допускается и указание произвольных значений.
Рис.: Пример данных из запроса на получение списка банков
{ "general": { "project_id": 200, "payment_id": "ORDER_155860015", "signature": "K6jllym+PtObocZtr345st...==" }, "payment": { "amount": 1000, "currency": "VND" } }
Рис.: Пример данных из ответа с информацией о банках
[ { "id": 150, // Индентификатор банка "abbr": "ACB", // Служебная аббревиатура банка, используемая в платформе "name": "ACB", // Основное (международное) название банка "nativeName": "Asia Commercial Bank", // Локальное (национальное или региональное) название банка "currencies": [ // Массив с информацией о валютах, поддерживаемых банком { "id": 104, // Идентификатор валюты в платёжной платформе "alpha_3_4217": "VND", // Буквенный код валюты платежа в формате ISO-4217 alpha-3 "number_3_4217": "704", // Цифровой код валюты платежа в формате ISO-4217 alpha-3 "exponent": 0 // Число дробных разрядов валюты } ] }, { "id": 459, "abbr": "GTB", "name": "Global Trust Bank", "nativeName": "Global Trust Bank", "currencies": [ { "id": 104, "alpha_3_4217": "VND", "number_3_4217": "704", "exponent": 0 } ] }, { "id": 139, "abbr": "AGB", "name": "AGB", "nativeName": "Agribank", "currencies": [ { "id": 104, "alpha_3_4217": "VND", "number_3_4217": "704", "exponent": 0 } ] } ]
С вопросами о работе с банками, поддерживающими метод Vietnamese ATM, можно обращаться к курирующему менеджеру ecommpay.
Регионы проведения выплат
При проведении выплаты с использованием метода Vietnamese ATM обязательно учитывается регион банковского счёта пользователя. Для этого используется идентификатор региона, который передаётся в параметре region_id
в запросе на выплату. В следующей таблице приведена информация о регионах и их идентификаторах.
Наименование региона | Идентификатор региона |
---|---|
An Giang | 137 |
Bà Rịa - Vũng Tàu | 138 |
Bình Thuận | 141 |
Bình Định | 142 |
Bến Tre | 147 |
Cao Bằng | 149 |
Gia Lai | 152 |
Hà Giang | 156 |
Hà Tĩnh | 158 |
Hòa Bình | 159 |
Hậu Giang | 162 |
Khánh Hòa | 163 |
Kiến Giang | 164 |
Kon Tum | 165 |
Lai Châu | 166 |
Long An | 167 |
Lào Cai | 168 |
Lâm Đồng | 169 |
Lạng Sơn | 170 |
Nghệ An | 172 |
Ninh Bình | 173 |
Ninh Thuận | 174 |
Phú Yên | 176 |
Quảng Bình | 177 |
Quảng Nam | 178 |
Quảng Ngãi | 179 |
Quảng Ninh | 180 |
Quảng Trị | 181 |
Sóc Trăng | 182 |
Sơn La | 183 |
Thanh Hóa | 184 |
Thái Bình | 185 |
Thừa Thiên-Huế | 187 |
Tiền Giang | 188 |
Trà Vinh | 189 |
Tuyên Quang | 190 |
Tây Ninh | 191 |
Vĩnh Long | 192 |
Yên Bái | 194 |
Điện Biên | 195 |
Đắk Lắk | 196 |
Đắk Nông | 197 |
Đồng Nai | 198 |
Đồng Tháp | 199 |
Bắc Kạn | 277 |
Bắc Giang | 278 |
Bạc Liêu | 279 |
Bắc Ninh | 280 |
Bình Dương | 281 |
Bình Phước | 282 |
Cà Mau | 283 |
Can Tho | 284 |
Da Nang | 285 |
Hà Nam | 286 |
Ha Noi | 287 |
Hải Dương | 288 |
Hai Phong | 289 |
Ho Chi Minh | 290 |
Hưng Yên | 291 |
Nam Định | 292 |
Phú Thọ | 293 |
Thái Nguyên | 294 |
Toàn quốc | 295 |
Vĩnh Phúc | 296 |
Оплаты через Payment Page
Общая информация
Для проведения оплаты через Payment Page с использованием метода Vietnamese ATM со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. При этом можно использовать различные варианты выбора метода и банка, указывая соответствующие параметры в запросах. Полная схема проведения оплаты выглядит следующим образом.
Рис.: Проведение оплаты через Payment Page. Описание шагов
- Пользователь на стороне веб-сервиса инициирует оплату.
- От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение оплаты через Payment Page.
- Запрос на проведение оплаты поступает в платёжную платформу.
- В платёжной платформе выполняется приём запроса, с проверкой наличия обязательных параметров и корректной подписи.
- Осуществляется подготовка Payment Page согласно параметрам проекта и вызова.
- Пользователю отображается платёжная форма.
- Пользователь выбирает один из банков, поддерживающих работу с платёжным методом Vietnamese ATM.
- На Payment Page пользователю отображается страница для ввода адреса электронной почты и телефона.
- Пользователь вводит адрес электронной почты и телефон на Payment Page.
- В платёжную платформу передаётся запрос на проведение оплаты с использованием метода Vietnamese ATM.
- В платёжной платформе выполняются обработка полученного запроса и его отправка в сервис банка.
- На стороне банка выполняется обработка запроса на оплату.
- От сервиса банка к платёжной платформе передаются данные для перенаправления пользователя к сервису банка.
- Данные для перенаправления пользователя передаются к Payment Page.
- Пользователь перенаправляется к сервису банка.
- Пользователь вводит данные платёжной карты и далее выполняет необходимые действия для оплаты на сайте банка.
- В сервисе банка выполняется обработка платежа.
- Информация о результате оплаты отображается пользователю в сервисе банка.
- Пользователь перенаправляется к Payment Page.
- От сервиса банка к платёжной платформе направляется информация о результате оплаты.
- От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
- От платёжной платформы к Payment Page направляется информация о результате оплаты.
- Информация о результате оплаты отображается пользователю на Payment Page.
Как правило, после того как пользователь на стороне веб-сервиса подтверждает готовность перейти к оплате, он перенаправляется к Payment Page, выбирает платёжный метод и, в случае работы с методом Vietnamese ATM, дополнительно выбирает один из доступных банков. Вместе с тем, в некоторых ситуациях могут быть актуальны другие варианты выбора платёжного метода и банка. Например, при открытии Payment Page можно сразу перенаправлять пользователя к выбору банка либо ограничивать список поддерживаемых банков для отдельного платежа и отображать пользователю только кнопки выбора целевых банков. Конкретный вариант выбора платёжного метода и банка определяется через параметры, указанные в запросе на открытие Payment Page (подробнее далее), при этом допустимы следующие варианты:
- 1 — при открытии платёжной формы в ней последовательно отображаются отдельные страницы для выбора метода и банка, и пользователь выбирает сначала метод, а затем банк (этот вариант используется по умолчанию);
- 2 — при открытии платёжной формы в ней отображается страница с кнопками выбора методов и банков для данного метода, и пользователь выбирает один из этих банков;
- 3 — при открытии платёжной формы в ней отображается страница с кнопками выбора всех доступных банков для данного метода, и пользователь выбирает один из этих банков;
- 4 — при открытии платёжной формы в ней отображается страница с кнопками выбора заданных банков для данного метода, и пользователь выбирает один из этих банков;
- 5 — при открытии платёжной формы в ней отображается страница подтверждения перенаправления к сервису заданного банка, и пользователь соглашается с этим перенаправлением.
Рис.: 1 — Выбор метода и банка
Рис.: 2 — Выбор банка среди доступных методов
Рис.: 3 — Выбор среди доступных банков
Рис.: 4 — Выбор среди заданных банков
Рис.: 5 — Перенаправление к сервису заданного банка
Информация о форматах запросов и оповещений, используемых для проведения оплат методом Vietnamese ATM через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье Организация взаимодействия.
Канал 1. Формат запросов
При формировании запросов на открытие платёжной формы с применением метода Vietnamese ATM необходимо учитывать следующее:
- Должен использоваться базовый минимум параметров, обязательный для любого платежа:
project_id
— идентификатор проекта, полученный от ecommpay при интеграции;payment_id
— идентификатор платежа, уникальный в рамках проекта;payment_currency
— код валюты платежа в формате ISO-4217 alpha-3;payment_amount
— сумма платежа (без выделения дробной части, поскольку при работе с валютой VND дробные единицы не используются);customer_id
— идентификатор пользователя в рамках проекта.
- Должен использоваться базовый минимум параметров:
project_id
,payment_id
,payment_currency
,payment_amount
,customer_id
. - Валютой платежа может быть только VND.
- Дополнительно необходимо указывать адрес электронной почты пользователя и номер телефона пользователя в параметрах
customer_email
иcustomer_phone
. - Payment Page можно открывать на вьетнамском языке. Для этого необходимо передавать код языка
vi
в параметреlanguage_code
(подробнее — в разделе Управление языком платёжной формы). -
Вариант выбора банка может определяться следующим образом:
- Через выбор в Payment Page метода и банка (1) — как вариант по умолчанию, применяемый, если не указываются параметр
force_payment_method
и объектpayment_methods_options
, упоминаемые в подпунктах 2–5. - Через выбор в Payment Page банка среди доступных методов (2) — для этого в объекте
payment_methods_options
необходимо указывать объектvietnam_atm
, содержащий параметрsplit_banks
со значениемtrue
:"payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true}}"
- Через выбор в Payment Page банка из числа доступных (3) — для этого в параметре
force_payment_method
необходимо указывать код предварительного выбора методаvietnam-atm
. - Через выбор в Payment Page банка из числа заданных (4) — для этого необходимо указывать:
- код
vietnam-atm
в параметреforce_payment_method
; - объект
payment_methods_options
с объектомvietnam_atm
, который должен содержать параметрsplit_banks
со значениемtrue
и объектbanks_id
с массивом, включающим в себя идентификаторы целевых банков:"payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true, \"banks_id\": [135, 136]}}"
- код
- Через подтверждение в Payment Page перенаправления к сервису заданного банка (5) — для этого необходимо указывать:
- код
vietnam-atm
в параметреforce_payment_method
; - объект
payment_methods_options
с объектомvietnam_atm
, который должен содержать параметрsplit_banks
со значениемtrue
и объектbanks_id
с массивом, включающим в себя идентификатор целевого банка:"payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true, \"banks_id\": [135]}}"
- код
- Через выбор в Payment Page метода и банка (1) — как вариант по умолчанию, применяемый, если не указываются параметр
- Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page (подробнее).
- После указания всех целевых параметров необходимо составлять подпись (подробнее).
Таким образом, корректный запрос на открытие платёжной формы с применением метода Vietnamese ATM должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), информацию о пользователе и подпись.
{ "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "VND", "customer_id": "customer1", "customer_email": "johna@examle.com", "customer_phone": "84438336996", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" }
Рис.: Пример достаточного набора данных для запроса на оплату
{ "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "VND", "customer_id": "customer1", "customer_email": "johna@gmail.com", "customer_phone": "84438336996", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" }
Вместе с тем, в случае с выбором из заданных банков (4), запрос на открытие Payment Page может содержать расширенный набор данных.
{ "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "USD", "customer_id": "customer1", "force_payment_method": "vietnam-atm", "payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true, \"banks_id\": [135, 136]}}", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" }
Канал 2. Формат запросов
При формировании запросов на открытие платёжной формы с применением метода Vietnamese ATM необходимо учитывать следующее:
- Должен использоваться базовый минимум параметров, обязательный для любого платежа:
project_id
— идентификатор проекта, полученный от ecommpay при интеграции;payment_id
— идентификатор платежа, уникальный в рамках проекта;payment_currency
— код валюты платежа в формате ISO-4217 alpha-3;payment_amount
— сумма платежа (без выделения дробной части, поскольку при работе с валютой VND дробные единицы не используются);customer_id
— идентификатор пользователя в рамках проекта.
- Должен использоваться базовый минимум параметров:
project_id
,payment_id
,payment_currency
,payment_amount
,customer_id
. - Валютой платежа может быть только VND.
- В зависимости от выбранного банка у пользователя на Payment Page запрашиваются некоторые данные карты (подробнее — Дополнение информации о платежах).
- Payment Page можно открывать на вьетнамском языке. Для этого необходимо передавать код языка
vi
в параметреlanguage_code
(подробнее — в разделе Управление языком платёжной формы). -
Вариант выбора банка может определяться следующим образом:
- Через выбор в Payment Page метода и банка (1) — как вариант по умолчанию, применяемый, если не указываются параметр
force_payment_method
и объектpayment_methods_options
, упоминаемые в подпунктах 2–5. - Через выбор в Payment Page банка среди доступных методов (2) — для этого в объекте
payment_methods_options
необходимо указывать объектvietnam_atm
, содержащий параметрsplit_banks
со значениемtrue
:"payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true}}"
- Через выбор в Payment Page банка из числа доступных (3) — для этого в параметре
force_payment_method
необходимо указывать код предварительного выбора методаvietnam-atm
. - Через выбор в Payment Page банка из числа заданных (4) — для этого необходимо указывать:
- код
vietnam-atm
в параметреforce_payment_method
; - объект
payment_methods_options
с объектомvietnam_atm
, который должен содержать параметрsplit_banks
со значениемtrue
и объектbanks_id
с массивом, включающим в себя идентификаторы целевых банков:"payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true, \"banks_id\": [139, 465]}}"
- код
- Через подтверждение в Payment Page перенаправления к сервису заданного банка (5) — для этого необходимо указывать:
- код
vietnam-atm
в параметреforce_payment_method
; - объект
payment_methods_options
с объектомvietnam_atm
, который должен содержать параметрsplit_banks
со значениемtrue
и объектbanks_id
с массивом, включающим в себя идентификатор целевого банка:"payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true, \"banks_id\": [139]}}"
- код
- Через выбор в Payment Page метода и банка (1) — как вариант по умолчанию, применяемый, если не указываются параметр
- Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page (подробнее).
- После указания всех целевых параметров необходимо составлять подпись (подробнее).
Таким образом, корректный запрос на открытие платёжной формы с применением метода Vietnamese ATM должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), идентификатор пользователя и подпись.
{ "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "VND", "customer_id": "customer1", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" }
Рис.: Пример достаточного набора данных для запроса на оплату
{ "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "VND", "customer_id": "customer1", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" }
Вместе с тем, в случае с выбором из заданных банков (4), запрос на открытие Payment Page может содержать расширенный набор данных.
{ "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "USD", "customer_id": "customer1", "force_payment_method": "vietnam-atm", "payment_methods_options": "{\"vietnam_atm\": {\"split_banks\": true, \"banks_id\": [139, 465]}}", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" }
Формат оповещений
Для оповещений о результатах оплат с применением метода Vietnamese ATM используется типовой формат, описание которого представлено в статье Оповещения.
В следующем примере оповещение свидетельствует о том, что в рамках проекта 603
была проведена оплата в размере 2 000 VND
.
Рис.: Пример данных из оповещения о проведении оплаты
{ "project_id": 603, "payment": { "id": "EP3f43-5d18", "type": "purchase", "status": "success", "date": "2019-02-22T13:36:17+0000", "method": "ATM Vietnam banking", "sum": { "amount": 2000, "currency": "VND" }, "description": "" }, "operation": { "id": 2000000471, "type": "sale", "status": "success", "date": "2019-02-22T13:36:17+0000", "created_date": "2019-02-22T13:35:13+0000", "request_id": "db567db9bf0fdbecba5b7", "sum_initial": { "amount": 2000, "currency": "VND" }, "sum_converted": { "amount": 2000, "currency": "VND" }, "provider": { "id": 1331, "payment_id": "19647319", "auth_code": "" }, "code": "0", "message": "Success" }, "signature": "iJtnnWh4EyZWnWt0uzv01MxRhz0eL7wqYts8ugrA==" }
В следующем примере оповещение свидетельствует об отклонённой оплате.
Рис.: Пример данных из оповещения об отклонении оплаты
{ "project_id": 603, "payment": { "id": "EPd87a-9ea7", "type": "purchase", "status": "decline", "date": "2019-02-22T13:42:26+0000", "method": "ATM Vietnam banking", "sum": { "amount": 2000, "currency": "VND" }, "description": "" }, "operation": { "id": 1000000477, "type": "sale", "status": "decline", "date": "2019-02-22T13:42:26+0000", "created_date": "2019-02-22T13:42:22+0000", "request_id": "251469bcb435b24e9a55dd1b", "sum_initial": { "amount": 2000, "currency": "VND" }, "sum_converted": { "amount": 2000, "currency": "VND" }, "provider": { "id": 1332, "payment_id": "", "auth_code": "" }, "code": "20102", "message": "Incorrect account data entered" }, "signature": "9TDUuc8PLSzgwD2jE5M+7I59NZCkC5pZ6XA2rQ==" }
Дополнительные материалы
Для организации работы с оплатами через Payment Page также могут быть полезны следующие материалы:
- Организация взаимодействия — о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page.
- Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
- Модель проведения платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
- Разовая оплата в одну стадию — о том, как проводить разовые оплаты через Payment Page.
- Информация о выполнении операций — о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций.
Оплаты через Gate
Общая информация
Для проведения оплаты через Gate с использованием метода Vietnamese ATM со стороны веб-сервиса необходимо:
- Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay.
- Принять промежуточное оповещение от платёжной платформы и осуществить перенаправление пользователя к сервису банка.
- Принять итоговое оповещение от платёжной платформы.
Полная схема проведения оплаты выглядит следующим образом.
Рис.: Проведение оплаты через Gate. Описание шагов
- Пользователь на стороне веб-сервиса инициирует оплату с использованием метода Vietnamese ATM.
- От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение оплаты через Gate.
- Запрос на проведение оплаты поступает в платёжную платформу ecommpay.
- В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
- От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности (подробнее).
- В платёжной платформе выполняются дальнейшая обработка запроса (с проверкой согласованности параметров) и его оправка в сервис банка.
- В сервисе банка выполняется обработка запроса на оплату.
- От сервиса банка к платёжной платформе передаются данные для перенаправления пользователя к сервису банка.
- От платёжной платформы к веб-сервису направляется оповещение с данными для перенаправления пользователя к сервису банка.
- Пользователь перенаправляется к сервису банка.
- Пользователь выполняет необходимые действия для оплаты.
- В сервисе Vietnamese ATM выполняется обработка платежа.
- Пользователю отображается информация о результате оплаты.
- Пользователь перенаправляется к веб-сервису.
- От сервиса банка к платёжной платформе направляется информация о результате оплаты.
- От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
- На стороне веб-сервиса обеспечивается информирование пользователя о результате оплаты.
Информация о форматах запросов и оповещений, используемых для проведения оплат методом Vietnamese ATM через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.
Канал 1. Формат запросов
При работе с запросами на оплаты с применением метода Vietnamese ATM необходимо учитывать следующее:
- Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке
/v2/payment/atm/vietnam/sale
. Эта конечная точка относится к группе /v2/payment/atm/{payment_method}/sale. - В запросе должны использоваться следующие объекты и параметры:
general
— объект, содержащий основные идентификационные сведения запроса:project_id
— идентификатор проекта, полученный от ecommpay при интеграции;,payment_id
— идентификатор платежа, уникальный в рамках проекта;,signature
— подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью к данным); (подробнее),
payment
— объект, содержащий сведения о платеже:amount
— сумма платежа (без выделения дробной части, поскольку при работе с валютой VND дробные единицы не используются);,currency
— код валюты платежа в формате ISO-4217 alpha-3;,
customer
— объект, содержащий сведения о пользователе:id
— идентификатор пользователя, уникальный в рамках проекта;,email
— адрес электронной почты пользователя;,phone
— номер телефона пользователя;,ip_address
— IP-адрес пользователя, актуальный для инициируемого платежа;,
account
— объект, содержащий сведения о банковском счёте пользователя:bank_id
— идентификатор банка.
- Валютой платежа может быть только VND.
- Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.
Таким образом, корректный запрос на оплату с применением метода Vietnamese ATM должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), идентификатор и IP-адрес пользователя, а также подпись.
{ "general": { "project_id": 2990, "payment_id": payment_id, "signature": "PJkV8ejrtyUG0Di8hTng6JvC7vQsaC6tajQVVfBaNIipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 2000, "currency": "VND" }, "customer": { "ip_address": "192.0.2.0", "email": "email@example.com", "phone": "64891845653", "id": "customer123" }, "account":{ "bank_id": 135 } }
Рис.: Пример достаточного набора данных для запроса на оплату
{ "general": { "project_id": 2990, "payment_id": payment_id, "signature": "PJkV8ejrtyUG0Di8hTng6JvC7vQsaC6tajQVVfBaNIipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 2000, "currency": "VND" }, "customer": { "ip_address": "192.0.2.0", "email": "email@example.com", "phone": "64891845653", "id": "customer123" }, "account":{ "bank_id": 135 } }
Канал 2. Формат запросов
При формировании запросов на оплату с применением метода Vietnamese ATM необходимо учитывать следующее:
- Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке
/v2/payment/atm/vietnam/sale
. Эта конечная точка относится к группе /v2/payment/atm/{payment_method}/sale. - В запросе должны использоваться следующие объекты и параметры:
general
— объект, содержащий основные идентификационные сведения запроса:project_id
— идентификатор проекта, полученный от ecommpay при интеграции;,payment_id
— идентификатор платежа, уникальный в рамках проекта;,signature
— подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью к данным); (подробнее),
payment
— объект, содержащий сведения о платеже:amount
— сумма платежа (без выделения дробной части, поскольку при работе с валютой VND дробные единицы не используются);,currency
— код валюты платежа в формате ISO-4217 alpha-3;,
customer
— объект, содержащий сведения о пользователе:id
— идентификатор пользователя, уникальный в рамках проекта;,ip_address
— IP-адрес пользователя, актуальный для инициируемого платежа;,email
— адрес электронной почты пользователя;,
account
— объект, содержащий сведения о банковском счёте пользователя:bank_id
— идентификатор банка.
-
Дополнительно может потребоваться передавать некоторые из следующих параметров объекта
card
:pan
— номер карты пользователя,card_holder
— имя держателя карты,year
— год выдачи или истечения срока действия карты,month
— месяц выдачи или истечения срока действия карты.
Список дополнительных параметров для проведения платежа зависит от выбранного банка. Если веб-сервис мерчанта поддерживает уточнение дополнительных параметров (Дополнение информации о платеже), то после отправки запроса, содержащего только обязательные параметры, придёт оповещение со списком дополнительных параметров для выбранного пользователем банка.
В противном случае все указанные в пунктах 2 и 3 параметры необходимо передавать в запросе на оплату.
- Валютой платежа может быть только VND.
- Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.
Таким образом, корректный запрос на оплату с применением метода Vietnamese ATM должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), идентификатор, IP-адрес и адрес электронной почты пользователя, а также идентификатор банка и подпись.
Рис.: Пример достаточного набора данных для запроса на оплату (при поддержке запросов на уточнение параметров)
{ "general": { "project_id": 2990, "payment_id": payment_id, "signature": "PJkV8ejrtyUGaC6tajQVVfBaNIipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 2000, "currency": "VND" }, "customer": { "ip_address": "192.0.2.0", "email": "email@example.com", "id": "customer1" }, "account":{ "bank_id": 135 } }
Рис.: Пример достаточного набора данных для запроса на оплату (при поддержке запросов на уточнение параметров)
{ "general": { "project_id": 2990, "payment_id": payment_id, "signature": "PJkV8ejrtyUGaC6tajQVVfBaNIipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 2000, "currency": "VND" }, "customer": { "ip_address": "192.0.2.0", "email": "email@example.com", "id": "customer1" }, "account":{ "bank_id": 135 } }
Рис.: Пример достаточного набора данных для запроса на оплату (без поддержки запросов на уточнение параметров)
{ "general": { "project_id": 2990, "payment_id": payment_id, "signature": "PJkV8ejrtyUG0aC6tajQVVfBaNIipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 2000, "currency": "VND" }, "customer": { "ip_address": "192.0.2.0", "email": "email@example.com", "id": "customer1" }, "account":{ "bank_id": 135, }, "card": { "pan": "4314220000000056", "card_holder": "FORD PREFECT", "year": 2018, "month": 11 } }
Рис.: Пример достаточного набора данных для запроса на оплату (без поддержки запросов на уточнение параметров)
{ "general": { "project_id": 2990, "payment_id": payment_id, "signature": "PJkV8ejrtyUG0aC6tajQVVfBaNIipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 2000, "currency": "VND" }, "customer": { "ip_address": "192.0.2.0", "email": "email@example.com", "id": "customer1" }, "account":{ "bank_id": 135, }, "card": { "pan": "4321432154325432", "card_holder": "FORD PREFECT", "year": 2018, "month": 11 } }
Формат промежуточных оповещений для перенаправления пользователей
Для перенаправления пользователей от веб-сервиса мерчанта к сервису Vietnamese ATM при проведении каждого платежа с использованием метода Vietnamese ATM необходимо принять промежуточное оповещение от платёжной платформы и использовать информацию из него, включённую в объект redirect_data
. Формат таких оповещений является типовым (подробнее), при этом в состав объекта redirect_data
включаются следующие объекты и параметры:
body
— объект с данными для отправки в теле запроса;method
— параметр с указанием HTTP-метода отправки запроса (GET
илиPOST
);url
— параметр со ссылкой для перенаправления.
Рис.: Пример объекта redirect_data
"redirect_data": { "body": {}, "method": "GET", "url": "https://www.example.com/pay" }
Формат итоговых оповещений
Для оповещений о результатах оплат с применением метода Vietnamese ATM используется типовой формат, описание которого представлено в разделе Оповещения.
В следующем примере оповещение свидетельствует о том, что в рамках проекта 603
была проведена оплата в размере 2 000 VND
.
Рис.: Пример данных из оповещения о проведении оплаты
{
"project_id": 603,
"payment": {
"id": "TEST_154385980520099",
"type": "purchase",
"status": "success",
"date": "2018-12-03T13:06:32+0000",
"method": "ATM Vietnam banking",
"sum": {
"amount": 2000,
"currency": "VND"
},
"description": "TEST_1543831735980"
},
"customer": {
"id": "1"
},
"operation": {
"id": 12919000002116,
"type": "sale",
"status": "success",
"date": "2018-12-03T13:06:32+0000",
"created_date": "2018-12-03T13:06:29+0000",
"request_id": "41fcbd2791eabee713b7d7e89e53",
"sum_initial": {
"amount": 2000,
"currency": "VND"
},
"sum_converted": {
"amount": 2000,
"currency": "VND"
},
"provider": {
"id": 1154,
"payment_id": "",
"auth_code": ""
},
"code": "0",
"message": "Success"
},
"signature": "Cug4rIB6OimEkwmE/eugWYrFyBErmi0OVw34WpHt5CzEA=="
}
В следующем примере оповещение свидетельствует об отклонённой оплате.
Рис.: Пример данных из оповещения об отклонении оплаты
{
"project_id": 603,
"payment": {
"id": "TEST_1548313365790",
"type": "purchase",
"status": "decline",
"date": "2019-01-24T09:43:27+0000",
"method": "ATM Vietnam banking",
"sum": {
"amount": 4000,
"currency": "VND"
},
"description": "TEST_1548313365790"
},
"customer": {
"id": "1"
},
"operation": {
"id": 3745000002722,
"type": "sale",
"status": "decline",
"date": "2019-01-24T09:43:27+0000",
"created_date": "2019-01-24T09:41:49+0000",
"request_id": "3a872bd43f92091",
"sum_initial": {
"amount": 4000,
"currency": "VND"
},
"sum_converted": {
"amount": 4000,
"currency": "VND"
},
"provider": {
"id": 1154,
"payment_id": "010UDR0CCTJEPAN6KFWU14VDN",
"date": "2019-01-24T09:42:58+0000",
"auth_code": ""
},
"errors": [
{
"code": "2801",
"message": "Bank ID not found",
"description": "Gate. Bank ID was not found in request"
}
],
"code": "2801",
"message": "Bank ID not found"
},
"signature": "cQbMiD0pON9eJc5ZugNQiyWj7NWQRmVyHzNTmOX6Zg5w=="
}
Дополнительные материалы
Для организации работы с оплатами через Gate также могут быть полезны следующие материалы:
- Организация взаимодействия — о том, как взаимодействовать с платёжной платформой через Gate.
- Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
- Модель проведения платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
- Разовая оплата в одну стадию — о том, как проводить разовые оплаты через Gate.
- Информация об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.
Выплаты через Gate
Общая информация
Для проведения выплаты через Gate с использованием метода Vietnamese ATM со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. Полная схема проведения выплаты выглядит следующим образом.
Рис.: Проведение выплаты через Gate. Описание шагов
- Пользователь на стороне веб-сервиса инициирует выплату через Vietnamese ATM.
- От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение выплаты через Gate.
- Запрос на проведение выплаты поступает в платёжную платформу.
- В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
- От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее — в разделе Формат ответа.
- В платёжной платформе обеспечиваются дальнейшая обработка запроса (с проверкой согласованности параметров) и его отправка в сервис банка.
- В сервисе банка выполняется обработка выплаты.
- От сервиса банка к платёжной платформе направляется информация о результате выплаты.
- От платёжной платформы к веб-сервису направляется оповещение о результате выплаты.
- На стороне веб-сервиса обеспечивается информирование пользователя о результате выплаты.
Информация о форматах запросов и оповещений, используемых для проведения выплат методом Vietnamese ATM через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.
Формат запросов
При работе с запросами на выплаты с применением метода Vietnamese ATM необходимо учитывать следующее:
- Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке
/v2/payment/atm/vietnam/payout
. Эта конечная точка относится к группе /v2/payment/atm/{payment_method}/payout. - В запросе должны использоваться следующие объекты и параметры:
general
— объект, содержащий основные идентификационные сведения запроса:project_id
— идентификатор проекта, полученный от ecommpay при интеграции;,payment_id
— идентификатор платежа, уникальный в рамках проекта;,signature
— подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью к данным); (подробнее),
payment
— объект, содержащий сведения о платеже:amount
— сумма платежа (без выделения дробной части, поскольку при работе с валютой VND дробные единицы не используются);,currency
— код валюты платежа в формате ISO-4217 alpha-3;,
customer
— сведения о пользователе:id
— идентификатор пользователя, уникальный в рамках проекта;,ip_address
— IP-адрес пользователя, актуальный для инициируемой выплаты;,
account
— сведения о счёте пользователя:bank_id
— идентификатор банка;,region_id
— регион;,
card
— сведения о платёжной карте пользователя:pan
— PAN (Primary Account Number) карты;,year
— год истечения срока действия карты;,month
— месяц истечения срока действия карты;,card_holder
— имя держателя карты.
- Валютой платежа может быть только VND.
- Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.
Таким образом, корректный запрос на выплату с применением метода Vietnamese ATM должен содержать идентификатор проекта, базовые сведения о платеже (его идентификатор, сумму и код валюты), информацией о пользователе и его платёжной карте, номер счёта и подпись.
{ "general": { "project_id": 603, "payment_id": "10000004", "signature": "PJkV8ej\/UG0Di8hTnaNIipTv+AWoXW\/9MTO8yJA==" }, "card": { "pan": "4242424242424242", "month": 12, "year": 2021, "card_holder": "Card Holder" }, "account":{ "bank_id": 130, "region_id": 137 }, "customer": { "id":"2990", "ip_address": "192.0.2.0" }, "payment": { "amount": 100000, "currency": "VND" } }
Рис.: Пример достаточного набора данных для запроса на оплату
{ "general": { "project_id": 603, "payment_id": "10000004", "signature": "PJkV8ej\/UG0Di8hTnaNIipTv+AWoXW\/9MTO8yJA==" }, "card": { "pan": "4314220000000056", "month": 12, "year": 2021, "card_holder": "Card Holder" }, "account":{ "bank_id": 130, "region_id": 137 }, "customer": { "id":"2990", "ip_address": "192.0.2.0" }, "payment": { "amount": 100000, "currency": "VND" } }
Формат оповещений
Для оповещений о результатах выплат с применением метода Vietnamese ATM используется типовой формат, описание которого представлено в разделе Оповещения.
В следующем примере оповещение свидетельствует о том, что в рамках проекта 603
для пользователя 111232323
была проведена выплата в размере 100 000 VND
.
Рис.: Пример данных из оповещения о проведении выплаты
{ "project_id": 603, "payment": { "id": "100000010", "type": "payout", "status": "success", "date": "2019-02-22T13:50:52+0000", "method": "ATM Vietnam banking", "sum": { "amount": 100000, "currency": "VND" }, "description": "" }, "account": { "number": "424242******4242" }, "customer": { "id": "111232323" }, "operation": { "id": 2000000472, "type": "payout", "status": "success", "date": "2019-02-22T13:50:52+0000", "created_date": "2019-02-22T13:50:48+0000", "request_id": "c0c14111edf06ba2", "sum_initial": { "amount": 100000, "currency": "VND" }, "sum_converted": { "amount": 100000, "currency": "VND" }, "provider": { "id": 1331, "payment_id": "843", "auth_code": "" }, "code": "0", "message": "Success" }, "signature": "qeaYBc4TzLFqiQXvz50SJDdevayqTjWGDoDatdK4CHaPpw==" }
В следующем примере оповещение свидетельствует об отклонённой выплате.
Рис.: Пример данных из оповещения об отклонении выплаты
{ "project_id": 603, "payment": { "id": "10000034", "type": "payout", "status": "decline", "date": "2019-02-22T14:00:17+0000", "method": "ATM Vietnam banking", "sum": { "amount": 100000, "currency": "VND" }, "description": "" }, "account": { "number": "424242******4242" }, "customer": { "id": "111232323" }, "operation": { "id": 2000000474, "type": "payout", "status": "decline", "date": "2019-02-22T14:00:17+0000", "created_date": "2019-02-22T14:00:14+0000", "request_id": "a43380dbe08d069b0dd61c895db3257", "sum_initial": { "amount": 100000, "currency": "VND" }, "sum_converted": { "amount": 100000, "currency": "VND" }, "provider": { "id": 1330, "payment_id": "770", "auth_code": "" }, "errors": [ { "code": "2801", "message": "Bank ID not found", "description": "Gate. Bank ID was not found in request" } ], "code": "2801", "message": "Bank ID not found" }, "signature": "rdewQxGU7ur5c0h6XfZgfMwWJKJMLoC5Pfpcn9TrQC4IamAw==" }
Дополнительные материалы
Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:
- Организация взаимодействия — о том, как взаимодействовать с платёжной платформой через Gate.
- Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
- Модель проведения платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
- Выплаты — о том, как проводить выплаты через Gate.
- Информация об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.
Анализ результатов проведения платежей
Для анализа информации о платежах и операциях, как в отдельности по методу Vietnamese ATM, так и в совокупности с другими методами, можно использовать:
- инструментарий интерфейса Dashboard, с различными реестрами и аналитическими панелями;,
- отчёты в формате CSV, выгружаемые (как разово, так и периодически) через раздел Отчёты интерфейса Dashboard;,
- данные в формате JSON, получаемые по программным запросам через интерфейс Data API.
С вопросами по анализу информации можно обращаться к разделам документации (Dashboard и Использование Data API) и специалистам ecommpay.