mPayWall
Powrót do dokumentacji

Integracja płatności

mPayWall obsługuje automatyczne płatności online przez HotPay i iMoje (BLIK, karty, przelewy) na obu planach. Plan Bezpłatny ma limity ilościowe, plan Pro działa bez ograniczeń.

Dostępne metody płatności

Płatności ręczne (opcja dodatkowa)

Opcjonalny tryb, w którym klient wybiera przelew bankowy, a administrator ręcznie oznacza transakcję jako opłaconą. Dostępny jako alternatywa dla płatności online na obu planach.

  1. 1.Klient wypełnia formularz checkout i wybiera "Przelew bankowy"
  2. 2.Transakcja pojawia się w panelu ze statusem "Oczekuje"
  3. 3.Po otrzymaniu przelewu administrator kliknie "Oznacz jako opłacone"
  4. 4.Subskrypcja zostaje automatycznie aktywowana

HotPay (Bezpłatny i Pro)

Oba plany

BLIK, karty kredytowe/debetowe, przelewy bankowe — wszystkie popularne metody płatności w Polsce. Pieniądze na koncie w 24h. Dostępne na obu planach.

iMoje (Bezpłatny i Pro)

Oba plany

Bramka płatności ING Bank Śląski — BLIK, karty Visa/Mastercard, przelewy online. Obsługa płatności cyklicznych (subskrypcje). Dostępne na obu planach.

Konfiguracja HotPay

  1. 1.
    Utwórz konto HotPay na hotpay.pl, jeśli jeszcze go nie masz.
  2. 2.
    Pobierz dane API z panelu HotPay: sekret i hasło do notyfikacji (Ustawienia → API).
  3. 3.
    Wprowadź dane w mPayWall Przejdź do mPayWall → Ustawienia → Płatności i wpisz sekret oraz hasło HotPay.
  4. 4.
    Skonfiguruj URL callback W panelu HotPay ustaw URL powiadomień na: https://twoja-domena.pl/wp-json/mpaywall/v1/gateway/hotpay/callback
  5. 5.
    Włącz tryb testowy Na początku włącz tryb testowy w ustawieniach mPayWall, aby sprawdzić poprawność integracji.

Konfiguracja iMoje

  1. 1.
    Załóż konto iMoje Skontaktuj się z iMoje lub użyj formularza rejestracyjnego w ustawieniach wtyczki.
  2. 2.
    Pobierz dane API z panelu iMoje: Merchant ID, Service ID, Service Key i Bearer Token.
  3. 3.
    Wprowadź dane w mPayWall Przejdź do mPayWall → Ustawienia → Płatności → iMoje, wybierz tryb (sandbox/produkcja) i wpisz dane dostępowe.
  4. 4.
    Skonfiguruj URL callback W panelu iMoje ustaw URL powiadomień na: https://twoja-domena.pl/wp-json/mpaywall/v1/gateway/imoje/callback
  5. 5.
    Przetestuj w trybie sandbox Wybierz tryb Sandbox w ustawieniach iMoje, aby przetestować integrację przed uruchomieniem produkcyjnym.

Automatyczne faktury — Fakturownia

Każda opłacona transakcja może automatycznie generować fakturę VAT przez Fakturownia.pl. Plan Bezpłatny pozwala na do 50 faktur miesięcznie, plan Pro — bez limitu.

  1. 1.Utwórz konto na fakturownia.pl
  2. 2.Pobierz token API z ustawień konta Fakturownia
  3. 3.Wpisz subdomenę i token API w mPayWall → Ustawienia → Fakturownia
  4. 4.Kliknij "Testuj połączenie" aby zweryfikować dane

Testowanie płatności

Przed uruchomieniem na produkcji przetestuj integrację płatności:

  • HotPay — tryb testowy: Włącz tryb testowy w ustawieniach HotPay w mPayWall. Transakcje testowe nie generują rzeczywistych obciążeń.

Ważne: Pamiętaj, aby przed uruchomieniem paywall dla prawdziwych użytkowników wyłączyć tryb testowy.