Samsung pay framework что это
В одном из прошлых материалов мы уже рассказывали о сервисе мобильных платежей Google Pay от компании Google. В этот раз речь пойдет об аналогичном решении от компании Samsung. Сейчас вы узнаете, что такое Samsung Pay, как его установить, настроить и как им пользоваться.
Как настроить Samsung Pay
Чтобы оплата через Samsung Pay заработала, ее нужно предварительно настроить. Для этого запустите приложение Samsung Pay, войдите по вашей учетной записи Samsung и согласитесь с условиями использования.
После этого настройте удобный для вас способ разблокировки телефона. Для работы с сервисом Samsung Pay могут использоваться только надежный способы разблокировки. Например, сканирование радужки глаза или отпечаток пальца.
Также приложение попросит ввести отдельный PIN-код для Samsung Pay. Данный PIN-код будет использоваться только в этом приложении и отличается от основного PIN-кода, который используется для разблокировки телефона.
После этого вы попадете в основной интерфейс приложения Samsung Pay. Здесь нужно перейти в раздел «Оплата» и нажать на кнопку «Добавить карту».
Для добавления карты ее достаточно просто отсканировать при помощи камеры телефона.
Если со сканированием возникают трудности, то можно нажать на кнопку «Ввести вручную» и заполнить данные карты самостоятельно.
Последний этап настройки Samsung Pay – ввод собственной подписи в специальное поле на экране.
На этом настройка завершена. Подождите около 10 минут для того, чтобы ваша карта успешно зарегистрировалась в Samsung Pay. После этого телефон можно будет использовать для оплаты покупок.
Что это
Samsung Pay Framework – это приложение разработанное специалистами компании-производителя электроники специально для устройств Samsung. Его основная задача – обеспечить правильную работу системы оплаты предустановленной на смартфонах и гаджетах марки Samsung. Без этого элемента стабильность процессов на телефоне будет под угрозой – не исключены ошибки производительности, что особенно чревато негативными последствиями при совершении мобильных платежей.
Такое взаимодействие основной составляющей Samsung Pay Framework и непосредственно оболочки платежной системы гарантируют надежность и исполнительность устройства в момент проведения транзакций владельцем гаджета.
При этом дополнительных действий от пользователя не требуется. Все проходит в соответствии с привычным сценарием как с это прописано в рекомендациях с другим софтом. Системный инструмент достаточно лишь инсталлировать на смартфон Samsung и можно приступать к оплате услуг и покупок.
Samsung Pay по праву входит в число самых надежных платежных систем, что особенно примечательно она поддерживает бесконтактные технологии оплаты. Дополнительным преимуществом, по мнению пользователей, является возможность получать Samsung Rewards.
По сути это очки, которые начисляются владельцу гаджета просто за совершение обычных покупок с помощью фирменного приложения от производителя электроники. В свою очередь данные очки – это некая награда за лояльность к данному платежному инструменту и право на эксклюзивные подарки от производителя электроники.
Непосредственно платформа для проведения платежей не более чем оболочка, задача которой отображать и популяризировать название и известный бренд. Основой данного инструмента, ее настоящим двигателем является Samsung Pay Framework.
Необходимость обновить непосредственно приложения по оплате автоматически влечет за собой обновление и самой платформы. При этом наличие у пользователя root-прав делает невозможным использование в привычном режиме официальной версии приложения платежных систем.
Банковские, транспортные и клубные карты в смартфоне, чтобы вы могли совершать платежи
всего одним касанием.
Debug and Release mode
Apps configured for one of two modes can be registered in the Samsung Pay Developers site for the purpose of integrating Samsung Pay functionalities.
Debug mode – for testing and QA; requires debug key and allowed Samsung account(s) in build in order to test.
Release mode – for market release to end users; does not need a debug key or an allowed list of Samsung accounts in a Samsung-approved build to run.
Debug mode
To enable debug mode, you must add debug_mode and spay_debug_api_key to your AndroidManifest.xml file. The spay_debug_api_key is generated by the Samsung Pay Developers portal when you create a new In-App payments service.
The spay_debug_api_key is valid for 90 days and can be updated on the Samsung Pay Developers portal.
Release mode
To enable release mode, set debug_mode = N in your AndroidManifest.xml file.
With release mode enabled, your partner app is verified by its signature instead of a spay_debug_api_key, and there is no time limit.
Partner app verification
Depending on the mode configured—Debug or Release—verification of your registered app and service by the Samsung Pay SDK and its Developers portal entails version and eligibility checks to determine device and app compatibility. Likewise, your app needs to verify the presence of the Samsung Pay app on the device, its status, and whether or not its version is sufficient to support your implementation of the SDK.
The debug mode set in your Partner app allows for simplified verification as shown in the following table.
Какие телефоны поддерживают Samsung Pay
В отличие от Google Pay, который работает на любом современном смартфоне с NFC, платежный сервис Samsung Pay доступен только пользователям смартфонов от компании Samsung. При этом поддерживаются только относительно свежие модели. Ниже мы приводим полный список устройств, на которых можно использовать данный сервис.
- Galaxy Z SeriesGalaxy Z Fold3 5G
- Galaxy Z Flip3 5G
- Galaxy Z Fold2 5G*
- Galaxy Z Flip*
- Galaxy Fold*
- Galaxy Note20 | Note20 Ultra 5G*
- Galaxy Note10 Lite
- Galaxy Note10 | Note10+*
- Galaxy Note9*
- Galaxy Note8*
- Galaxy Note Fan Edition*
- Galaxy Note5*
- Galaxy S21 | S21+ | S21 Ultra 5G
- Galaxy S20 FE | S20 FE 5G
- Galaxy S20 | S20+ | S20 Ultra*
- Galaxy S10 Lite
- Galaxy S10e | S10 | S10+*
- Galaxy S9 | S9+*
- Galaxy S8 | S8+*
- Galaxy S7 edge | S7*
- Galaxy S6 edge+*
- Galaxy M22
- Galaxy M32
- Galaxy M52 5G
- Galaxy M62
- Galaxy A72
- Galaxy A71
- Galaxy A52s 5G
- Galaxy A52 | A52 5G
- Galaxy A51
- Galaxy A50s
- Galaxy A42 5G
- Galaxy A32 | A32 5G
- Galaxy A31
- Galaxy A30s
- Galaxy A80
- Galaxy A9 (2018)
- Galaxy A9 Pro*
- Galaxy A8 Star
- Galaxy A8 | A8+*
- Galaxy A7 (2018)
- Galaxy A7 (2016 & 2017)*
- Galaxy A5 (2016 & 2017)*
- Gear S3*
- Gear Sport
- Galaxy Watch
- Galaxy Watch Active
- Galaxy Watch Active2
- Galaxy Watch3
- Galaxy Watch4
- Galaxy Watch4 Classic
На устройствах со звездочкой (*) поддерживается оплата через NFC и MST (эмуляция магнитной ленты). Остальные устройства поддерживают только NFC.
Также нужно отметить, что Samsung Pay не будет работать на устройствах, где пользователь получил root-права. При этом восстановление стандартной прошивки не поможет. Устройства с root-правами навсегда теряют возможность работать с Samsung Pay.
Use case: App-to-app
The most common App-to-App (also referred to as App2App) use cases can be divided into three categories:
The push provisioning use case ― adding payment cards to Samsung Pay from the card issuer’s app ― typically takes this form:
The user logs into the issuer app.
The issuer app checks if Samsung Pay is activated on the device and ready to use. If it is in the ready status, the issuer app displays an Add button for cards not currently registered/enrolled with the Samsung Pay app.
If the add card option is selected, the issuer app calls an API to push the proper payload data to Samsung Pay.
While the card is being provisioned, Samsung Pay stays in background.
Как работает Samsung Pay
После того как все настроено, сервис Samsung Pay готов к работе. Для оплаты покупок нужно сказать кассиру, что вы будете оплачивать с помощью карты, после чего провести пальцем вверх от нижнего края экрана. Этот жест автоматически запустит приложение Samsung Pay и подготовит его к работе.
После запуска приложения нужно будет авторизоваться одним из настроенных способов. Это может быть сканирование радужки глаза, проверка отпечатка или ввод PIN-кода. После авторизации телефон нужно поднести платежному терминалу.
Для оплаты при помощи технологии NFC телефон нужно подносить к верхней части терминала.
Если терминал не поддерживает бесконтактную оплату с помощью NFC, то телефон нужно подносить к считывателю магнитной полосы (в правой части терминала). В этом случае оплата будет выполнена с использованием технологии Samsung MST (Magnetic Secure Transmission), которая эмулирует работу магнитной полосы платежной карты.
Благодаря своей функциональности и широкой поддержке магазинов, система бесконтактных платежей Samsung Pay является одним из лучших решений. Независимо от того, поддерживает ли терминал NFC, вы можете оплатить покупку при помощи смартфона Galaxy и Samsung Pay. Причина простая — практически все последние модели компании поддерживают технологию MST (Magnite Secure Transmissions).
К сожалению, некоторые владельцы Galaxy-устройств замечают один неприятный момент. Они жалуются на то, что приложение Samsung Pay Framework потребляет больше энергии, чем полагается. Более того, некоторые утверждают, что этот фреймворк способен разрядить батарею на 60 процентов всего за 2 часа. В это время они пользуются телефоном, то есть экран включен.
Спешим сообщить, что проблема решается несколькими простыми действиями. Ошибка пользователей в том, что они включают оптимизацию аккумулятора для приложения Samsung Pay Framework — ее нужно отключить. Если вы не знаете, как отключить оптимизацию потребления батареи, тогда следуйте нашей инструкции:
- Откройте настройки и перейдите в раздел “Приложения”.
- Далее находим в списке “Samsung Pay” и выбираем “Samsung Pay Framework”.
- Кликаем по “Аккумулятор”.
- Переводим переключатель оптимизации аккумулятора в выключенное состояние.
Это решение позволит снизить расход энергии на 40 процентов после 2 часов использования телефона. Принудительное завершение работы Samsung Pay Framework уменьшает скорость разрядки до 30 процентов за тот самый период времени. Не идеально, однако хоть что-то. Ждем от компании обновление, которое избавит пользователей от этой неприятности.
Недавно пользователи смартчасов Galaxy Watch боролись с плохой автономностью. Они появились после обновления, но в итоге быстро решились, не нанеся большого вреда владельцам гаджета.
Стабильная работа операционной системы смартфона или компьютера во многом зависит от синхронности и взаимодействия всех установленных программ и приложений. Нередко один софт разработан и установлен на устройство для создания условий функционирования другого ПО. Большинство пользователей знакомо с платежным инструментом, но не все понимают, что собой представляет софт Samsung Pay Framework, который устанавливают на телефонах с Андроид.
Setting up SDK development environment
The importance of maintaining a good development environment cannot be overstated. For integrating the Samsung Pay SDK with your partner app, the following prerequisites and recommendations help ensure a successful SDK implementation.
Understanding and using the SDK
The Samsung Pay SDK is an application framework for integrating selected Samsung Pay features with Android-based partner apps on Samsung devices. The following major operations are supported:
In-App Payment Gives customers the option of paying for products and services with Samsung Pay.
Push Provisioning Allows customers add a bank card to Samsung Pay from the issuer app by providing the required card details.
To integrate your partner application with the Samsung Pay SDK, the following components are included your SDK download:
Samsungpay.jar Contains classes and interfaces of the Samsung Pay SDK which need to be integrated to partner apps.
Javadoc Provides descriptions of the APIs included in the Samsung Pay SDK, along with sample code showing how to use them.
Sample merchant app and 'sample issuer app' showing how Samsung Pay APIs can be coded in a finished Android project. All major operations of Samsung Pay SDK are implemented for demonstration purposes.
API level attributes
As of SDK version 1.4, enhanced version control management has been introduced to improve backward compatibility and handle API dependency from country and Service Type. For example, if a partner integrates the latest SDK―for instance, API level 2.17―but continues to use APIs based in level 1.4, the partner app remains compatible with Samsung Pay apps supporting API level 1.4 without the necessity of upgrading the Samsung Pay app.
The chief characteristics and properties of the API level include:
Every API starting from version 1.4 has an API level assigned based on the SDK version number in which it is introduced.
The SDK’s Javadoc reference can be filtered by API level so you can determine the minimum API level you need to configure in the metadata section of your app’s 'AndroidManifest' file. The earliest possible version is 1.4.
This lets you use the API level defined in your 'AndroidManifest' without having to trigger an upgrade of the Samsung Pay app on the user’s device.
Implement the following usage in your 'AndroidManifest':
Use case: In-App Payment
The most common In-App (online) payment use cases take the following form:
Merchant app presents user with the option of making payment with Samsung Pay.
Upon the user selecting the Samsung Pay option, the merchant app calls the APIs included in the Samsung Pay SDK to initiate a transaction with Samsung Pay app.
Samsung Pay app responds with the tokenized payment information necessary to complete the transaction.
Merchant app forwards this payment information to the designated Payment Gateway (PG), either directly through the merchant's web server, or indirectly via the Samsung-PG Interface server for normal transaction processing.
Configuring debug mode
В магазин
без банковских
и клубных картВ Samsung Pay можно добавить карты платежных систем Mastercard, Visa и МИР.
Samsung Pay работает более чем со 135 банками в России
и Беларуси. А также поддерживает множество программ
лояльности разных магазинов, число которых увеличивается.
Узнайте, подключен ли ваш банк к Samsung Pay,
просто введя первые буквы названия:Больше нет необходимости носить все карты с собой – добавьте ваши кредитные, дебетовые и бонусные карты в Samsung Pay и оплачивайте покупки смартфоном или носимым устройством одним движением руки. Для проведения операции даже не нужен интернет. Вы можете добавить в Samsung Pay до 10 платежных карт и до 100 карт лояльности.
Также в Samsung Pay доступны быстрые и удобные денежные переводы по номеру телефона или номеру карты.
Как установить Samsung Pay
Если у вас телефон от Samsung, то данное приложение должно быть у вас предустановлено. Если же его нет, то вы можете установить его из магазина приложений Google Play. Для этого просто зайдите в Google Play, воспользуйтесь поиском и установите Samsung Pay.
После установки приложение Samsung Pay нужно будет настроить, добавив в него платежные карты. После чего Samsung Pay будет готов для оплаты покупок.
Add Samsung pay SDK to your project
Be sure to do the following before attempting to use the SDK:
If not already part of your environment, download and install an IDE. Android Studio is recommended.
Download the Samsung Pay SDK
Configure your IDE to integrate the Samsung Pay SDK with your partner app.
a) Add samsungpay.jar to the libs folder of your Android project.
b) Go to Gradle Scripts > build.gradle and enter the following dependency:
c) Import the SDK package into your code
ProGuard rules
If your app(s) have any issue with ProGuard, the following rules are recommended:
When DexGuard is employed, the following additional rules apply:
Android R OS(rargetSdkVersion 30)
From Android R OS (if the target SDK version is 30), you must include the following element in the Androidmanifest.
Service registration
To develop a Samsung Pay SDK service, merchants and issuers need to register for an account with Samsung Pay Developers in order to create the appropriate service type for their applications. Here are some helpful links inside the portal:
Безопасно
Данные ваших карт не хранятся ни на мобильном устройстве, ни на серверах Samsung. При добавлении карты создается уникальный цифровой код – токен – 16-значная комбинация цифр, привязанная к конкретному устройству. Именно токен используется для платежа вместо реальных данных банковской карты, а оплату можно совершить только после успешной авторизации по отпечатку пальца, радужке глаз или PIN-коду приложения.
На портале выберите страну Russian Federation (внизу страницы) и пройдите регистрацию.
This guide is intended for merchant/issuer app developers familiar with the Android programming environment and APK ecosystem. In accordance with the applicable Samsung partner agreements, it covers the setup and use of the Samsung Pay SDK for purposes of integrating the Samsung Pay app with partner apps developed by both merchants and payment card issuers for Samsung devices and is intended for no other purpose. The use cases and corresponding code samples included are representative examples only and should not be construed as either recommended or required. For APIs and sample code reference, the latest Javadoc of the Samsung Pay SDK is recommended.
Please be aware that, due to regulatory restrictions in different countries, certain Samsung Pay APK behavior designed for one country may not be identical to one for another country. Always use the Samsung and Samsung Pay documentation applicable to the market you are working in and test your integrated project in accordance with the guidance provided for that market/country.
System requirements
The Samsung Pay SDK is designed exclusively for Samsung mobile devices supporting Samsung Pay and running Android Lollipop 5.1 (Android API level 22) or later versions of the Android OS. The SDK’s In-App Payments functionality requires Android 6.0 (M) (Android API level 23) or later versions of the Android OS.
Note : As of SDK version 1.5, if the device runs Android Lollipop 5.1 (Android API level 22) or an earlier version, the getSamsungPayStatus() API method returns a SPAY_NOT SUPPORTED status code. Merchant apps still using Samsung Pay SDK 1.4 or earlier (not recommended) must check the Android version running their app.
Use the following snippet to determine the OS version running on a device and whether or not to display the Samsung Pay button in your partner app.
Samsung Pay: что это за программа
Samsung Pay — это сервис мобильных бесконтактных платежей, разработанный компанией Samsung Electronics и применяемый на телефонах этого производителя. Сервис позволяет пользователям оплачивать покупки при помощи мобильных телефонов и умных часов.
Одним из главных отличий Samsung Pay от конкурентов является то, что он поддерживает не только платежи через NFC, но и платежи с использованием технологии электромагнитной передачи (MST). Это позволяет выполнять оплату даже на старых терминах, которые поддерживают только карты с магнитной лентой.
Технология «Магнитной защищённой передачи данных» или «Magnetic Secure Transmission» (MST) производит передачу информации о платежной карте прямо в отверстие для проведения пластиковой карты. Это обманывает терминал и заставляет его думать, что была проведена реальная карта.
Для обеспечения работы сервиса Samsung Pay используется приложение с таким же названием.
Какие карты поддерживает Samsung Pay
Для того чтобы сервис бесконтактной оплаты Samsung Pay работал он должен поддерживаться не только телефоном, но и банком пользователя. На данный момент к сервису можно подключить следующие платежные карты:
- «Альфа-Банк» (MasterCard и Visa);
- «Тинькофф Банк» (MasterCard и Visa);
- «ВТБ24» (MasterCard и Visa);
- «Рокетбанк» и «Точка» (MasterCard);
- «Яндекс» (MasterCard);
- «Райффайзенбанк» (MasterCard и Visa);
- «МТС-Банк» (MasterCard и Visa);
- «Сбербанк» (MasterCard и Visa, кроме серии Electron);
- «Банк Санкт-Петербург» (MasterCard);
- «Русский Стандарт» (MasterCard);
- «Открытие» (MasterCard и Visa);
- «БИНБАНК» (карты «МДМ Банк»)
В дальнейшем список банков и карт будет расширяться. Обратитесь в поддержку вашего банка, для того чтобы получить подробную информацию о поддержке данного сервиса.
Samsung Pay SDK architecture
The following diagram shows a high-level architecture revealing the general interactions between the Samsung Pay SDK and a partner app.
Partner app - merchant- or issuer-developed app for making online/offline payments and provisioning payment cards through Samsung Pay.
Samsung Pay SDK - SDK integrated into the partner app for direct communication with Samsung Pay
Samsung Pay app - Pay app that the Samsung Pay SDK communicates with.
Financial network - comprises the payment gateways, acquirers, card associations, and issuers that participate in transaction processing under agreement with the merchant.
The main classes comprising the Samsung Pay SDK include:
- SamsungPay – used by the partner app to get the Samsung Pay SDK information and the status of Pay app on the device
- PaymentManager – provides payment/transaction functionality
- CardManager – manages card list (get, add, update) functionality -
- WatchManager – manages all functions related to Samsung Pay Watch. -
- CardInfoListener – interface for requestCardInfo result from Samsung Pay.
- CustomSheetTransactionInfoListener – interface for transaction success/failure callbacks from Samsung Pay.
Читайте также: