Ситуация:

В 2022 году, после введения санкций и ограничений на оплату, сеть салонов ювелирных украшений столкнулась с необходимостью адаптации к новым условиям. Основной проблемой стало ограничение традиционных способов оплаты, что затрудняло совершение покупок клиентами.

Цель:

Обеспечить возможность бесконтактной оплаты для клиентов, сохранив при этом удобство и прозрачность транзакций.

Решение:

Было принято решение внедрить оплату по QR-коду через Тинькофф Банк. В рамках проекта были выполнены следующие задачи:

1. Интеграция с кассовым аппаратом:

Для генерации QR-кода использовался REST API Тинькофф Банка. Был реализован вызов метода POST /v2/charges из API Tinkoff Acquiring, который позволяет создать чек и получить ссылку на QR-код.
Полученная ссылка затем передавалась в систему печати кассового аппарата (например, через USB или сетевой принтер), где выводился QR-код на бумажный чек.

2. Вывод QR-кода на экран:

Дополнительно была внедрена возможность отображения QR-кода на экране кассы. Для этого использовалась библиотека генерации QR-кодов (например, qrcode в Python), которая принимала ссылку из ответа API и отображала изображение на экране кассы.
Это позволяло клиенту сразу сканировать QR-код и произвести оплату через мобильное приложение банка или сторонние приложения, поддерживающие QR-оплату.

3. Проверка поступления оплаты:

Для отслеживания статуса транзакции использовался метод GET /v2/charges/{chargeId} из API.
После генерации QR-кода система запускала цикл проверки статуса платежа, чтобы определить, была ли произведена оплата.
Также была реализована обработка вебхуков (webhooks) из API Тинькофф Банка, которые позволяли получать уведомления о статусе транзакции в режиме реального времени.
Это обеспечило прозрачность и оперативность обработки транзакций.

4. Возврат и частичный возврат средств:

Для реализации возвратов использовался метод POST /v2/refunds из API.
Был разработан модуль, который позволял сотрудникам вводить сумму возврата и идентификатор транзакции.
Система отправляла запрос на возврат средств, и статус возврата отслеживался аналогично оплате.
Также была реализована возможность частичного возврата, что позволило гибко управлять возвратами и повысило уровень сервиса.

Технологии и инструменты:

• Язык программирования: Python
• Библиотеки: requests для работы с API, qrcode для генерации QR-кодов
• Интеграция с кассовым ПО (например, 1С, Cashbox, и т.д.)
• Использование вебхуков для получения уведомлений о статусе транзакции
• REST API Tinkoff Acquiring: https://www.tinkoff.ru/api/cashin/

Результат:

Внедрение QR-оплаты позволило сети салонов ювелирных украшений адаптироваться к новым условиям, сохранив лояльность клиентов и обеспечив бесперебойную работу.
Клиенты получили удобный и современный способ оплаты, а сотрудники — инструменты для эффективной обработки транзакций и возвратов.
Техническая реализация обеспечила высокую надёжность и безопасность транзакций, а также возможность масштабирования на другие точки продаж.