parametre

Aktualizované 

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.

    securepay_3.jpeg

  • 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 je nižšie

copy

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

Názov

Hodnota

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)
Viac v prílohe: HMAC value creation appendix.
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.
Potrebný
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

POZNÁMKA: Je vyslovene odporučené, aby obchodník verifikoval Orderhash, ktorý sa vráti zo serveru Teya na returnurlsuccessserver, aby sa predišlo pokusom o podvody.

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.

Názov

Hodnota

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)
Viac v prílohe: HMAC value creation appendix.

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

Názov

Hodnota

Status

"Cancel"

Neočakávaná chyba

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

Názov

Hodnota

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:

Názov

Hodnota

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:

copy

<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.