Przejdź do treści

SMS PREMIUM MO

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.

Schemat przebiegu płatności w modelu SMS MO

graph LR
  A[Wysyłka SMSa] --> B[Odebranie kodu aktywacyjnego] --> C[Podanie kodu w formularzu]  

Numer, pod który osoba wysyła SMS determinuje jego cenę, natomiast treść SMSa (tzw. Prefix) ustalana jest przez Partnera po zalogowaniu się do systemu HotPay.

Weryfikacja płatności

Płatność zostaje zweryfikowana poprzez zapytanie do naszego serwera, na które odpowiadamy w zależności od tego czy wprowadzony kod aktywacyjny jest wpisany poprawnie czy błędnie. Po pomyślnej weryfikacji Klient końcowy automatycznie uzyskuje dostęp do zastrzeżonego materiału w obrębie serwisu Partnera.

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 1 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/premium_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;
  • Lista stawek – zbiór taryf wykorzystywanych w ramach serwisu;
  • Opis serwisu – opis usługi na potrzeby weryfikacji serwisu;
  • Link do miejsca świadczenia usługi – link do serwisu, gdzie umieszczone będą informacje na temat możliwości płatności za pośrednictwem SMS Premium;
  • Link do regulaminu usługi – link do regulaminu sklepu przeznaczony dla konsumentów korzystających z usług sprzedawcy;
  • Obsługa klienta – email – adres poczty elektronicznej, gdzie klienci mogą się kontaktować z podmiotem odpowiedzialnym za świadczoną usługę;
  • Obsługa klienta – telefon – numer telefonu, pod którym klienci mogą kontaktować się z podmiotem odpowiedzialnym za świadczoną usługę.

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ę SMS Premium w serwisie. Po potwierdzeniu woli zawarcia umowy – serwis trafi do akceptacji po stronie HotPay.

Jeśli serwis zostanie zaakceptowany – odblokuje się możliwość rejestracji prefiksów SMS Premium Rate na karcie Rejestracja usług Premium Rate.

Lista aktualnych serwisów oraz ich statusy znajdują się na poniżej zalinkowanej podstronie: https://hotpay.pl/premium_nowy/ na karcie Lista serwisów.

API

Po uzyskaniu kodu drogą SMSową klient powinien zostać poinformowany o konieczności wpisania go w uprzednio przygotowane pole połączone z usługą weryfikacji kodów dostępną pod poniższym adresem:

Przekierowanie do panelu transakcyjnego

Adres URL: https://apiv2.hotpay.pl/v1/sms/sprawdz
Dostępne metody: GET

Usługa w momencie rozpoznania prawidłowego kodu zwróci komunikat o statusie HTTP 200 w formacie JSON.

Szczegółowe informacje

Uwaga

Informację na temat danego kodu aktywacyjnego uzyskać można poprzez wykonania zapytania GET o strukturze:
https://apiv2.hotpay.pl/v1/sms/sprawdz?sekret=".$sekret."&kod_sms=".$code"

Opis użycia

Zmienna Wymagane Opis zmiennej
sekret TAK Kod identyfikujący usługę (do pobrania zpanelu HotPay).
kod_sms TAK Kod, który sprawdzamy (wielkość liter nie ma znaczenia).

Odpowiedź

Zmienna Opis zmiennej
status W przypadku poprawnego kodu wartość true, w innym przypadku false.
data_wyslania Data, kiedy kod został wysłany.
aktywacja 1 – pierwsza aktywacja kodu
2 – kolejna aktywacja kodu
Zmienna Opis zmiennej
tresc Informacja na temat zaistniałego błędu

Przykładowa implementacja

Przykładowa implementacja

<?php
// Sekret znajdujący się w panelu klienta HotPay.
$sekret="XX";
// Kod otrzymany przez użytkownika poprzez SMS.
$code ="Kod otrzymany przez użytkownika";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://apiv2.hotpay.pl/v1/sms/sprawdz?sekret=".$sekret."&kod_sms=".$code);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$wynik = curl_exec($ch);
curl_close($ch);
$codeInfo = json_decode($wynik);
if($codeInfo->status=="ERROR"){
    echo "Tresc bledu: ".$codeInfo->tresc;
}else if($codeInfo->status=="SUKCESS")
{
    if($codeInfo->aktywacja==1)
    {
        //Pierwsza aktywacja
        echo "Pierwsza aktywacja kodu";
    }else
    {
        //kolejna aktywacja
        echo "Kolejna aktywacja kodu";
    }
}
?>