Szablon do importu kart prepaid

Szablon do importu kart prepaid to plik Excel, który po uprzednim, odpowiednim uzupełnieniu danymi może posłużyć do masowego dodania większej ilości kart prepaid. Arkusz jest bardzo restrykcyjny i należy wprowadzić odpowiednie wartości w odpowiadające pola. W przypadku błędnego wypełnienia, próba importu kart do systemu zakończy się niepowodzeniem. Dobra znajomość szablonu jest niezbędna przy zarządzaniu kartami prepaid. Mając wiedzę za co odpowiadają poszczególne wartości, będziemy mogli modyfikować ustawienia kart zgodnie z naszymi potrzebami.

Szablon składa się z wiersza nagłówka (którego nie można kasować!) oraz danych kart prepaid. Poszczególne kolumny zawierają następujące informacje:

• Card Unique Identifier (wymagane) - unikalny identyfikator karty tzw. UID. Jest to numer pod jakim karta jest odczytywana przez czytnik Nayax. Numer UID nie zawsze odpowiada numerowi nadrukowanemu.
   
• Display Card Number - numer nadrukowany karty który będzie wyświetlany w systemie Nayax obok numeru UID. Po tym numerze można wyszukiwać kartę tak samo jak po numerze UID.  Dozwolone są znaki alfanumeryczne, więc możemy użyć nazw własnych w celu ich szybkiej identyfikacji np.:
  
  1976725420 jest numerem UID (Card Unique Identifier)
  testowa Televend - tutaj występuje w charakterze numeru nadrukowanego (Display Card Number)
  
  
• Card Holder Name - nazwa posiadacza karty. Można wyszukiwać karty prepaid po nazwie posiadacza. Pojawia się także w niektórych raportów dot. kart prepaid
   
• Employee/ User Identity - identyfikator pracownika / użytkownika. Można wyszukiwać karty prepaid po identyfikatorze. Pojawia się także w niektórych raportów dot. kart prepaid
   
• Country Dialing Code - prefiks numeru telefonicznego podany bez znaku '+' np. dla numeru z Polski  48
   
• Mobile Phone Number - numer komórkowy posiadacza karty. Dodanie numeru sprawi, że karta będzie automatycznie powiązana z numerem telefonu posiadacza w aplikacji Monyx Wallet
   
• E-Mail Address - pole wykorzystywane do przechowywania informacji o adresie mailowym użytkownika
   
• Currency 3 Letter Code - 3-literowe oznaczenie waluty np. PLN
   
• Card Member Type - cyfrowe oznaczenie stopnia członkostwa. Parametr jest wykorzystywany wyłącznie, gdy użytkownik stosuje politykę cenową w zależności o stopnia członkostwa
   
• Is Credit(1 or 0- insert only) (wymagane) - określa sposób interpretacji kreytu na karcie. Przyjmuje wyłącznie wartości 1 i 0:
  • 1 - kredyt wartościowy rozumiany jako ekwiwalent takiej samej kwoty w lokalnej walucie np. kredyt wartościowy 10 oznacza, że użytkownik może kupić produkty za 10 zł
  • 0 - kredyt ilościowy rozumiany jako ilość transakcji jaką może wykonać konsument bez względu na wartość produktu np. kredyt ilościowy 10 oznacza, że użytkownik może kupić 10 produktów
     
• Is Weekday Limit (1 or 0 - Insert only) (wymagane) - określa czy karta ma mieć ograniczoną możliwość zakupu w poszczególne dni tygodnia. Przyjmuje wartości 1 i 0:
  • 1 - limity w poszczególne dni są aktywne. W rezultacie musimy zdefiniować limit w poszczególne dni w jednej z kolumn:
    • Weekday Max Amount(7 days values) - jeśli wybraliśmy wcześniej kredyt wartościowy
    • Weekday Max Transaction (7 days values) - jeśli wybraliśmy wcześniej kredyt ilościowy
  • 0 - obowiązuje jeden limit dzienny dla wszystkich dni tygodnia. Należy uzupełnić wartość w kolumnie Max Daily
     
