Альфа-Эквайринг PRO: расширенный протокол интеграции

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

После получения ключей необходимо настроить ваш сервер для подписи запросов. Алгоритм подписи обычно базируется на стандарте RSA или ECDSA. В документации к API приведены примеры кода на популярных языках программирования, что значительно упрощает процесс внедрения для разработчиков.

// Пример формирования подписи запроса (псевдокод)
signature = sign(private_key, order_id + amount + timestamp)
headers = {
"X-Signature": signature,
"X-Timestamp": timestamp,
"Content-Type": "application/json"
}

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

Сценарии фискализации и работа с онлайн-кассами

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

Если же вы используете собственную кассу, расширенный протокол позволяет передавать команду на пробитие чека сразу после успешной авторизации карты. Это обеспечивает синхронизацию состояния заказа в базе данных магазина и фискального документа. Задержки в передаче данных минимизированы благодаря оптимизированным каналам связи.

При выборе гибридного режима часть операций может проводиться через облачную кассву банка, а часть — через собственную инфраструктуру. Это полезно для крупных сетей, где центральные платежи идут через головной офис, а розничные точки работают автономно. Настройка таких сценариев требует индивидуального подхода и согласования с техническими специалистами.

Обработка возвратов и коррекция чеков

Работа с возвратами в расширенном протоколе реализована максимально детально. Вы можете инициировать возврат как всей суммы транзакции, так и ее части. Более того, система позволяет возвращать деньги за конкретные товары из чека, что автоматически пересчитывает налоговую базу и формирует корректный чек возврата.

Процесс возврата может быть инициирован как автоматически (например, при отмене заказа пользователем в течение определенного времени), так и вручную оператором через административную панель. Важно соблюдать последовательность операций: сначала формируется чек возврата, затем отправляется запрос на реверсацию средств на карту клиента.

⚠️ Внимание: Срок возврата денежных средств на карту клиента зависит от банка-эмитента и может составлять до 30 дней, хотя технически транзакция обрабатывается процессингом в течение нескольких секунд. Всегда предупреждайте клиентов об этом нюансе.

В случае ошибок при фискализации (например, сбой связи с ОФД) протокол предусматривает механизм повторной отправки чека. Система сохраняет статус документа и пытается отправить его повторно при первой возможности. Это гарантирует, что в базе налоговой не возникнет разрывов в нумерации чеков.

• 🔙 Полная или частичная реверсация платежа
• 🛒 Возврат по конкретным SKU (артикулам) товаров
• 📄 Автоматическая генерация чека коррекции при ошибках
• ⏳ Отложенный возврат средств (холдирование)

Безопасность транзакций и 3-D Secure

Безопасность платежей в Альфа-Эквайринг PRO обеспечивается многоступенчатой системой проверок. Обязательным стандартом является протокол 3-D Secure 2.0, который проводит аутентификацию держателя карты без необходимости ввода SMS-кода в большинстве случаев, используя биометрию или банковское приложение. Это повышает конверсию и улучшает пользовательский опыт.

⚠️ Внимание: Хранение полных данных карт (PAN, CVV) на сервере мерчанта строго запрещено стандартами PCI DSS. Нарушение этих правил ведет к блокировке договора эквайринга и штрафам.