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";
}
}
?>