Token pay

1.   Основные особенности оплаты токеном

Оплата токеном - это технология оплаты в магазинах и интернете с помощью некоторых мобильных устройств, основные производители которых предоставляют средства для проведения платежей через систему токенизации, например, Apple Pay, Samsung Pay или Google Pay.

Возможны 4 варианта проведения оплаты:

1. Оплата через платёжный терминал, при этом мобильное устройство прикладывается к считывателю банковских карт аналогично прикладыванию карт с поддержкой бесконтактной оплаты. Такие платежи проводятся как POS транзакции.
2. Оплата по кнопке, встроенной в мобильное приложение магазина (InApp схема). Такие платежи проводятся как ECOM транзакции.
3. Оплата в браузере (Web схема), при этом получение шифрованного пакета с платёжными данными и токеном выполняется на стороне платёжных страниц АПК Ассист. Такие платежи проводятся как ECOM транзакции.
4. Оплата в браузере (Web схема), при этом получение шифрованного пакета с платёжными данными и токеном выполняется на странице интернет-магазина. Такие платежи проводятся как ECOM транзакции.

Ассист предоставляет возможности организовать приём платежей токенами по всем 4 вариантам. Однако, отдельные провайдеры токенов поддерживают не все варианты проведения платежей. В таблице ниже представлены возможные варианты организации платежей токенами с использованием разных провайдеров.

*В настоящий момент в рамках Google Pay поддерживается оплата только токенизированной картой (ранее такой метод оплаты имел название Android Pay). Оплата привязанными к аккаунту Google картами невозможна в связи с ограничениями банков.

Таким образом, для разработчиков мобильных приложений доступны следующие варианты проведения оплаты:

Для Apple Pay только вариант оплаты по кнопке в приложении:

• с использованием Assist SDK для iOS; (через WebView) — для оплаты по кнопке на платежной странице АПК Ассист;
  
• с использованием Assist.SDK для iOS;
• с использованием Apple Pay SDK + сервис TokenPay.

Для Google Pay:

• с использованием Assist SDK для Android (через WebView) — для оплаты по кнопке на платежной странице АПК Ассист;
• с использованием Google API + сервис TokenPay  — для оплаты по кнопке в приложении.

Для Samsung Pay: только оплата по кнопке на платежной странице АПК Ассист:

• с использованием Assist SDK для Android (через WebView).

Для приёма платежей токенами на 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)

При проведении оплаты токеном по кнопке в мобильном приложении выполняются следующие действия:

1. Покупатель выбирает товар или услугу в мобильном приложении магазина и нажимает кнопку оплатить.
2. Зашифрованный пакет с данными платежа и токеном формируется через обращение к SDK соответствующего провайдера: Apple Pay, Samsung Pay или Google Pay API.
3. SDK провайдера проводит необходимою авторизацию платежа покупателем на мобильном устройстве (PIN/отпечаток пальца).
4. Зашифрованный пакет с данными платежа и токеном передается в сервис оплаты TokenPay на стороне АПК Ассист .
5. АПК Ассист расшифровывает пакет и проводит платеж токеном.
6. АПК Ассист возвращает результаты проведения оплаты в мобильное приложение.

Действия с 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 или Google Pay API) вместе с обращением к сервису TokenPay;
• получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для функционирования сервиса обработки платежей TokenPay при оплате товаров и услуг данному предприятию выполнены;
• подготовиться к приему платежей:
  • при использовании Apple Pay создать и подписать сертификат Apple Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист;
  • при использовании Google Pay для организации схемы шифрования пакета данных с токеном следует применять публичный ключ Public Key: 'BElVf3z1PE68riWbP0YRp4vC+0MuNbd6pqVAe1uHBHYGJvzZonlkVAp5CEEp2EEUswS7hS1y0RyNB3SR2FVExDQ=' и идентификатор мерчанта MerchantID:'16590966430175452581'.

4.   Оплата токеном на платежной странице АПК Ассист

При оплате токеном Samsung Pay на платежной странице AПK Ассист выполняются следующие действия:

1. Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку «Оплатить», после чего магазин переадресует покупателя на платёжную страницу АПК Ассист.
2. На платёжной странице АПК Ассист покупатель может нажать кнопку оплаты токеном.
3. Специальный плагин Samsung Pay запрашивает SamsungID пользователя.
4. Плагин отправляет на сервер Samsung Pay запрос на проведение платежа.
5. Сервер Samsung Pay посылает PUSH уведомление на мобильное устройство покупателя.
6. Покупатель выбирает одну из привязанных карт.
7. Покупатель подтверждает оплату (PIN-код или отпечаток пальца).
8. Мобильное устройство передаёт данные на сервер Samsung Pay.
9. АПК Ассист получает от сервера Samsung Pay шифрованный пакет с токеном и данными платежа.
10. АПК Ассист расшифровывает пакет с токеном и данными платежа.
11. АПК Ассист проводит оплату токеном через процессинг расчётного банка.
12. АПК Ассист возвращает результаты проведения оплаты на сайт интернет-магазина.

При оплате токеном Google Pay на платежной странице APK Ассист выполняются следующие действия:

1. Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку «Оплатить», после чего магазин переадресует покупателя на платёжную страницу АПК Ассист.
2. Если пользователь открыл платёжную страницу АПК Ассист на мобильном устройстве в браузере с поддержкой Payment Request API, и на этом мобильном устройстве установлено приложение Google Pay, то он увидит и сможет нажать кнопку оплаты через Google Pay.
3. После нажатия кнопки оплаты через Google Pay откроется специальный диалог браузера, в котором можно выбрать одну из карт, привязанных в мобильном приложении Google Pay.
4. После выбора карты покупателю предлагается приложить палец к считывателю для подтверждения платежа.
5. Приложение Google Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его в АПК Ассист.
6. АПК Ассист расшифровывает пакет с токеном и данными платежа.
7. АПК Ассист проводит оплату токеном через процессинг расчётного банка.
8. АПК Ассист возвращает результаты проведения оплаты интернет-магазину.

Для организации приема платежей токеном на платежной странице АПК Ассист нужно выполнить следующие подготовительные шаги:

• сделать заявку для подключения платёжных средств для оплаты токенами (Google Pay, Samsung Pay) в службу технической поддержки АПК Ассист support@assist.ru;
• получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для приема платежей токенами при оплате товаров и услуг данному предприятию выполнены.

5.   Оплата токеном в браузере на стороне магазина

При проведении оплаты токеном Google Pay в браузере на стороне магазина выполняются следующие действия:

1. Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку оплаты Google Pay (доступно в браузерах с поддержкой Payment Request API на мобильных устройствах).
2. После нажатия кнопки оплаты через Google Pay осуществляется вызов Payment Request API и передача сертификата с публичным ключом Ассист.
3. Открывается специальный диалог браузера, в котором можно выбрать одну из карт, привязанных в мобильном приложении Google Pay.
4. После выбора карты покупателю предлагается приложить палец к считывателю для подтверждения платежа. 
5. Приложение Google Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его скрипту страницы магазина.
6. Зашифрованный пакет с токеном и данными платежа передается в сервис TokenPay АПК Ассист .
7. АПК Ассист расшифровывает пакет с токеном и данными платежа.
8. АПК Ассист проводит оплату токеном через процессинг расчётного банка.
9. АПК Ассист возвращает результаты проведения оплаты интернет-магазину.

При проведении оплаты токеном Apple Pay в браузере на стороне магазина выполняются следующие действия:

1. Покупатель выбирает товары на сайте интернет-магазина и нажимает кнопку оплаты Apple Pay (доступно только в браузере Safari на платформе MacOS).
2. После нажатия кнопки оплаты через Apple Pay осуществляется вызов Payment Request API и передача сертификата с публичным ключом мерчанта. Одновременно открывается специальный диалог, в котором можно будет выбрать одну из карт, привязанных в мобильном приложении Apple Pay.
3. После выбора карты покупателю направляется PUSH уведомление на iPhone и предлагается приложить палец к считывателю для подтверждения платежа.
4. Приложение Apple Pay формирует зашифрованный пакет с токеном и данными платежа и возвращает его скрипту страницы магазина.
5. Зашифрованный пакет с токеном и данными платежа передается в сервис TokenPay АПК Ассист .
6. АПК Ассист расшифровывает пакет с токеном и данными платежа.
7. АПК Ассист проводит оплату токеном через процессинг расчётного банка.
8. АПК Ассист возвращает результаты проведения оплаты интернет-магазину

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

