SMS Kod
Dzięki wykorzystaniu usługi SMS KOD osoba posiadająca własną stronę internetową może w szybki i darmowy sposób stworzyć płatną strefę, która będzie udostępniana użytkownikowi serwisu w momencie wpisania przez niego kodu otrzymanego SMS-em. Usługa jest bardzo wygodna:
• dla właściciela serwisu, który nie musi monitorować płatności, wystawiać faktur, aktywować manualnie usługi po wpłynięciu należności od użytkownika oraz może oferować masowym użytkownikom szeroką gamę tanich usług dostępnych niemal natychmiast po dokonaniu płatności,
• dla użytkownika serwisu, który nie musi oczekiwać na weryfikację swojej wpłaty przez serwis i aktywowanie usługi, płacić wysokiej (w porównaniu z wpłaconą kwotą) prowizji za dokonanie wpłaty związanej z dostępem do wybranych treści, tracić czasu na formalności związane z przelewem czy płatnością kartą kredytową.
Automatyczne kody jednorazowe
Działanie systemu SmartPay jest oparte o mechanizm automatycznych kodów jednorazowych SMS KOD. Zapewnia on pełną obsługę wysyłanych końcowemu użytkownikowi kodów. Każdy z przekazywanych kodów jest kodem jednorazowym, co gwarantuje, że każdorazowe wykonanie skryptu na serwerze zostało opłacone za pomocą SMS Premium Rate. Dodatkową zaletą systemu kodów automatycznych SmartPay jest brak konieczności posiadania i utrzymywania bazy kodów. Kody są generowane automatycznie i unieważniane za pomocą odpowiedniego skryptu.
SMS Kod
Uruchamianie serwisówAby przystępnie zobrazować działanie płatności opartej o system kodów jednorazowych SMS KOD przyjmijmy na chwilę, że jesteśmy właścicielem serwisu internetowego SuperTapety.pl i planujemy wzbogacić nasz serwis o płatności SMS oferowane przez SmartPay.
Pierwszym krokiem jest rejestracja w systemie SmartPay, podczas której możemy zgłosić od jednego do pięciu serwisów (wybierając dla nich odpowiednie subprefiksy).
Po wysłaniu wypełniony formularz trafia do administratora systemu SmartPay, który podejmuje decyzję o uruchomieniu bądź odrzuceniu zgłaszanej usługi. W każdym przypadku od administratora systemu otrzymujemy e-mail z informacją o podjętej decyzji.
W przypadku decyzji o aktywacji zgłaszanego serwisu system SmartPay:
• nadaje serwisowi unikalny numer,
• nadaje serwisowi unikalna nazwę zaproponowaną przez nas w zgłoszeniu,
• zatwierdza wybrany identyfikator (subprefix) i przyporządkowuje go do serwisu,
• dodaje do serwisu pełna gamę dostępnych taryf Premium Rate,
• generuje określona liczbę unikalnych ośmioznakowych kodów, które będą przypisane do serwisu,
• tworzy indywidualną dla każdego serwisu przestrzeń kodów jednorazowych (czyli odrębną pulę, w ramach której zapewniona jest unikalność kodów),
Gdy administrator systemu wyśle do nas mail z informacją o aktywowaniu serwisu oznacza to, że po stronie SmartPay jest on gotowy do komercyjnego użytku.
Dodawanie nowych serwisów
Kolejne serwisy mogą być zgłaszane po dokonaniu pełnej aktywacji konta poprzez zakładkę Serwisy znajdująca się w Panelu Klienta. Schemat zgłoszenia nowego serwisu jest bardzo prosty:
• logujemy się do serwisu,
• wybieramy zakładkę Serwisy w Panelu Klienta,
• klikamy w przycisk Dodaj,
• w otwartym polu dialogowym wpisujemy: adres strony www, na jakiej będzie udostępniony serwis, subprefiks usługi (część treści SMSa następująca po głównym prefiksie PS.), wybieramy taryfę/taryfy, dodajemy krótki opis serwisu.
Całość akceptujemy przyciskiem Zapisz. W tym momencie Zgłoszenie Nowego Serwisu jest wysyłane do administratora SmartPay. Jeśli zgłoszenie jest poprawne zostanie ono aktywowane najdalej w przeciągu dwóch dni roboczych.
Taryfy
Każdemu nowemu serwisowi należy przyporządkować taryfę, na której będzie realizowany. Jedna usługa może być realizowana na dowolnej ilości taryf z dziewięciu dostępnych. W przypadku nowo tworzonych serwisów taryfę ustala się w momencie ich zakładania. Zmiany taryfy w przypadku serwisów już funkcjonujących dokonuje się poprzez ich edycję. W obydwu przypadkach czynności te wykonywane są w Panelu Klienta w zakładce Serwisy.
Korzystanie z usług
Proces płatności w systemie SmartPay składa się z następujących etapów:
• użytkownik trafia na stronę Partnera, do której dostęp jest odpłatny,
• korzystając z informacji umieszczonej na stronie Partnera wysyła wiadomość SMS o treści PS.<id> (gdzie id to identyfikator, subprefix, serwisu partnera) na numer odpowiedni to stawki wybranej przez Partnera
• w odpowiedzi na wysłanego SMSa użytkownik otrzymuje unikalny kod jednorazowy, który wpisuje w odpowiednie pole formularza na stronie Partnera
• w czasie weryfikacji formularza Partner weryfikuje poprawność kodu oraz jego wartość poprzez wywołanie odpowiedniego skryptu weryfikującego systemu SmartPay
• w przypadku pozytywnej weryfikacji kodu użytkownik otrzymuje dostęp do płatnej części serwisu Partnera
Integracja płatności
Aby móc weryfikować płatności w systemie SmartPay wystarczy w kodzie obsługującym formularz płatności umieścić wywołanie adresu https://www.smartpay.pl/check metodą HTTP GET z następującymi parametrami
• service - to twój identyfikator usługi (subprefiks)
• password - to hasło do twojego konta użytkownika
• code - kod wpisany przez użytkownika, który otrzymał jako odpowiedź zwrotną na wysłanego SMSa
Jeśli podałeś poprawne wartości parametrów otrzymasz trzy linijki kodu. Pierwsza określa status operacji (jeśli przebiegła poprawnie będzie to OK), druga zawiera kod wynikowy operacji wraz z opisem. Trzecia linijka, wyświetlana tylko w przypadku aktywnego kodu, zawiera wartość netto sprawdzanego kodu. Odczytanie kodu jest równoznaczne z oznaczeniem go jako "Użyty". A gdy chcesz jedynie sprawdzić, czy kod jest, ale nie oznaczać go jako użytego? Nic prostszego. Wystarczy, że dodasz kolejny parametr:
• just_check=true
Możesz także odpytać system SmartPay o kod dla konkretnej taryfy. Wystarczy, że swoje zapytanie rozszerzysz o parametr rate:
• rate - stawka netto za SMS. Wartość ze zbioru: 1,2,3,4,5,6,9,19,25
wtedy SmartPay przeszuka tylko kody wygenerowane dla tej taryfy.
Poniżej prezentujemy przykładowe zapytania (zakładamy, że użytkownik ma serwis o subprefiksie SP i aktywne taryfy 1 i 3, hasło do systemu brzmi "haslo"):
• https://www.smartpay.pl/check?service=SP&password=haslo&code=kod123 - sprawdź, czy dla usługi SP wygenerowano kod "kod123". Jeśli taki kod jest w bazie i jest aktywny w odpowiedzi uzyskasz następujący ciąg znaków:
OK
1001:Code active
1
• https://www.smartpay.pl/check?service=SP&password=haslo&code=kod123&just_check=true - działa jak powyższe, ale nie oznacza kodu jako użytego. Odpowiedź będzie taka sama.
• https://www.smartpay.pl/check?service=SP&password=haslo&code=kod123&rate=1 - również sprawdza kod, ale wyszukuje tylko wśród płatności dokonanych na numery o wartości 1 PLN netto
Komunikaty zwrotne
Każdy komunikat zwrotny składa się z dwóch lub trzech linii i ma nastęujący schemat
<status operacji>
<kod wynikowy>:<komunikat zwrotny>
(<stawka netto>)
Na przykład taką odpowiedź otrzymasz gdy sprawdzany kod będzie już wykorzystany:
INACTIVE
2002:Code present but used
Pierwsza linia może przyjąć wartość "OK", "INACTIVE" lub "ERROR". OK oznacza, iż operacja sprawdzenia kodu powiodła się i znaleziony kod jest aktywny. "INACTIVE" oznacza, że operacja sprawdzenia kodu się powiodła, ale kod albo nie został znaleziony, albo jest nieaktywny. "ERROR" oznacza, iż sprawdzenie kodu nie było możliwe. W takiej sytuacji kolejna linia określa rodzaj błędu.
Poniżej znajduje się lista możliwych komunikatów zwrotnych wraz z ich znaczeniem.
Dla statusu "OK":
• 1001:Code active - kod został znaleziony i jest aktywny
Dla statusu "INACTIVE":
• 2001:Code missing - szukany kod nie został odnaleziony
• 2002:Code present but used - kod został odnaleziony, ale nie jest już aktywny
Dla statusu "ERROR":
• 3001:Parameter missing - brakuje któregoś z parametrów (password,service lub code)
• 3004:Service ID invalid - podany identyfikator (parametr service) jest nieprawidłowy
• 3005:Parameter format invalid - któryś z parametrów ma nieprawidłowy format (np. znaki inne niż cyfry i litery w kodzie)
• 3006:Authorization failed - błędna kombinacja hasła użytkownika i identyfikatora (subprefixu) serwisu
• 5001:Internal error - błąd wewnętrzny po stronie SmartPay. Prosimy o zgłszania każdego wystąpienia takiego błędu
