Неравный бой — Tinkoff эквайринг. Рекуррентные платежи
В рамках разработки нашего SaaS решения для автоматизации процессов кар-шерингов и авто-ренталов CarSense, перед нами стояла задача реализации системы рекуррентных платежей (Добавление карт пользователями для дальнейшего безакцептного списания).
Изначально мы использовали YooMoney, но крайне высокая комиссия не позволяла нам остаться на нем, в связи с чем было принято решение перейти на иной сервис эквайринга. Мы выбрали Tinkoff эквайринг. Данное решение стоило нам нескольких недель интеграции. В то время как в случае с ЮКассой интеграция заняла пару дней.
Пролог
С самого начала стало понятно, что будет это непросто, так как документация совершенно не помогает в интеграции, а, зачастую, вообще не описывает что и как должно работать. В интернете я не нашел ничего хотя бы отдаленно похожего на завершенное решение.
Интегрироваться с этим самостоятельно человеку в здравом уме не представляется возможным.
Но мы не такие, поэтому нам нужно было сделать свой клиент для организации приема платежей. Единственным источником правды был репозиторий реализации клиента на Flutter (ссылка) (что абсолютно небезопасно учитывая что все ключи хранятся прямо в нем). Выяснив, что сделать с этой документацией ничего нельзя, я начал реверсить то, что они написали в этом репозитории и адаптировать под клиент на бекенде.
В предыдущих реализациях нашего мобильного приложения мы уже пользовались этим клиентом, но отказались в силу того что НЕЛЬЗЯ ХРАНИТЬ СЕКРЕТНЫЕ КЛЮЧИ НА КЛИЕНТЕ! Следовательно, делаем вывод что как-то оно работает.
Сам процесс разбора кода мы описывать не будем, кому интересно, могут сами пройти по ссылке и попробовать разобраться.
Клиент мы реализовывали на TypeScript и Nodejs. Потому и примеры реализации будут на нем.
Сам Тиньков предоставляет нам схему (ссылка) по которой оно как бы работает.
Говоря о рекуррентных платежах мы видим следующую картину:
Что происходит между этими двумя вызовами никто описать не удосужился. Помимо прочего существует метод AddCard который присутствует в Flutter клиенте, и отсутствует в документации. Однако RemoveCard в документации есть. Есть ответы на которые нету вопросов, дальше это станет ясно.
Реализовать все с использованием этого метода наверное можно, но в силу того, что из документации его судя по всему удалили, пользоваться им мы не будем.
Опишем наш базовый клиент
signRequestPayload необходим для того, чтобы подписывать наши запросы. Здесь описана рабочая реализация того как это должно быть.
Init — Первичное создание платежа
Данный метод нужен для того чтобы инициализировать платеж, но сам платеж при этом не создается.
Теперь используем данные нашей карты. Их нужно зашифровать следующим образом
Для того, чтобы платеж создать нужно использовать метод FinishAuthorize.
Создаем из полученных данных acsUrl на который направим клиента
Добавлю вам пример на EJS того, что должно быть на этой странице, потому что Тиньков этого сделать не придумал
В колбек мы указали свой сервер, где перехватим ответ от 3DS, следующим образом
В документации вы об этом ничего не найдете. Там просто отсутствует информация о том, что делать после FinishAuthorize.
Делаем это с картой Visa / MS, вроде бы работает да? Теперь пробуем добавить карту Мир. Не работает вообще ничего.
Это, и множество других, неинформативных, бессмысленных сообщений мы получим дальше.
Работа с картами МИР и иными картами поддерживающими 3DS V2
Казалось бы что на сегодняшний день, когда образовалось огромное количество сложностей для работ зарубежных платежных систем Тиньков в первую очередь должен обеспечить работу карт Мир. Однако никто даже не парился о том, чтобы в документации доступно объяснить процесс интеграции. Об это там написано 1.5 слова, что нужно вызвать метод Check3DSVersion. На этом все заканчивается.
Мы потратили непростительное количество времени, чтобы это преодолеть. Но я очень сомневаюсь, что кто-то помимо нас готов бы был на это. Поддержка совершенно не помогает, они не обладают информацией о том, как работает сервис.
Зачастую они либо просто пропадают и игнорируют вопросы, либо предлагают решения не относящиеся к предмету проблемы.
Для того чтобы заставить это творение работать с картами 3DS V2 действительно необходимо вызвать метод проверки версии.
Но помимо этого, нужно поменять сам запрос FinishAuthozire и привести его к следующему виду.
О том что эти данные должны быть в DATA в документации ничего не написано. Без них метод работать не будет.
Интересно, что в Flutter клиенте перед его вызовом есть метод CollectData, который 1 — не нужен, 2 — неправильно написан в самом клиенте, настолько он не нужен (ссылка)
Если он не нужен, то уберите его, а если нужен, то сделайте, чтобы он работал
submit3DS для 3DS V2
Ну и сам ASCUrl V2
В зависимости от версии выбираем тот или иной метод генерации
Очень важный момент. URLSearchParams превращает симовл «%3D» в «%253D».
Это ломает процесс интеграции. Чтобы этого избежать я делаю так .toString().replace(«%253D», «%3D»)
Страница для вызова ACS
Заключение
Я не знаю каков статус продукта Tinkoff Acquiring но Текущее его состояние абсолютно неприемлемо. Выглядит так будто проект заброшен и им никто не пользуется.
На гитхабе есть один жизнеспособный клиент и это https://github.com/MadBrains/Tinkoff-Acquiring-SDK-Flutter/, но нельзя хранить приватные ключи в мобильном клиенте. Любой школьник в состоянии вытащить приватные ключи и откатить все проведенные транзакции. Прошу команду Тиньков обратить внимание на данный пост, сделать выводы и привести сервис в достойное состояние.
Надеюсь данная статья поможет другим командам.
�� Сказать «Спасибо»: USDT TRC20 TPVQGCoPbyDZfcjAxVi1VmdApkVCifoqcm
Как настроить Tinkoff Pay на Андроиде и платить смартфоном в магазинах
После того как в России отключили Google Pay, у многих возник вопрос, как платить смартфоном в магазинах. На выручку тогда пришел Mir Pay. Вот только это дополнительное приложение, которое не всегда срабатывает корректно. На моем Xiaomi Mi 10T Pro приходится постоянно открывать Mir Pay. В противном случае оплата либо не проходит вообще, либо на терминале появляется ошибка из-за долгого запуска программы. Но банки тоже не сидят сложа руки и выпускают свои платежные решения. Относительно недавно свой сервис выпустил Сбер, и вот теперь Тинькофф.
С помощью Тинькофф Пей теперь можно платить не только в интернете
Раньше Tinkoff Pay работал только для онлайн платежей, а в последнем обновлении стал доступен и для оплаты с помощью NFC в магазинах, то есть оффлайн. Рассказываем, как настроить Tinkoff Pay на Андроид-смартфоне и какие ограничения есть у платежного сервиса.
Как обновить приложение Тинькофф
Чтобы перейти к настройке Tinkoff Pay, вам потребуется обновить приложение банка. Сервис доступен в версии 6.18 и более поздних. Узнать, какая версия установлена на вашем смартфоне можно так:
Убедитесь, что у вас установлено приложение версии 6.18 или новее
- Откройте настройки и перейдите в раздел “Приложения”;
- Выберите раздел “Все приложения”;
- Найдите в списке Тинькофф и откройте его;
- Убедитесь, что под названием приложения указана версия 6.18.0 или новее.
Если версия приложения у вас старая, то его необходимо обновить. Тинькофф доступен как в Google Play, так и в RuStore, поэтому можете воспользоваться любым удобным вам способом. Для тех, кто не умеет обновлять приложения, мы подготовили отдельную инструкцию, как это можно сделать. Обратите внимание, что версия 6.18 пока доступна не для всех, так что обновление, возможно, придется подождать.
Как добавить карту в Тинькофф Пей
Как только вы убедились, что у вас установлена нужная версия приложения, можно переходить к добавлению карты в Tinkoff Pay. На этом этапе мы и столкнемся с первым ограничением. Поддерживаются только карты Мир Тинькофф Банка. Поэтому если вы еще ее не выпустили, то самое время это сделать. Недавно мы рассказывали, как сделать виртуальный Мир к уже существующему счету Тинькофф. Если же Мир у вас уже есть, то можно сразу переходить к добавлению карты в Tinkoff Pay:
-
Откройте приложение Тинькофф;
Под каждой картой Мир появилась соответствующая кнопка
Для удобства обязательно добавьте ярлык Тинькофф Пей на рабочий стол
Как только вы проделаете все эти действия, то можете сразу подносить телефон к терминалу. Причем для оплаты покупок до 1000 рублей даже не надо разблокировать смартфон с помощью биометрии или пароля:
Для подтверждения покупки на сумму свыше 1000 руб. нужно разблокировать телефон с помощью кода, отпечатка пальца или по лицу. Для покупок до 1000 руб. достаточно поднести телефон к терминалу с включенным экраном.
Имейте в виду, что Tinkoff Pay станет доступен для всех пользователей в течение двух недель. Поэтому в первые дни кнопки для добавления у вас может не быть. В таком случае придется немного подождать, пока функция доберется и до вас.
Как скрыть баланс карты Тинькофф
При использовании нескольких карт можно выбрать ту, которая будет открываться по умолчанию
Но у меня помимо дебетовой карты, есть еще и кредитная. Ее тоже можно добавить в Тинькофф Пей. Делается это по аналогии с первой картой, с одним лишь отличием. Как только вторая будет добавлена в Tinkoff Pay, приложение спросит, стоит ли делать ее способом оплаты по умолчанию или оставить все как есть. Вам остается только нажать на соответствующую кнопку.
Для удобства пользователей на карте во время оплаты отображается баланс. Поэтому в момент выбора платежного средства вы будете видеть, сколько на ней осталось средств, и при необходимости сможете ее поменять. Если есть желание, то баланс можно скрыть. Делается это следующим образом:
Баланс можно скрыть
- На рабочем столе найдите ярлык Tinkoff Pay и нажмите на него;
- Рядом с балансом нажмите на глаз;
- Заблокируйте смартфон, разблокируйте и снова зайдите в Tinkoff Pay.
❗️ПОДПИСЫВАЙСЯ НА ТЕЛЕГРАМ-КАНАЛ СУНДУК АЛИБАБЫ, ЧТОБЫ ПОКУПАТЬ ТОЛЬКО ЛУЧШИЕ ТОВАРЫ С АЛИЭКСПРЕСС
После этого баланс будет отображаться в виде пяти нулей. Чтобы вновь сделать его видимым, придется проделать те же действия, что и при сокрытии, только потребуется подтверждение биометрией.
Как изменить способ оплаты на Андроиде
Если по какой-то причине Tinkoff Pay вам не понравился, и вы решили вернуться к Mir Pay, то сделайте следующее:
-
Откройте приложение Тинькофф и перейдите в настройки карты Мир, которая была добавлена в Tinkoff Pay;
Удалить карту из Тинькофф Пей тоже легко
Верните Mir Pay в качестве платежного сервиса по умолчанию
Все! Тинькофф Пей больше не является платежным средством по умолчанию на вашем смартфоне, и можете спокойно пользоваться тем способом, к которому привыкли. Я проверил Tinkoff Pay в действии и могу сказать, что оставлю его основным способом оплаты. Отдельно его запускать, в отличие от Mir Pay, не пришлось, и платеж прошел практически мгновенно. Пока впечатление только положительное. Скоро аналогичный сервис заработает и у Альфа Банка. Так что, как только закончится этап тестирования, клиенты Альфы тоже смогут оплачивать покупки оффлайн без Mir Pay.
Новости, статьи и анонсы публикаций
Свободное общение и обсуждение материалов
Камеры смартфонов буквально похоронили сегмент недорогих цифровых фотоаппаратов и сегодня их почти не встретишь в магазине. Причиной тому стали алгоритмы обработки изображения. Во всех отношениях смартфон умнее, а потому во многих сценариях он может делать снимки лучше. Однако законы физики не обмануть, и профессиональные фотографы продолжают использовать специальную технику из-за скромных габаритов камеры телефона. Разберемся, на что влияет эта характеристика и существует ли смартфон с большой камерой, способный сравниться по качеству фотографий с узкоспециализированным устройством.
Sega — известная корпорация из Японии, получившая широкую известность в России за счет своих игровых приставок. У многих из нас, включая меня, масса воспоминаний из детства связана с Sega Mega Drive и другими продуктами компании. А сегодня мы имеем возможность освежить их, запустив игры Sega на Андроид. Разберемся, что для этого нужно и вспомним несколько наиболее запоминающихся проектов эпохи 16-битных консолей.
История мобильного гейминга началась отнюдь не с появления Android или первого Apple iPhone, а намного раньше. Еще в конце 90-х владельцы телефонов Nokia залипали в «Змейку», а с появлением Java-игр в нулевых развитие индустрии получило новый виток. Тогда вышло много классных проектов от Gravity Defied до Gangstar: Crime City, до сих пор остающихся в памяти миллионов людей. Чтобы сыграть в них сейчас, нет необходимости покупать кнопочный телефон, ведь можно скачать Java-игры на Андроид. Сегодня вы узнаете, где их найти и как запустить.
Безопасная сделка от Тинькофф Оплаты: как автоматизировать и обезопасить расчеты для онлайн-площадок и маркетплейсов
У эквайрингового сервиса Тинькофф Оплаты есть сервис по управлению расчетами между клиентами онлайн-площадок и маркетплейсов — безопасная сделка. Она помогает автоматизировать и защитить переводы между физлицами.
В статье рассказываем, как работает безопасная сделка и как ее применяют наши клиенты — Авито и сервис по переводу чаевых CloudTips.
Обычно маркетплейсы, биржи фрилансеров, стриминговые платформы, сервисы клининга и другие онлайн-площадки связывают между собой физлиц, но при этом в сделках не участвуют. Из-за этого у площадок возникают проблемы.
Площадка не может гарантировать честное исполнение сделки. Например, продавец в маркетплейсе продает сломанный товар, а покупатель не может вернуть деньги.
Если площадка не контролирует сделки, она не может на них зарабатывать. Пользователи обмениваются деньгами лично, переводят друг другу на личные карты, а площадка не получает вознаграждение.
Площадка рискует деньгами пользователей и своей репутацией. Бывает, что площадка косвенно участвует в расчетах, деньги пользователей проходят через ее счет. Например, так бывает на биржах фриланса: заказчики зачисляют деньги для оплаты работы фрилансеров, они уходят на счет биржи. Но тут есть риски и для площадки, и для пользователей.
Например, налоговая накладывает арест на счет биржи фриланса. В итоге фрилансеры не могут получить деньги за свою работу. Они пишут негативные отзывы, а площадка теряет пользователей.
Как раз в этих случаях поможет внедрение безопасной сделки. Давайте посмотрим, как это работает.
Безопасная сделка — инструмент, который помогает защитить расчеты между пользователями: покупатель бронирует товар или услугу, а продавец получает деньги, только когда покупатель подтвердил, что с товаром все в порядке.
Представим, что у нас маркетплейс. Вот как это выглядит:
Покупатель бронирует товар или услугу и предоставляет данные своей карты.
Банк замораживает деньги на счете покупателя.
Перевод идет напрямую: с карты покупателя на карту продавца. Расчетный счет площадки в процессе не участвует. Поэтому деньги пользователей защищены: даже если счет площадки арестуют, пользователи все равно получат свои выплаты.
При этом площадка видит информацию о списаниях и контролирует весь процесс в личном кабинете: подтверждает операции, делает частичный или полный возврат денег, выгружает подтверждения оплат или возвратов.
Получается, с безопасной сделкой площадка:
Гарантирует пользователям честность сделок.
Контролирует весь процесс расчетов.
Не рискует своей репутацией, потому что ее счет никак не участвует в расчетах.
Но это еще не все.
Обычно банк может заморозить деньги на карте покупателя от 4 до 6 дней при отложенном заказе. Например, покупатель выбрал товар в маркетплейсе и оплатил его — формально он видит смс об оплате, но деньги замораживаются. Если через 6 дней не будет подтверждения, что он принял товар, то произойдет отмена списания: деньги вернутся на карту покупателю.
Для маркетплейсов это неудобная схема. Если покупатель выбрал доставку Почтой России, то он может прийти за посылкой в течение двух недель. В пунктах выдачи Boxberry товары хранятся до двух месяцев. Получается, через 6 дней придет возврат, хотя товар еще не получен.
Тинькофф Оплата может заморозить деньги на карте покупателя в один день, а выплату продавцу сделать через два месяца. Если через 6 дней покупатель не подтвердил, что получил товар, а площадка не отменила заморозку денег, то деньги переходят на транзитный счет банка и могут лежать там до 60 дней. Это помогает площадке подстраиваться под разные правила хранения у служб доставки.
Площадка может зарабатывать на безопасных сделках: сделать эту опцию отдельной услугой и брать вознаграждение. Площадка как бы говорит пользователям: «Если вы хотите обмениваться товарами без риска, платите вот такую комиссию, я все проконтролирую». Если сделка завершится успешно, то есть покупатель оплатит товар, а продавец получит деньги, то площадка получит вознаграждение.
Площадка сама устанавливает, какое вознаграждение хочет получить с закрытых сделок. Например, покупатель оплачивает товар в 5000 рублей, а в счете видит 5500 рублей вместе с вознаграждением площадки.
Тинькофф берет комиссию при списании денег со счета покупателя и при выплате продавцу. В целом по закрытой сделке комиссия составляет от 3% — с каждым партнером договариваемся отдельно. Эту комиссию площадка зашивает в свое вознаграждение. Когда сделка завершится, Тинькофф возьмет свою комиссию и отправит площадке ее часть вознаграждения.
Например, площадка хочет получать 500 рублей с каждой завершенной сделки, когда покупатель и продавец обменялись товарами и деньгами. Из этих 500 рублей площадка заплатит комиссию банку.
Иногда бывает, что сделка не завершилась. Например, покупатель оплатил товар, но не забрал его из пункта выдачи, и деньги ему вернулись. В этом случае Тинькофф берет комиссию за покупку, а за выплату — нет.
Авито: безопасная сделка увеличила продажи между регионами
«Мы внедрили безопасную сделку от Тинькофф Оплаты в 2018 году. С тех пор увеличились продажи между регионами: почти всю доставку товаров мы проводим с безопасной сделкой.
Раньше продавцу было страшно отправлять товар неизвестному человеку: не было гарантии, что покупатель оплатит. А покупатель был не защищен от некачественного товара.
Теперь схема такая:
1. Покупатель бронирует товар, банк замораживает деньги на его карте.
2. Продавец отправляет товар курьером или через службу доставки.
3. Когда покупатель забирает товар, площадка получает об этом оповещение и подтверждает выплату денег продавцу.
Если товар не доставили или он пришел покупателю испорченным, мы разбираемся в ситуации и можем подтвердить полный или частичный возврат.
Тинькофф Оплата умеет замораживать деньги на любое время. Поэтому нам удобно работать с разными службами доставки: в Boxberry товар может ждать покупателя 21 день, а в Почте России — около 2 месяцев».
Андрей Новокрещенов,
Старший технический специалист Авито
С безопасной сделкой площадка может настроить, как часто делать выплаты физлицам: переводить деньги мгновенно после выполнения условий договора или копить мелкие переводы, а потом за раз выводить крупную сумму.
Такой формат удобен, например, для сервисов по выплате чаевых. Посетители кафе переводят небольшие суммы чаевых, они накапливаются, а потом сервис выплачивает официанту сразу крупную сумму.
Другой пример — выплаты для фрилансеров на биржах фриланса. Выплаты от заказчиков могут накапливаться на счете фрилансера, потом он может их вывести одной суммой.
Площадка сама настраивает, какое вознаграждение с суммы хочет получать и как часто. Например, по закрытым сделкам деньги могут приходить на счет площадки уже на следующий день.
CloudTips: «Принимаем чаевые по картам и без расчетного счета»
«CloudTips — первый банковский сервис для безналичных чаевых от CloudPayments. Благодаря ему клиенты ресторанов могут оставлять безналичные чаевые лично официанту. Мы работаем с Gett, iGooods, FoodBand, ресторанами Ginza Project, 354 Exclusive Height и другими заведениями по всей России.
Расчеты между гостями и официантами происходят при помощи безопасной сделки от Тинькофф Оплаты. Деньги идут напрямую со счета гостя на счет официанта, расчетный счет ресторана не участвует.
Чтобы оставить электронные чаевые, гостям не нужно авторизовываться в сервисе CloudTips и привязывать карту. Деньги будут накапливаться на транзитном счете в Тинькофф до тех пор, пока официант не привяжет свою карту, чтобы получить выплату».
Дмитрий Спиридонов,
Сооснователь и генеральный директор CloudPayments
Тинькофф следит за подозрительной активностью на площадках клиентов и собирает статистику. Банк составляет портрет поведения мошенников и помогает блокировать подозрительные аккаунты на этапе регистрации.
Если банк обнаружит, что перевод совершается на карту мошенника, он сразу же передаст эту информацию площадке. Так она сможет разобраться в ситуации и остановить платеж.
Авито: подозрительные карты можно добавить в черный список
«Обманывают и продавцы, и покупатели. Тинькофф помогает нам обучать пользователей, как защитить себя от мошенников. Например, банк сделал серию роликов про разводы в интернете, в том числе и про мошенничество на Авито.
В личном кабинете мы можем следить за каждой сделкой и вмешиваться, если что-то идет не так. Например, мы можем добавить данные подозрительной карты в черный список, и на них невозможно будет совершить платеж.
Тинькофф поддерживает наши идеи и работает быстро: например, за два дня перекрасили платежную форму в фирменные цвета и поставили на ней логотип Авито. Это тоже защищает от мошенников: форму с логотипами и в фирменных цветах сложнее подделать».
Андрей Новокрещенов,
Старший технический специалист Авито
Для подключения безопасной сделки не нужно открывать расчетный счет в Тинькофф — достаточно подать заявку и провести интеграцию. Подключение занимает неделю: все процессы подробно описаны, а технические специалисты готовы ответить на все вопросы. За проведение сделок Тинькофф Оплата берет фиксированную комиссию от 3%. Чтобы подключить безопасную сделку, оставьте заявку.