• сделать заявку для подключения платёжных средств для оплаты токенами (Apple Pay, Google Pay) в службу технической поддержки АПК Ассист support@assist.ru;
• интегрировать в код своей страницы:
  • для получения шифрованного пакета с токеном и данными платежа:
    • Payment Request API для Google Pay;
    • ApplePay JS API для Apple Pay;
  • для проведения оплаты – обращение к сервису TokenPay;
• получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для приёма платежей токенами при оплате товаров и услуг данному предприятию выполнены;
• подготовиться к приему платежей:
  • при использовании Apple Pay создать и подписать сертификат Apple Pay для выполнения платежей с помощью соответствующего раздела в ЛК АПК Ассист;
  • при использовании Google Pay для организации схемы шифрования токена следует применять публичный ключ Public Key: 'BElVf3z1PE68riWbP0YRp4vC+0MuNbd6pqVAe1uHBHYGJvzZonlkVAp5CEEp2EEUswS7hS1y0RyNB3SR2FVExDQ=' и идентификатор мерчанта MerchantID:'16590966430175452581'.

6. Передача платежной информации TokenPay

Для передачи зашифрованного блока данных о платеже нужно отправить запрос на сервер АПК Ассист методом HTTP POST (в кодировке UTF-8).

URL запроса для передачи зашифрованного блока данных о платеже:

https://<SERVER_NAME>/pay/tokenpay.cfm ,

где <SERVER_NAME> - адрес сервера который предоставляется службой поддержки Ассист в процессе подключения.

Список параметров запроса:

Список параметров ответа:

Пример результата запроса в формате JSON:

{"order":
{
    "ordernumber":"26012015_4"
    ,"billnumber":"5899110210668265"
    ,"testmode":"0"
    ,"ordercomment":"тестовый платеж"
    ,"orderamount":"24.00"
    ,"ordercurrency":"RUB"
    ,"firstname":""
    ,"lastname":""
    ,"middlename":""
    ,"email":""
    ,"orderdate":"26.01.2015 17:25:39"
    ,"orderstate":"Timeout"
    ,"fraud_state":""
    ,"fraud_reason":""
    ,"checkvalue":"85C6C974AADC1CADFCFD195730ED090B"
    ,"operations":[
{"billnumber":"5899110210668265.1"
,"operationtype":"100"
,"operationstate":"TimeOut"
,"amount":"24.00"
,"currency":"RUB"
,"clientip":"10.20.10.85"
,"ipaddress":"0.0.0.0"
,"meantype_id":"61"
,"meantypename":"SamsungPay"
,"meansubtype":""
,"meannumber":""
,"cardholder":""
,"issuebank":"UNKNOWN"
,"bankcountry":"UNKNOWN"
,"responsecode":"AS200"
,"message":"Data input timeout."
,"customermessage":"Data input timeout."
,"recommendation":""
,"approvalcode":""
,"protocoltypename":"NET"
,"processingname":""
,"operationdate":"26.01.2015 17:25:39"
,"authresult":""
,"authrequired":""
,"slipno":""}
]
}
,"packetdate":"26.01.2015 18:16:19"
}

Диаграмма оплаты по токену

1. Покупатель выбирает товар в приложении магазина.
2. Покупатель подтвердил заказ.
3. Заказ сформирован на сервере магазина.
4. Покупатель подтвердил оплату токеном в приложении.
5. Сервер магазина получает заказ для оплаты.
6. Зашифрованная платежная информация с токеном отправляется в систему Ассист.
7. Ассист расшифровывает пакет с токеном и данными платежа.
8. Ассист проводит авторизацию (оплату) в Банке-эквайере. 
   
9. Осуществление межбанковской транзакции.
   
10. Банк-эквайер возвращает результат оплаты.
    
11. Ассист возвращает результат оплаты на сервер магазина.
    
12. Результат оплаты отображается  в приложении магазина.
    
13. Ассист отправляет фискальные данные на сервер магазина.
    
14. Ассист отправляет электронный чек покупателю с помощью Email и/или СМС.