• Max Daily - limit dzienny. W zależności od wybrania kredytu wartościowego lub ilościowego, określa na jaką kwotę lub ile transakcji  dziennie może wykonać posiadacz karty. Wartość 0 oznacza brak limitów
• Max Weekly - limit tygodniowy. W zależności od wybrania kredytu wartościowego lub ilościowego, określa na jaką kwotę lub ile transakcji  tygodniowo może wykonać posiadacz karty. Wartość 0 oznacza brak limitów
• Weekday Max Amount(7 days values) - określa limity kwot dla poszczególnych dni tygodnia zaczynając od Niedzieli. Przykładowa wartość -1;0;10;0;0;0;-1 oznacza, że użytkownik:
  • nie wykona zakupów w Niedzielę i Sobotę (świadczą o tym wartości -1 na pierwszej i ostatniej pozycji)
  • w Wtorek będzie mógł kupić produkty wyłącznie za kwotę 10 zł (świadczy o tym wartość 10 na trzeciej pozycji)
  • w pozostałe dni tygodnia kwota zakupu nie jest ograniczona. Użytkownik może wykonywać transakcje do wysokości salda
     
• Weekday Max Transaction (7 days values) - określa limity transakcji dla poszczególnych dni tygodnia zaczynając od Niedzieli. Przykładowa wartość -1;0;10;0;0;0;-1 oznacza, że użytkownik:
  • nie wykona zakupów w Niedzielę i Sobotę (świadczą o tym wartości -1 na pierwszej i ostatniej pozycji)
  • w Wtorek będzie mógł przeprowadzić wyłącznie 10 transakcji (świadczy o tym wartość 10 na trzeciej pozycji)
  • w pozostałe dni tygodnia ilość transakcji nie jest ograniczona. Użytkownik może wykonywać transakcje do wysokości salda
     
• Max Monthly (wymagane) - limit miesięczny. W zależności od wybrania kredytu wartościowego lub ilościowego, określa na jaką kwotę lub ile transakcji może wykonać posiadacz karty w ciągu miesiąca. Wartość 0 oznacza brak limitów
   
• Is Accumulated(1 or 0) (wymagane) - parametr określa czy kredyt dostępny na karcie prepaid przechodzi na kolejny miesiąc wraz z końcem okresu rozliczeniowego:
  • 1 - kredyt zostanie przeniesiony na następny miesiąc i powiększony o ewentualną kwotę doładowania z kolumny Monthly Reload
  • 0 - kredyt nie zostanie przeniesiony na następny miesiąc. W rezultacie zostanie zrównany do kwoty wskazanej w kolumnie Monthly Reload
     
• Is Active(1 or 0) (wymagane) - parametr określający czy karta ma być aktywna:
  • 1 - karta aktywna
  • 0 - karta nieaktywna
     
• Is Single Use(1 or 0) (wymagane) - parametr określający czy karta ma być jednorazowa:
  • 1 - karta jednorazowa, karta nie odnawia automatycznie kredytu na przełomie miesiąca, jednakże Operator może w systemie ręcznie zmienić kredyt na karcie
  • 0 - karta z automatycznym uzupełnieniem kredytu na przełomie miesiąca. Wymaga zdefiniowania kwoty doładowania w kolumnie Monthly Reload
     
• Is Cash Revalue (1 or 0) (wymagane) - włączenie opcji doładowania karty prepaid za pomocą gotówki. Do działania wymaga odpowiednio skonfigurowanego wirtualnego automatu oraz obsługi protokołu MDB2 przez fizyczny automat:
  • 1 - włączone
  • 0 - wyłączone
     
• Is Credit Card Revalue (1 or 0) - włączenie opcji doładowania karty prepaid za kart bankomatowych. Parametr musi być ustawiony na włączony jeśli chcemy mieć możliwość dodania karty prepaid do aplikacji Monyx Wallet. Do działania wymaga odpowiednio skonfigurowanego wirtualnego automatu oraz obsługi protokołu MDB2 przez fizyczny automat:
  • 1 - włączone
  • 0 - wyłączone
     
• Maximum Revalue Amount - maksymalna kwota jaką użytkownik może doładować kartę prepaid korzystając z gotówki lub karty bankowej. Pozostawienie parametru na 0 blokuje możliwość doładowania kart, ale nie blokuje możliwości dodania karty do Monyx Wallet. Maksymalnie kwota to 125 zł.
   
• Card Group (delimited by comma) - identyfikatory grup automatów w których można dokonać płatności za pomocą konfigurowanej karty prepaid. Pozostawienie tego pola pustego oznacza, że karta może wykonać transakcje w dowolnej z grup. Identyfikator grupy można sprawdzić w Operacje > Automaty > Utwórz > Dodaj / Zmień grupę .
  Zapis 671(2),9264 oznaczałby, że użytkownik może wykonywać transakcje wyłącznie w automatach z grupy o identyfikatorze 9264 oraz 671, z uwzględnieniem, że w grupie 671 może wykonać wyłącznie transakcje za 2 zł lub 2 zakupy w zależności czy w kolumnie Is Credit(1 or 0- insert only) wybrano kredy wartościowy czy ilościowy
   
