Parametre

FUNKCIE / OBMEDZENIA

• Teya zabezpečená platobná stránka môže byť nakonfigurovaná tak, aby boli od držiteľa karty vyžadované údaje, ako sú e-mailová adresa, telefónne číslo alebo adresa trvalého bydliska.
• Ak je hodnota parametra skipreceiptpage nastavená na 1, tak nie je zobrazená stránka s potvrdením a zákazník je rovno presmerovaný na URL uvedenú v parametri returnurlsuccess. V tomto kroku musí obchodník sám zobraziť zákazníkovi potvrdenie o platbe.
• Logo spoločnosti môže byť zobrazené na platobnej stránke nastavením platnej URL v parametri merchantlogo. Logo bude potom zobrazené v ľavom hornom rohu nad menom obchodníka. Obrázok musí byť k dispozícii prostredníctvom HTTPS protokolu, inak môže dochádzať k zobrazovaniu varovnej hlášky v prehliadači.
• SecurePay používa sadu znakov unicode (UTF-8). Ak Váš web používa inú sadu znakov, napr. iso8859, potom je nutná znaková konverzia.
  
  Príklad konverzného kódu v .Net:

public static string iso8859ToUnicode(string src)

{

Encoding iso = Encoding.GetEncoding("iso8859-1");

Encoding unicode = Encoding.UTF8;

byte[] isoBytes = iso.GetBytes(src);

byte[] unibytes = Encoding.Convert(iso,unicode,isoBytes);

char[] unichars = new char[iso.GetCharCount(unibytes,0,unibytes.Length)];

unicode.GetChars(unibytes,0,unibytes.Length,unichars,0);

return new string(unichars);

}

• SecurePay podporuje Verified By Visa (VbV) a MasterCard SecureCode, žiadne technické zmeny nie sú potrebné k aktivácii týchto zabezpečení. Prosím zašlite požiadavku na aktiváciu na: podpora@sTeya.co, uveďte webovú adresu a ID obchodníka (Merchant ID).
• Desatinné čísla môžu byť posielané s bodkou alebo s čiarkou.
• Každý pár MarchantId / PaymentGatewayId môže podporovať iba jednu menu. Ak je potrebná podpora viac ako jednej meny, musí web vedieť prepínať páry MerchantId/PaymentGatewayId v závislosti na mene. Za viac MerchantId/PaymentGatewayId sa neúčtuje žiadny poplatok.

PARAMETRE ZASIELANÉ E-SHOPOM PLATOBNEJ STRÁNKE

• Merchantid - Potrebný
  ID obchodníka dodané spoločnosťou Teya.
• paymentgatewayid - Potrebný
  ID platobnej brány dodané spoločnosťou Teya; identifikuje platobnú metódu.
• Orderid- Potrebný
  ID objednávky generované e-shopom; zahrňuje sa do platobnej transakcie; maximálna dĺžka: 12 alfanumerických znakov; nesmú byť použité znaky rozšírenej znakovej sady.
• reference - Voliteľný
  Ľubovoľný text (string) vrátený s rovnakou hodnotou, s akou bol poslaný. Hlavnou funkciou je zjednodušenie adaptácie na systém obchodníka; slúži ako externé id objednávky.
• checkhash - Potrebný
  Podpis, ktorý je vytvorený spojením nasledujúcich parametrov s | ako oddeľovačom a použitím HMAC SHA256 v kombinácii s tajným kľúčom Secret key.
  MerchantId|ReturnUrlSuccess|ReturnUrlSuccessServer|OrderId|Amount|Currency
  (Secret key je vydaný spoločnosťou Teya a je známy iba obchodníkovi a spoločnosti Teya)
• amount - Potrebný
  Finálny súčet; maximálne 2 desatinné čísla; Platné hodnoty napr.: 350 alebo 12.34 alebo 54,43.
• currency- Potrebný
  Kód meny; možné hodnoty: GBP, USD, EUR, DKK, NOK, SEK, CHF, CAD, HUF, BHD, AUD, RUB, PLN, RON, HRK, CZK, ISK. defaultná hodnota je ISK.
