Przejdź do treści

Integracja terminala do kart płatniczych z Pact24

← Dla Programistów

Integracja terminala do kart płatniczych z Pact24


Pact24 może zarządzać każdym multimedialnym elementem terminala do kart płatniczych. 
W poniższym artykule pokazano jak za pomocą Pact24 zarządzać graficznym nagłówkiem na wydruku oraz multimedialnym PinPadem.

I. Grafika w nagłówku wydruków z terminala do kart płatniczych

1. Każda lokalizacja (sklep) ma swój indywidualny zestaw danych. Dane te otrzymuje klient systemu Pact24.
a) dane dostępowe do lokalizacji:
location_email: demo@firma.pl
location_password: tajnehaslo
location_id: 15
b) id wskazujący na graficzny nagłówek, który drukuje się na potwierdzeniach z terminala do kart płatniczych:
screen_id: 35
c) nr licencji dostępowej:
license_serial_number: E766-B6AC-92F7-701A

2. Na podstawie powyższych danych budujemy zapytanie do chmury Pact24 zgodnie z poniższym formatem:
https://www.pact24.eu/api/locations/location_id/screens/screen_id/attachments?license_serial_number=string_license_serial_number?date=yyyy-mm-dd
Przykład:
https://www.pact24.eu/api/locations/15/screens/35/attachments?license_serial_number=E766-B6AC-92F7-701A?date=2015-12-31
a) autentykacja zapytania odbywa się poprzez HTTP Basic Auth, gdzie:
login: location_email
hasło: location_password
b) parametr date w zapytaniu:
- jest opcjonalny (wtedy chmura Pact24 odpowiada wg stanu, który jest aktualny w momencie wysłania zapytania)
- należy go stosować gdy chcemy się dowiedzieć jaki plik jest przewidziany np. na jutrzejszy dzień

3. Odpowiedź z chmury Pact24 przychodzi w formacie JSON:
a) przykład:
[{"campaign":"Logo Terminal","url":"https://pact24-eu.s3-eu-west-1.amazonaws.com/uploads/2/attachment/file/1589/cf0afb3ee686436c.png?AWSAccessKeyId=AKIAI4QV3DPWVYNGUVVQ&Signature=mvAaD7nsRSrCzvfUZt7Pzr521sE%3D&Expires=1450110148"}]
 b) odpowiedzią jest tablica, której każdy element składa się z dwóch atrybutów:
campaign: nazwa kampanii w Pact24
url: adres url do pobrania pliku (uwaga adres jest ważny przez 1h)

c) tablica może zawierać więcej niż jeden element
W przypadku, który omawiamy, czyli graficzny nagłówek na wydruku oczywistym jest, że możemy użyć tylko jednego pliku, dlatego korzystamy z ostatniego (najnowszego) elementu (pliku) tablicy

d) tablica może być pusta, wtedy procesor odpowiadający za terminal do kart płatniczych, powinien wysłać na terminal swoje logo

II. Grafika na multimedialnym PinPadzie lub jakikolwiek inny element multimedialny w urządzeniu

1. Zasada pobierania plików graficznych dla PinPad'a jest dokładnie taka sama jak w opisanym wyżej przykładzie.
Jedynym atrybutem, który się zmienia to screen_id, który teraz wskazuje na ekran PinPada.

2. Jeżeli PinPad umożliwia wyświetlanie kilku zdjęć tzw. pokaz slajdów, wtedy gdy odpowiedź zawiera więcej elementów, to oczywiście korzystamy ze wszystkich elementów. Natomiast gdy PinPad może wyświetlać tylko jedną grafikę, to zasada działania jest identyczna jak przy wydruku graficznego nagłówka, czyli wykorzystujemy tylko ostatni element tablicy.

III. Praktyka użycia

1. Harmonogram zapytań
W przypadku terminali do kart płatniczych zmiany elementów graficznych zazwyczaj mogą odbywać się tylko raz na dobę:
a) jeżeli tak jest, to należy wówczas wyznaczyć przedział godzinowy, w którym będzie wysyłane zapytanie do chmury Pact24 - najlepiej dopasować to na 1-4h przed automatyczną aktualizacją danych na terminalu (wystarczy 1 zapytanie)

b) jeżeli tak NIE jest i zmiany na terminalu mogą odbywać się wiele razy w ciągu doby, wówczas odpytujemy chmurę Pact24 o bieżący stan nieczęściej niż co 4 godziny (częstsze odpytywanie może się zakończyć blokadą w celu ochrony przed DDos)

2. Przygotowanie odpowiedniego menu w systemie Procesora
a) pięć powyższych atrybutów (location_email, location_password, location_id, screen_id, license_serial_number) są unikalne dla każdej lokalizacji (sklepu), stąd należy w systemie procesora zapewnić możliwość ich konfiguracji.

b) ewentualnie dodatkowym parametrem może być godzina wysłania zapytania do chmury Pact24 (patrz punkt III.1). 

c) jeżeli Pact24 będzie zarządzać graficznym nagłówkiem, multimedialnym PinPadem oraz ewentualnie jeszcze innym elementem, wówczas dla każdego z tych elementów jest osobny atrybut screen_id.

Zgłoszenia i baza wiedzy

(Myślenie…)