Parametre
Aktualizováno
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 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.