• language- Potrebný
  Jazyk platobnej stránky. V súčasnosti podporujeme tieto jazyky: Slovenský (SK) Český (CZ), Islandský (IS), Anglický (EN), Nemecký (DE), Francúzsky (FR), Ruský (RU), Španielsky (ES) Taliansky (IT), Portugalský (PT), Slovinský (SI), Maďarský (HU), Švédsky (SE), Holandský (NL), Poľský (PL), Nórsky (NO), Slovák (SK), Chorvátsky (HR), Srbský (SR), Rumunský (RO), Dánsky (DK), Fínsky (FI), Faerský (FO).
• buyername- Voliteľný
  Meno zákazníka, ak je prázdne, zákazník môže doplniť na platobnej stránke.
• returnurlsuccess - Potrebný
  URL pre presmerovanie zákazníka po úspešne zrealizovanej platbe.
• returnurlsuccessserver- Podmienený
  URL pre zaslanie notifikácie o úspešnej platbe zo servera, ak nie je parameter vyplnený, bude pre notifikáciu automaticky použitá URL v parametri returnurlsuccess.*
• returnurlcancel - Voliteľný
  URL pre presmerovanie zákazníka po zrušení platby, zákazník stlačil tlačidlo Zrušiť
• returnurlerror - Voliteľný
  URL pre presmerovanie zákazníka v prípade neočakávanej chyby.
• pagetype - Voliteľný
  Ak je nastavená hodnota ‘1’, budú od držiteľa karty vyžadované tieto informácie: e-mailová adresa, telefónne číslo, miesto trvalého bydliska. V tomto prípade musí byť nastavený aj parameter merchantemail, pretože na tento email sú obchodníkovi zasielané vyššie uvedené dáta.
• merchantlogo - Voliteľný
  Ak tento parameter obsahuje URL obrázku (100x100 pixelov), bude obrázok zobrazený v ľavej časti nad obchodníkovo meno. Dôležité: Ak nie je obrázok dostupný cez SSL protokol, IE zobrazí varovnú hlášku.
• skipreceiptpage - Voliteľný
  Ak je nastavená hodnota ‘1’, nie je zákazníkovi zobrazené potvrdenie o platbe. Zákazník je okamžite presmerovaný na URL uvedenú v parametri returnurlsuccess. V tomto prípade musí potvrdenie o platbe zákazníkovi zobraziť e-shop.
• merchantemail - Voliteľný
  Ak je vyplnený, je na túto adresu zaslaný e-mail s potvrdením o úspešnej platbe. Správa obsahuje informáciu o obchodníkovi a kupujúcom a obsahu nákupného košíka.
• buyeremail - Voliteľný
  Ak je vyplnené, je zákazníkovi zaslané e-mail o úspešnej platbe. Správa obsahuje informácie o obchodníkovi, kupujúcom a obsah nákupného košíka.
• displaymode - Voliteľný
  Ak je nastavené "iframe", platobná stránka je kompaktnejšieho vzhľadu a vhodná pre zobrazenie v iframes. Minimálna podporovaná šírka je 370px a maximum je 755px.
• showadditionalbrands - Voliteľný
  Ak je nastavené "false", nebudú sa zobrazovať iné logá okrem VISA a MasterCard.

Obsah nákupného košíka sa z pohľadu platobnej stránky skladá z jednej alebo viac položiek, pričom každý typ položky musí byť na novom riadku. Každý riadok sa potom skladá z jedného typu položky s množstvom, jednotkovou cenou a medzisúčtom za typ položky. Položky nákupného košíka sú zasielané s poradovým číslom. Číslovanie začína nulou a prírastok je 1. Každá sada parametrov predstavuje jeden riadok v nákupnom košíku.

• Itemdescription_x - Potrebný
  Popis položky, maximálna dĺžka: 80 znakov.
• Itemcount_x - Potrebný
  Počet položiek daného typu.
• Itemunitamount_x - Potrebný
  Cena za jednotku.
