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: только оплата по кнопке на платежной странице АПК Ассист:

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

Для приёма платежей токенами на web-сайте магазина доступны следующие варианты:

Для Google Pay: только при открытии платёжной страницы на мобильном устройстве в браузере с поддержкой Payment Request API:

• по кнопке на платежной странице АПК Ассист;
• с использованием Payment Request API браузера и сервис TokenPay.

Для Samsung Pay:

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

Для Apple Pay только при открытии платёжной страницы в браузере Safari на платформе MacOS::

• по кнопке на платежной странице АПК Ассист;
• с использованием ApplePay JS API и сервиса TokenPay
  

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

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 и/или СМС.