Przejdź do treści

Directbilling

Wprowadzenie

Płatności mobilne to najpopularniejsza forma mikropłatności znana już od dekad. Do niewątpliwych zalet tego rozwiązania należą m.in.:

  • szybkość płatności (całość płatności zamyka się w przedziale kilku minut),
  • prosta formuła,
  • szerokie możliwości integracji.

Direct Billing to nowoczesny system płatności mobilnych, który w Polsce jest dopiero wschodzącą alternatywą dla płatności SMS Premium Rate, natomiast już niebawem stanie się bezpośrednim konkurentem płatności kartami kredytowymi. Jest on bowiem, równie prosty jak SMS Premium Rate, ale zdecydowanie bardziej atrakcyjny dla podmiotów świadczących usługi. Do zalet Direct Billingu należą:

  • szybkość płatności,
  • wygoda,
  • możliwość ustalenia obciążenia w przedziale 1 – 250 PLN,
  • szybka autoryzacja płatności,
  • wyższe niż w przypadku SMS Premium prowizje dla podmiotów, które oferują swoje usługi.

Schemat przebiegu płatności w modelu Direct Billing

graph LR
  A[Podawanie numeru telefonu] --> B[Odebranie kodu autoryzacyjnego] --> C[Podanie kodu w formularzu]  

Wykorzystując Direct Billing na swojej stronie istnieje konieczność przekierowania klienta na stronę HotPay celem wywołania formularza płatności. Przekierowanie następuje ze strony sprzedaży, gdzie należy przekazać odpowiednie parametry (metodą POST) w celu wyświetlenia odpowiedniego formularza płatności.

Weryfikacja płatności

Weryfikacja płatności następuje poprzez wysłanie przez nas żądania do odpowiedniego operatora. System operatora sprawdza każdorazowo numer, który próbuje dokonać płatności, oznacza jego historię (minimalizowanie ryzyka powstawania nieściągalnych należności) i stwierdza możność zawarcia transakcji. Wszystko co musi zrobić podmiot, który chce przyjmować płatności w Direct Billing to umieścić przycisk na stronie zakupu.

Rejestracja konta w HotPay

W celu zgłoszenia serwisu lub sklepu, w ramach którego przyjmowane będą płatności, konieczne jest posiadanie konta w systemie HotPay.pl. W celu założenia konta należy kolejno:

  • Otworzyć podstronę: https://hotpay.pl/rejestracja/.
  • Wypełnić dane rejestracyjne, tj.: adres e-mail, hasło, typ konta (prywatne, firmowe, charytatywne).
  • Uzupełnić dane osobowe i adresowe (poprawność danych będzie weryfikowana w późniejszym etapie).
  • Aktywować konto przelewem w wysokości 10 PLN, dokonanym z konta bankowego zarejestrowanego na dane podane w formularzu rejestracyjnym. Aktywacja konta trwa około 24 godzin ze względu na godziny graniczne księgowania przelewów w różnych bankach.

Rejestracja serwisu

Serwis jest miejscem, w którym wykorzystywany będzie system PBL. Przed uzyskaniem dostępu do systemu każdy serwis musi zostać zaakceptowany przez HotPay. Zgłoszenie serwisu odbywa się przy uczestnictwie prostego formularza zlokalizowanego na tej podstronie: https://hotpay.pl/directbilling_nowy/. Pola, które należy wypełnić to:

  • Nazwa serwisu – wewnętrzna nazwa używana w identyfikacji serwisu w HotPay oraz komunikowana klientowi podczas dokonywania płatności;
  • Krótki opis – zwięzły opis usługi na potrzeby weryfikacji serwisu;
  • Szczegółowe wyjaśnienia - dokładny opis serwisu, przebieg płatności, co uzyskuje Klient po dokonaniu płatności itd.;
  • Lokalizacja usługi – adres URL, w ramach którego funkcjonować będzie usługa DCB;
  • Regulamin usługi – link do regulaminu sklepu przeznaczony dla konsumentów korzystających z usług sprzedawcy;
  • Obsługa reklamacji – email – adres poczty elektronicznej, gdzie klienci mogą się kontaktować z podmiotem odpowiedzialnym za świadczoną usługę;
  • Obsługa reklamacji – telefon – numer telefonu, pod którym klienci mogą kontaktować się z podmiotem odpowiedzialnym za świadczoną usługę;
  • Rodzaj serwisu – serwisy dla dorosłych wymagają oznaczenia i sygnalizacji tego faktu operatorom;
  • Wartość pojedynczych transakcji – zakres wysokości transakcji obsługiwanych przez serwis;
  • Opłata cykliczna – rodzaj usługi (w DCB istnieje możliwość ustanowienia subskrypcji, gdzie klient będzie obciążany równych okresach automatycznie);
  • Opis promocji – informacja na temat tego w jaki sposób będzie pozyskiwany ruch w ramach usługi;
  • Główne źródła ruchu – miejsca, z których pochodzi większość ruchu;
  • Przewidywany obrót.

Po wysłaniu tego formularza system HotPay prześle na adres zarejestrowany przy zakładaniu konta email z linkiem potwierdzającym chęć zawarcia umowy na obsługę DCB w serwisie. Po potwierdzeniu woli zawarcia umowy – serwis trafi do akceptacji po stronie HotPay.