• Itemamount_x - Potrebný
  Medzisúčet za typ položky. itemamount = itemcount * itemunitamount

PARAMETRE ZASIELANÉ PLATOBNOU STRÁNKOU E-SHOPU

Platobná stránka môže ukončiť spracovanie platby v troch prípadoch:

• Úspešná platba: zákazník je presmerovaný na URL nastavenú v parametri returnurlsuccess
• Zrušenie platby zákazníkom: zákazník je presmerovaný na URL nastavenú v parametri returnurlcancel
• Neočakávaná chyba: zákazník je presmerovaný na URL nastavenú v parametri returnurlerror

Úspešná platba

Ak je platba úspešná, zákazník je presmerovaný na url adresu definovanú v parametri returnurlsuccess s nasledujúcimi HTTP POST parametrami. Použitie je na rozhodnutí webu, ale je dôležité verifikovať Orderhash, aby sa zvalidovala správa o úspešnej platbe od spoločnosti Teya.

• status
  „Ok“
• orderhash
  Podpis, ktorý je vytvorený spojením nasledujúcich parametrov s | ako oddeľovačom a použitím HMAC SHA256 v kombinácii s tajným kľúčom secret key.
• orderid|amount|Currency
  (Secret key je vydaný spoločnosťou Teya je známy iba obchodníkovi a spoločnosti Teya)
• orderid
  Číslo objednávky generované a zaslané e-shopom platobnej stránke počas inicializácie platby.
• authorizationcode
  Autorizácia platby z Teya.
• creditcardnumber
  Čiastočne maskované číslo platobnej karty (1234******1234).
• step
  Teya zasiela úspešnú správu do e-shopu v dvoch prípadoch. 1. Zákazník zrealizoval úspešnú platbu a Teya zobrazil zákazníkovi potvrdenie o platbe. Dôležité: táto URL požiadavka prichádza zo serveru Teya, nie je dodaná zo strany zákazníka a nie je ani v rovnakej aktívnej session. 2. Zákazník stlačil tlačidlo ‘Späť do e-shopu’. Kroky sú označené nasledujúcimi hodnotami:
  • Platba: platba bola úspešne zrealizovaná. Pre ďalšie informácie viď oddiel C.
  • Potvrdenie: Zákazník sa vrátil z platobnej stránky späť do e-shopu.
• ticket
  Iba v prípade, ak sa k platobnej stránke pristupovalo s použitím ticketu (viď Sekcia Ticket API). Tento parameter bude obsahovať identifikátor použitého ticketu.
• buyername
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyeraddress
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyerzip
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyercity
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyercountry
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyerphone
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyeremail
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyerreferral
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)
• buyercomment
  Iba v prípade, že bola vyžadovaná registrácia (pagetype = 1)

Zrušenie

Ak zákazník stlačí tlačidlo Zrušenie, je presmerovaný na URL uvedenú v parametri returnurlcancel

• Status
  "Cancel"

Neočakávaná chyba

V prípade neočakávanej chyby je zákazník presmerovaný na URL uvedenú v parametri returnurlerror

• Status
  „Error“
• errordescription
  Popis chyby pre zákazníka
• errorcode
  Kód chyby.

V tomto prípade vráti testovacia verzia platobnej brány nasledovné parametre:

• errordetail
  Detaily chyby.
• auditlog
  Dáta z auditu logu.

Odpoveď na notifikáciu o platbe

Ak parameter step obsahuje hodnotu „Payment“, tak preferovaná odpoveď od e-shopu by mala byť XML dokument, ktorý indikuje, že e-shop úspešne obdržal notifikáciu.

Štruktúra XML by mala byť nasledujúca:

<PaymentNotification>Accepted</PaymentNotification>

Ak je od e-shopu obdržaná táto odpoveď, je vytvorený záznam do logu, že e-shop úspešne obdržal notifikáciu o platbe. V opačnom prípade bude záznam v logu obsahovať iba informáciu, že notifikácia o platbe bola zaslaná e-shopu.