• Card Location (delimited by comma) - parametr prawie nieużywany. Przydatny wyłącznie jeśli Operator korzysta z lokacji ustawionych po stronie automatu (nie mylić z pojęciem lokalizacji, które jest charakterystyczne dla Instytucji systemu Nayax)
   
• Card Credit (wymagane) - w tej kolumnie jest zawarta informacja o kredycie karty. W przypadku tworzenia nowej karty, zostanie ona utworzona z kredytem wskazanym w tej kolumnie. 
   
• Is Delta Credit(1 or 0) (wymagane) - parametr określający czy podczas importowania kart do systemu Nayax ma być uwzględniony obecny kredyt karty. Informacja o obecnym kredycie jest przechowywana na serwerach Nayax. Parametr przyjmuje dwie wartości:
  • 1 - podczas importowania pliku system weźmie pod uwagę kredyt na serwerze i doda do niego wartość w kolumnie Card Credit. W ten sposób w jednej operacji można modyfikować wartość kredytu wielu kart. Przy zmianie wyłącznie ustawień karty bez zmiany kwoty kredytu należy ustawić Is Delta Credit(1 or 0) na 1, a Card Credit na 0
  • 0 - podczas importowania pliku do systemu obecny kredyt na karcie zostanie zignorowany i ustawiony na wartość w kolumnie Card Credit. Z tej wartości należy korzystać wyłącznie przy dodawaniu nowych kart
     
• Card Activation Date (format: DD/MM/YYYY) - jeśli wartość w kolumnie Is Active(1 or 0) ustawimy na 0, karta nie jest aktywna po dodaniu do systemu. Ustawiając datę aktywacji na np. 01/03/2020 mamy pewność, że kartą nie będzie można wykonać zakupu nawet jeśli wcześniej zostanie dodana do systemu. W praktyce pozwala to wydać klientowi karty o wiele wcześniej niż faktyczny czas rozpoczęcia korzystania
   
• Card Expiration Date (format: DD/MM/YYYY) - w przeciwieństwie do powyższego parametru ten pozwala na określenie daty wygaśnięcia obecnie aktywnej karty. Może być wykorzystane, gdy wydajemy karty prepaid o określonym terminie ważności np. karty podarunkowe
   
• Revalue Expiration Date (format: DD/MM/YYYY) - po upływie daty wskazanej w tej kolumnie użytkownik nie będzie miał możliwości samodzielnie doładować karty przy terminalu płatniczym
   
• Set as Single Use(format: DD/MM/YYYY) - pozwala na ustalenie daty, po której upływie karta nie będzie odnawiała środków. Z technicznego punktu widzenia parametr karty Is Single Use(1 or 0) zmieni wartość na 1. Mechanizm jest stoosowany np. w szkołach, gdzie przez okres wakacyjny karty uczniów nie powinny być doładowywane, ale powinni oni zachować dostęp do zgromadzonych środków
   
• Remove Single Use  (format: DD/MM/YYYY) - pozwala na ustalenie daty, po której karta będzie odnawiała środki w kwocie wskazanej w kolumnie Monthly Reload
   
• Monthly Reload (wymagane) - na przełomie miesiąca karta zostanie zasilona (w zależności od parametru Is Accumulated(1 or 0)) kwotą lub do kwoty wskazanej w tej kolumnie
   
• Note - ta kolumna pozwala na zapisanie dodatkowych informacji na temat tej karty. Informacje będą wyświetlane wyłącznie w podglądzie karty
   
• Revalue Credit - parametr wyłącznie do odczytu. Prezentuję ilość środków zgromadzonych z doładowania karty prepaid za pomocą gotówki lub kart bankowych
   

Do tego artykuły dołączyliśmy dwa pliki Excel. Jeden z nich jest pustym szablonem, który można też wygenerować w systemie Nayax po przejściu do zakładki Import Kart prepaid w Ustawianiach kart prepaid:

Kolejny szablon jest już gotowy do importu. Wystarczy zmienić dane w pierwszych kolumnach, aby stworzyć kartę która będzie miała 30 kredytu do wykorzystania w przeciągu miesiąca. Kredyt nie będzie przechodził na kolejny miesiąc, a po przełomie miesiąca konsument będzie miał kolejne 30 zł do wykorzystania. Pamiętaj aby dodając wiele kart przekopiować pozostałe ustawienia do kolejnych wierszy.