Беларусбанк предоставляет интернет-эквайринг и платежный шлюз, который можно подключить через API. Для бизнеса это означает: онлайн-оплата банковскими картами, подтверждение через 3‑D Secure, возвраты и сторнирования, а также уведомления о событиях. Если вы строите интернет-магазин, подписочный сервис или маркетплейс, API для работы с платежами в Беларусбанке поможет автоматизировать весь цикл — от создания заказа до сверки поступлений.
Ключевые задачи, которые решает Беларусбанк API платежи:
Для быстрого старта ознакомьтесь с основами интеграции и определите подходящий платежный сценарий.
![Diagram: Belarusbank payment gateway components]
Ниже — типичный поток эквайринга Беларусбанк API. Конкретные шаги и названия методов могут отличаться в зависимости от договора и настроек.
![Diagram: Payment flow via Belarusbank API]
Ниже — обзор распространенных операций, которые встречаются при работе с эквайрингом Беларусбанка.
| Операция | Когда использовать | Параметры/заметки |
|---|---|---|
| Создание платежа (init) | Перед началом оплаты | amount, currency, orderId, description, returnUrl, idempotency-key |
| Проверка статуса (get) | Для получения актуального статуса | paymentId или orderId, подпись/токен |
| Подтверждение списания (capture) | После предварительной авторизации | paymentId, captureAmount (опционально частичный) |
| Отмена авторизации (void) | До списания, если заказ отменен | paymentId, reason |
| Возврат (refund) | После списания — полный/частичный | paymentId, refundAmount, reason |
| Регистрировать карту/токен (card-on-file) | Для подписок/автоплатежей | customerId, consent, tokenizationFlow |
| Повторная отправка вебхука | Если ваш endpoint временно недоступен | eventId/attempt, подпись |
Статусы оплаты в API обычно отражают жизненный цикл транзакции:
| Статус | Значение |
|---|---|
| created/pending | Платеж инициирован, ожидание ввода карты/3DS |
| authorized | Средства успешно заблокированы |
| captured/succeeded | Списание завершено, платеж успешен |
| canceled/voided | Авторизация отменена |
| refunded | Выполнен возврат (полный или частичный) |
| failed | Ошибка проведения операции |
Платежные интеграции требуют повышенной безопасности. В типовой схеме используются:
Ознакомьтесь с практиками 3DS и PCI в разделе PCI DSS и 3‑D Secure. При проектировании API‑вызовов закладывайте идемпотентность и повторяемость, особенно для сетево‑чувствительных операций — подробнее в гайде вебхуки и идемпотентность.
3‑D Secure Беларусбанк — критический слой защиты, который снижает риск мошенничества и чарджбеков. В современном потоке 3DS2 возможны два сценария:
Рекомендации интеграции:
Подробнее — в материале PCI DSS и 3‑D Secure.
Вебхуки Беларусбанк используются для асинхронных уведомлений: успешная оплата, отмена, refund, chargeback, периодические списания. Хорошая практика — принимать вебхуки даже при локальных сбоях и подтверждать обработку 2xx‑ответом.
Что важно предусмотреть:
См. паттерны вебхуков и идемпотентности и практики ошибок и мониторинга.
Для безопасного испытания интеграции используется sandbox Беларусбанк. В песочнице вы:
Помните: набор тестовых карт и ответа кодов может отличаться от продакшена. Не смешивайте real‑keys с тестовыми. Подробности — в разделе Sandbox и тестовые сценарии.
Возврат платежа Беларусбанк возможен как полный, так и частичный. Два смежных действия важно не путать:
Практические советы:
Читайте подробности о стратегиях в разделе возвраты и сторнирования.
Для подписок и регулярных списаний полезны токены карты (card‑on‑file) и разделение CIT/MIT. В эквайринг Беларусбанк API обычно предусмотрен сценарий:
Смотрите паттерны рекуррентных подписок и убедитесь, что информирование клиента соответствует требованиям локального регулирования.
Мобильные приложения повышают конверсию, если использовать нативные платежные формы и SDK. Проверьте, доступен ли у банка SDK/hosted UI для iOS/Android, чтобы не касаться карточных данных на вашем бэкенде и снизить нагрузку PCI DSS. Рекомендации по встраиванию — в разделе SDK для мобильных.
Сверка — ключ к прозрачному учету. Организуйте ежедневный обмен реестрами и автоматическую консолидацию:
Начните с гайда Сверка и аналитика, чтобы построить надежный pipeline отчетности.
Инциденты в платежах дорого обходятся. Введите метрики:
Постройте алерты и дашборды — см. Ошибки и мониторинг. Для устойчивости добавляйте:
Выбирая поставщика, сравните прямой эквайринг банка и агрегаторов. Прямой канал дает контроль и тарифы, агрегаторы — скорость запуска и больше способов оплаты. Материал для оценки — Банки vs агрегаторы.
Сравните также другие интеграции на сайте:
Беларусбанк API для работы с платежами — надежная основа для онлайн‑кассы, подписок и маркетплейсов. Используйте 3‑D Secure Беларусбанк, аккуратно настраивайте вебхуки Беларусбанк и тестируйте все кейсы в sandbox Беларусбанк. Далее:
Готовы внедрять эквайринг Беларусбанк API или хотите сравнить варианты? Перейдите по ссылкам из статьи и соберите оптимальную архитектуру под ваш продукт.