Paynow (mBank) - Payment Gateway for WHMCS

Professional, secure, and lightweight integration of the modern Polish payment gateway Paynow (mBank) with WHMCS.

This module was built from scratch based on the latest REST API (V3) provided by mBank. We focused on shortening your customer's purchasing path to the absolute minimum, boosting conversion rates in your store, and making invoice payments seamless.

Key Features & Innovations:

• Payment Tiles (Quick Select): The module dynamically fetches active payment methods from the bank. The client clicks the BLIK logo, card icon, Google Pay, or Apple Pay directly on the WHMCS invoice and immediately proceeds to the authorization of that specific payment with a single click.
• QuickPay (Payment from E-mail): An innovative feature allowing invoice payments straight from the email inbox. The module generates unique, secure links with encrypted hashes, allowing the client to pay without needing to remember their password or log into the WHMCS client area!
• Dynamic Gateway Fees: Automate the passing of gateway transaction costs (0.95%) onto the buyer. The fee is elegantly calculated along with VAT and added to the invoice upon selecting the Paynow method.
• Full Refunds Support: Manage your finances directly from WHMCS. The built-in API allows you to generate full or partial refunds directly within the transaction details in WHMCS, without ever logging into the mBank panel.
• Lagom 2 & Modern UI Support: A 100% responsive and minimalist interface that blends perfectly with modern WHMCS templates (including dedicated support for Lagom 2).

Technology & Security

Every request sent to mBank is doubly verified. The module uses HMAC SHA-256 authentication signatures and smart Idempotency Keys, entirely eliminating the risk of double-charging the same payment, even during network issues. Webhooks from the bank are strictly verified for signature validity.

• Important: The Paynow gateway requires an active corporate account in mBank. Thanks to this, funds from paid invoices are credited to your account instantly (24/7), without waiting for standard banking sessions.

The module also includes a built-in Sandbox mode, allowing you to safely test the entire purchasing process using test data before going live.

Paynow (mBank) - Bramka Płatności dla WHMCS

Profesjonalna, bezpieczna i lekka integracja nowoczesnej bramki płatności Paynow od mBanku z systemem WHMCS.

Moduł został napisany od zera w oparciu o najnowsze REST API (V3) udostępniane przez mBank. Skupiliśmy się na maksymalnym skróceniu ścieżki zakupowej Twojego klienta, podnosząc konwersję w sklepie i ułatwiając opłacanie faktur.

Główne Funkcje i Nowości:

• Kafelki Płatności (Szybki Wybór): Moduł dynamicznie pobiera aktywne metody z banku. Klient klika w logo BLIK, ikonę karty, Google Pay lub Apple Pay bezpośrednio na fakturze w WHMCS i od razu, z jednym kliknięciem, przechodzi do autoryzacji konkretnej płatności.
• Płatność z e-maila (QuickPay): Innowacyjna funkcja pozwalająca na opłacanie faktur prosto ze skrzynki pocztowej. Moduł generuje unikalne, bezpieczne linki z szyfrowanym hashem, dzięki którym klient płaci bez konieczności przypominania sobie hasła i logowania do panelu WHMCS!
• Dynamiczne Doliczanie Prowizji (Gateway Fees): Możliwość zautomatyzowanego przerzucania kosztów obsługi bramki (0.95%) na kupującego. Prowizja zostaje elegancko przeliczona wraz z podatkiem VAT i dodana do faktury po wybraniu metody Paynow.
• Pełna Obsługa Zwrotów (Refunds): Zarządzaj swoimi finansami prosto z WHMCS. Wbudowane API pozwala na generowanie pełnych i częściowych zwrotów bezpośrednio w szczegółach transakcji w WHMCS, bez konieczności logowania się do panelu mBanku.
• Pełne wsparcie dla Lagom 2 & Modern UI: W 100% responsywny i minimalistyczny interfejs, który idealnie wtapia się w nowoczesne szablony WHMCS (w tym dedykowane wsparcie dla Lagom 2).

Technologia i Bezpieczeństwo

Każde zapytanie kierowane do mBanku jest podwójnie weryfikowane. Moduł korzysta z sygnatur uwierzytelniających HMAC SHA-256 oraz inteligentnych kluczy idempotencji (Idempotency Key), co całkowicie eliminuje ryzyko podwójnego zaksięgowania tej samej wpłaty, nawet w przypadku problemów z siecią. Webhooki z banku są rygorystycznie weryfikowane pod kątem zgodności podpisu.

• Ważne: Bramka Paynow do działania wymaga aktywnego rachunku firmowego w mBanku. Dzięki temu środki z opłaconych faktur księgują się na Twoim koncie natychmiast (24/7), bez oczekiwania na sesje ELIXIR.

Moduł posiada również wbudowany tryb Sandbox, który pozwala bezpiecznie przetestować cały proces zakupowy za pomocą testowych danych przed ostatecznym uruchomieniem płatności na żywo.