Każde zgłoszenie DCB przekazywane jest operatorom, dlatego niekiedy czas oczekiwania na zatwierdzenie usługi wynosi nawet ponad dwa tygodnie od momentu zgłoszenia.

Lista wszystkich usług oraz ich statusy znajdują się na poniżej zalinkowanej podstronie: https://hotpay.pl/directbilling_uslugi/.

Formularz płatności

Transakcje przy wykorzystaniu Direct Billingu obsługuje formularz płatności. Jego forma jest określona w dokumentacji pomiędzy HotPay, a operatorem, dlatego jest on kontrolowany w całości przez HotPay.

Personalizacja formularza płatności

W ramach dostępnych opcji, firma, która dzierżawi usługę od HotPay może częściowo spersonalizować swój formularz. Zmianie podlegają:

  • logo firmy w lewym górnym rogu;
  • tło, na którym pokazywany jest formularz.

Zmian można dokonać na karcie Ustawienia w panelu HotPay, dla każdej usługi z osobna.

API

sequenceDiagram
  autonumber
  Klient->>Sprzedawca: Zamówienie
  Sprzedawca->>HotPay: Jawna inicjalizacja płatności
  loop Procesowanie płatności
      HotPay->>HotPay: Klient przeprowadza płatność
  end
  HotPay-->>Sprzedawca: Wysłanie notyfikacji
  Note over Sprzedawca: Weryfikacja płatności
  HotPay->>Sprzedawca: Powrót klienta do sklepu

Inicjalizacja płatności

Płatność w systemie Direct Billing charakteryzuje się tym, że w transakcji uczestniczyć musi formularz zaakceptowany przez operatorów. Nie ma tutaj swobody znanej z modelu SMS Premium. W HotPay każda transakcja będzie obsługiwana za pośrednictwem formularza pod adresem:

Przekierowanie do panelu transakcyjnego

Adres URL: https://directbilling.hotpay.pl/
Content-Type: multipart/form-data
Dostępne metody: POST/GET

Na ten adres przesyłane będą parametry ze strony, na której wykorzystywany jest system Direct Billing – komunikacja POST.

Opis użycia

Zmienna Wymagane Opis zmiennej
SEKRET TAK Kod sekret do pobrania z panelu HotPay generowany dla każdego serwisu.
KWOTA TAK Kwota ustalona na etapie rejestracji usługi.
PRZEKIEROWANIE_SUKCESS TAK Link, do którego system ma przekierować klienta w razie powodzenia płatności.
PRZEKIEROWANIE_BLAD TAK Link, do którego system ma przekierować klienta w razie niepowodzenia płatności.
ID_ZAMOWIENIA TAK Identyfikator zamówienia po stronie serwisu – nadawany przez właściciela serwisu. Ciąg znaków przesyłany w tej zmiennej nie może być dłuższy niż 64 znaki.
<form name="order" method="post" action="https://directbilling.hotpay.pl/">
    <input name="SEKRET" value="XXX" type="hidden">
    <input name="KWOTA" value="1" type="hidden">
    <input name="PRZEKIEROWANIE_SUKCESS" value="XXX"
    type="hidden">
    <input name="PRZEKIEROWANIE_BLAD" value="XXX" type="hidden">
    <input name="ID_ZAMOWIENIA" value="XXX" type="hidden">
    <button type="submit">Przykładowa płatność</button>
</form>

Odbiór notyfikacji

Notyfikacje są wysyłane metodą POST typu form-data na adres WWW podany w ustawieniach usługi.

Uwaga

Pamiętaj o weryfikacji danych przychodzących.

Uwaga

Notyfikacje są wysyłane z góry ustalonych adresów IP, prosimy dodać je do whitelisty:

  • 18.197.55.26
  • 3.126.108.86
  • 3.64.128.101
  • 18.184.99.42
  • 3.72.152.155
  • 35.159.7.168

Opis użycia

Zmienna Opis zmiennej
KWOTA Kwota, która będzie podstawą rozliczenia.
ID_PLATNOSCI Identyfikator danej płatności zdefiniowany przez HotPay.
ID_ZAMOWIENIA Identyfikator przesłany przez sprzedającego podczas generowania formularza.
STATUS 1 – płatność zaakceptowana.
2 – płatność odrzucona.
3 – przekroczono limit czasu połączenia (timeout).
4 – płatność anulowana.
5 – rejestracja w usłudze subkskrypcyjnej.
6 – zakończenie usługi subskrypcyjnej.
SEKRET Kod identyfikujący usługę (do pobrania z panelu HotPay).
SUBSKRYPCJA_RODZIC ID początkowej akcji – zapisu do subskrypcji.
if (!empty($_POST["KWOTA"]) &&
    !empty($_POST["ID_PLATNOSCI"]) &&
    !empty($_POST["ID_ZAMOWIENIA"]) &&
    !empty($_POST["STATUS"]) &&
    !empty($_POST["SEKRET"])){
        if($_POST["STATUS"]==1){
        //zaplacone
        }else{
        //odrzucone
        }
    }