Page History
...
| Table of Contents |
|---|
Оплата токеном - это технология оплаты в магазинах и интернете с помощью некоторых мобильных устройств, основные производители которых предоставляют средства для проведения платежей через систему токенизации, например, Apple Pay, Samsung Pay или Google Pay.
Возможны 4 варианта проведения оплаты:
- Оплата через платёжный терминал, при этом мобильное устройство прикладывается к считывателю банковских карт аналогично прикладыванию карт с поддержкой бесконтактной оплаты. Такие платежи проводятся как POS транзакции.
- Оплата по кнопке, встроенной в мобильное приложение магазина (InApp схема). Такие платежи проводятся как ECOM транзакции.
- Оплата в браузере (Web схема), при этом получение шифрованного пакета с платёжными данными и токеном выполняется на стороне платёжных страниц АПК Ассист. Такие платежи проводятся как ECOM транзакции.
- Оплата в браузере (Web схема), при этом получение шифрованного пакета с платёжными данными и токеном выполняется на странице интернет-магазина. Такие платежи проводятся как ECOM транзакции.
Ассист предоставляет возможности организовать приём платежей токенами по всем 4 вариантам. Однако, отдельные провайдеры токенов поддерживают не все варианты проведения платежей. В таблице ниже представлены возможные варианты организации платежей токенами с использованием разных провайдеров.
...
Провайдер токена
...
POS оплата
...
Оплата по кнопке в мобильном приложении (InApp)
...
Оплата в браузере на стороне АПК Ассист (Web)
...
Оплата в браузере на стороне магазина (Web)
...
Apple Pay
...
Через приложение Assist.mPOS + считыватель карт
...
С использованием Assist.SDK для iOS
или
Apple Pay SDK + сервис TokenPay
...
Будет реализовано в I квартале 2018 г. (только при платеже в браузере Safari на платформе MacOS)
...
Только в браузере Safari на платформе MacOS, используя примеры работы с ApplePay JS API с сайта разработчиков Apple Pay и сервис TokenPay
...
Samsung Pay
...
Через приложение Assist.mPOS+ считыватель карт
...
В настоящий момент не поддерживается со стороны Samsung Pay
...
Через интеграцию с платежными страницами АПК Ассист или из мобильного приложения через WebView
...
Не поддерживается со стороны Samsung Pay
...
Google Pay*
...
Через приложение Assist.mPOS+ считыватель карт
...
С использованием Google Pay API + сервис TokenPay
...
Платеж на мобильном устройстве, через браузер с поддержкой Payment Request API при переходе на платежную страницу Ассист с сайта магазина или из мобильного приложения магазина через WebView.
...
При платеже на мобильном устройстве, через браузер с поддержкой Payment Request API: используя примеры кода по работе с Payment Request API на сайте разработчиков Google и сервис TokenPay
*В настоящий момент в рамках Google Pay поддерживается оплата только токенизированной картой (ранее такой метод оплаты имел название Android Pay). Оплата привязанными к аккаунту Google картами невозможна в связи с ограничениями банков.
Таким образом, для разработчиков мобильных приложений доступны следующие варианты проведения оплаты:
Для Apple Pay только вариант оплаты по кнопке в приложении:
- с использованием Assist.SDK для iOS;
- с использованием Apple Pay SDK + сервис TokenPay.
Для Google Pay:
...
Для Samsung Pay: только оплата по кнопке на платежной странице АПК Ассист:
...
Для приёма платежей токенами на web-сайте магазина доступны следующие варианты:
Для Google Pay: только при открытии платёжной страницы на мобильном устройстве в браузере с поддержкой Payment Request API:
- по кнопке на платежной странице АПК Ассист;
- с использованием Payment Request API браузера и сервис TokenPay.
Для Samsung Pay:
- по кнопке на платежной странице АПК Ассист.
2. Оплата токеном через мобильный терминал
Ассист предоставляет возможность оплаты токенами Apple Pay, Samsung Pay и Google Pay в рамках настраиваемого под нужды конкретного заказчика мобильного приложения Assist.mPOS с использованием считывателя карт. С помощью Assist.MPOS и считывателя карт можно также принимать оплаты банковскими картами и наличными.
Для обсуждения возможностей по предоставлению данной услуги следует обращаться в службу технической поддержки АПК Ассист support@assist.ru.
3. Оплата токеном через кнопку в мобильном приложении (InApp)
При проведении оплаты токеном по кнопке в мобильном приложении выполняются следующие действия:
- Покупатель выбирает товар или услугу в мобильном приложении магазина и нажимает кнопку оплатить.
- Зашифрованный пакет с данными платежа и токеном формируется через обращение к SDK соответствующего провайдера: Apple Pay, Samsung Pay или Google Pay API.
- SDK провайдера проводит необходимою авторизацию платежа покупателем на мобильном устройстве (PIN/отпечаток пальца).
- Зашифрованный пакет с данными платежа и токеном передается в сервис оплаты TokenPay на стороне АПК Ассист .
- АПК Ассист расшифровывает пакет и проводит платеж токеном.
- АПК Ассист возвращает результаты проведения оплаты в мобильное приложение.
Действия с 2 до 6 могут быть выполнены однократным обращением к SDK Assist:
...
через кнопку в мобильном приложении (InApp)
Apple Pay
При проведении оплаты токеном по кнопке в мобильном приложении выполняются следующие действия:
- Покупатель выбирает товар или услугу в мобильном приложении магазина и нажимает кнопку Оплатить.
- Зашифрованный пакет с данными платежа и токеном формируется через обращение к SDK Apple Pay API.
- SDK Apple Pay проводит необходимою авторизацию платежа покупателем на мобильном устройстве (PIN/отпечаток пальца).
- Зашифрованный пакет с данными платежа и токеном передается в сервис оплаты TokenPay на стороне АПК Ассист.
- АПК Ассист расшифровывает пакет и проводит платеж токеном.
- АПК Ассист возвращает результаты проведения оплаты в мобильное приложение.
Действия с 2 до 6 могут быть выполнены однократным обращением к SDK Assist:
- SDK Assist для Apple Pay доступен на https://github.com/assist-group/assist-mcommerce-sdk-ios
Если в мобильном приложении предприятия (магазина) SDK Assist не используется, то для создания шифрованного пакета с данными о платеже необходимо использовать соответствующий SDK – Apple Pay SDK для IOS или Google Pay API для Android. Созданный шифрованный пакет с данными о платеже затем должен передаваться в АПК Ассист через сервис TokenPay.
Для организации приема платежей через кнопку в мобильном приложении нужно выполнить следующие подготовительные шаги:
- сделать заявку для подключения к функционалу сервиса обработки платежей TokenPay в службу технической поддержки АПК Ассист support@assist.ru;
- внедрить в свое приложение поддержку оплаты заказов токеном, используя Assist SDK, SDK Apple Pay вместе с обращением к сервису TokenPay;
- получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для функционирования сервиса обработки платежей TokenPay при оплате товаров и услуг данному предприятию выполнены;
- подготовиться к приему платежей - создать и подписать сертификат Apple Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист.
Google Pay
При проведении оплаты токеном по кнопке в мобильном приложении выполняются следующие действия:
- Покупатель выбирает товар или услугу в мобильном приложении магазина и нажимает кнопку Оплатить.
- Зашифрованный пакет с данными платежа и токеном формируется через обращение к SDK Google Pay API.
- SDK Google Pay проводит необходимою авторизацию платежа покупателем на мобильном устройстве (PIN/отпечаток пальца).
- Зашифрованный пакет с данными платежа и токеном передается в сервис оплаты TokenPay на стороне АПК Ассист.
- АПК Ассист расшифровывает пакет и проводит платеж токеном.
- АПК Ассист возвращает результаты проведения оплаты в мобильное приложение.
Если в мобильном приложении предприятия (магазина) SDK Assist не используется, то для создания шифрованного пакета с данными о платеже необходимо использовать Google Pay API для Android. Созданный шифрованный пакет с данными о платеже затем должен передаваться в АПК Ассист через сервис TokenPay.
Для организации приема платежей через кнопку в мобильном приложении нужно выполнить следующие подготовительные шаги:
- сделать заявку для подключения к функционалу сервиса обработки платежей TokenPay в службу технической поддержки АПК Ассист support@assist.ru;
- внедрить в свое приложение поддержку оплаты заказов токеном, используя Assist SDK, Google Pay API вместе с обращением к сервису TokenPay;
- получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для функционирования сервиса обработки платежей TokenPay при оплате товаров и услуг данному предприятию выполнены;
- подготовиться к приему платежей - необходимо зарегистрироваться в Google Pay API, получить уникальный идентификатор для использования в качестве параметра MerchantID, установить значение «assist» для параметра gateway и указать значение параметра allowedCardAuthMethods = ["CRYPTOGRAM_3DS"] для организации схемы шифрования пакета данных с токеном или allowedCardAuthMethods = ["PAN_ONLY", "CRYPTOGRAM_3DS"], если необходимо также принимать платежи сохраненными в учетной записи Google нетокенизированными картами.
Samsung Pay
При проведении оплаты токеном по кнопке в мобильном приложении выполняются следующие действия:
- Покупатель выбирает товар или услугу в мобильном приложении магазина и нажимает кнопку Оплатить.
- Зашифрованный пакет с данными платежа и токеном формируется через обращение к SDK Samsung Pay API.
- SDK Samsung Pay проводит необходимою авторизацию платежа покупателем на мобильном устройстве (PIN/отпечаток пальца).
- Зашифрованный пакет с данными платежа и токеном передается в сервис оплаты TokenPay на стороне АПК Ассист .
- АПК Ассист расшифровывает пакет и проводит платеж токеном.
- АПК Ассист возвращает результаты проведения оплаты в мобильное приложение.
Если в мобильном приложении предприятия (магазина) SDK Assist не используется, то для создания шифрованного пакета с данными о платеже необходимо использовать Samsung Pay SDK для Android. Созданный шифрованный пакет с данными о платеже затем должен передаваться в АПК Ассист через сервис TokenPay.
Для организации приема платежей через кнопку в мобильном приложении нужно выполнить следующие подготовительные шаги:
- сделать заявку для подключения к функционалу сервиса обработки платежей TokenPay в службу технической поддержки АПК Ассист support@assist.ru;
- внедрить в свое приложение поддержку оплаты заказов токеном, используя Assist SDK, Samsung Pay SDK вместе с обращением к сервису TokenPay;
- получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для функционирования сервиса обработки платежей TokenPay при оплате товаров и услуг данному предприятию выполнены;
- подготовиться к приему платежей - создать и подписать сертификат Samsung Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист.
Mir Pay
При проведении оплаты токеном по кнопке в мобильном приложении выполняются следующие действия:
- Покупатель выбирает товар или услугу в мобильном приложении магазина и нажимает кнопку Оплатить.
- Зашифрованный пакет с данными платежа и токеном формируется через обращение к SDK Mir Pay API.
- SDK Mir Pay проводит необходимою авторизацию платежа покупателем на мобильном устройстве (PIN/отпечаток пальца).
- Зашифрованный пакет с данными платежа и токеном передается в сервис оплаты TokenPay на стороне АПК Ассист.
- АПК Ассист расшифровывает пакет и проводит платеж токеном.
- АПК Ассист возвращает результаты проведения оплаты в мобильное приложение.
Если в мобильном приложении предприятия
| Warning |
|---|
Внимание! На данный момент Samsung Pay не поддерживает описанную выше схему проведения платежа. |
...
(магазина) SDK Assist не используется, то для создания шифрованного пакета с данными о платеже необходимо использовать
...
Mir Pay SDK
...
для Android. Созданный шифрованный пакет с данными о платеже затем должен передаваться в АПК Ассист через сервис TokenPay.
Для организации приема платежей через кнопку в мобильном приложении нужно выполнить следующие подготовительные шаги:
- сделать заявку для подключения к функционалу сервиса обработки платежей TokenPay в службу технической поддержки АПК Ассист Ассист support@assist.ru;
- внедрить в свое приложение поддержку оплаты заказов токеном, используя Assist SDK, SDK Apple Pay или Google Pay API) вместе Mir Pay SDK вместе с обращением к сервису TokenPay;
- получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для функционирования сервиса обработки платежей TokenPay при оплате товаров и услуг данному предприятию выполнены;
- подготовиться к приему платежей :при использовании Apple Pay создать и подписать сертификат Apple
- - получить сертификат Mir Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист ;
- при использовании Google Pay для организации схемы шифрования пакета данных с токеном следует применять публичный ключ Public Key: 'BElVf3z1PE68riWbP0YRp4vC+0MuNbd6pqVAe1uHBHYGJvzZonlkVAp5CEEp2EEUswS7hS1y0RyNB3SR2FVExDQ=' и идентификатор мерчанта MerchantID:'16590966430175452581'.
4. Оплата токеном на платежной странице АПК Ассист
При оплате токеном Samsung Pay на платежной странице AПK Ассист выполняются следующие действия:
- Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку «Оплатить», после чего магазин переадресует покупателя на платёжную страницу АПК Ассист.
- На платёжной странице АПК Ассист покупатель может нажать кнопку оплаты токеном.
- Специальный плагин Samsung Pay запрашивает SamsungID пользователя.
- Плагин отправляет на сервер Samsung Pay запрос на проведение платежа.
- Сервер Samsung Pay посылает PUSH уведомление на мобильное устройство покупателя.
- Покупатель выбирает одну из привязанных карт.
- Покупатель подтверждает оплату (PIN-код или отпечаток пальца).
- Мобильное устройство передаёт данные на сервер Samsung Pay.
- АПК Ассист получает от сервера Samsung Pay шифрованный пакет с токеном и данными платежа.
- АПК Ассист расшифровывает пакет с токеном и данными платежа.
- АПК Ассист проводит оплату токеном через процессинг расчётного банка.
- АПК Ассист возвращает результаты проведения оплаты на сайт интернет-магазина.
При оплате токеном Google Pay на платежной странице APK Ассист выполняются следующие действия:
Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку «Оплатить», после чего магазин переадресует покупателя на платёжную страницу АПК Ассист.
Если пользователь открыл платёжную страницу АПК Ассист на мобильном устройстве в браузере с поддержкой Payment Request API, и на этом мобильном устройстве установлено приложение Google Pay, то он увидит и сможет нажать кнопку оплаты через Google Pay.
После нажатия кнопки оплаты через Google Pay откроется специальный диалог браузера, в котором можно выбрать одну из карт, привязанных в мобильном приложении Google Pay.
После выбора карты покупателю предлагается приложить палец к считывателю для подтверждения платежа.
Приложение Google Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его в АПК Ассист.
...
6. Передача платежной информации TokenPay
Оплата по токену
Параметры запроса:
...
3 символа
...
Код валюты, в которой указана сумма платежа OrderAmount (RUB, USD, EUR)
...
1 - Apple Pay
2 - Android Pay
3 - Samsung Pay
...
256 символов
...
Факс покупателя
...
Индекс предприятия связи покупателя
...
0 - Не конвертировать в базовую валюту
1 - Не конвертировать при возможности
2 - Всегда конвертировать
...
Формируется строка, сшитая из следующих параметров заказа:
Merchant_ID;OrderNumber;OrderAmount;OrderCurrency, разделенных точкой с запятой. На базе этой строки алгоритмом MD5 формируется дайджест. Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64
...
1 –рекуррентный платеж
...
Число, 15 цифр
...
Параметры ответа:
...
1) Для типа подписи MD5 - пусто
...
Описание веб-сервиса:
...
| language | xml |
|---|---|
| title | ../pay/tokenpay.wsdl |
| linenumbers | true |
...
- .
Диаграмма оплаты по токену
- Покупатель выбирает товар в приложении магазина.
- Покупатель подтвердил заказ.
- Заказ сформирован на сервере магазина.
- Покупатель подтвердил оплату токеном в приложении.
- Сервер магазина получает заказ для оплаты.
- Зашифрованная платежная информация с токеном отправляется в АПК Ассист.
- АПК Ассист расшифровывает пакет с токеном и данными платежа.
- АПК Ассист проводит авторизацию (оплату) в банке-эквайере.
- Осуществление межбанковской транзакции.
- Банк-эквайер возвращает результат оплаты.
- АПК Ассист возвращает результат оплаты на сервер магазина.
- Результат оплаты отображается в приложении магазина.
- АПК Ассист отправляет фискальные данные на сервер магазина.
- АПК Ассист отправляет электронный чек покупателю с помощью Email и/или СМС.
Дополнительно можно ознакомиться с вариантами организации платежей токенами с использованием разных провайдеров.