FUNKCE / OMEZENÍ
-
Teya zabezpečená platební stránka může být nakonfigurována tak, aby byly od držitele karty vyžadovány údaje, jako jsou e-mailová adresa, telefonní číslo nebo adresa trvalého bydliště.
- Pokud je hodnota parametru skipreceiptpage nastavena na 1, tak není zobrazena stránka s potvrzením a zákazník je rovnou přesměrován na URL uvedenou v parametru returnurlsuccess. V tomto kroku musí obchodník sám zobrazit zákazníkovi potvrzení o platbě.
- Logo společnosti může být zobrazeno na platební stránce nastavením platné URL v parametru merchantlogo. Logo bude poté zobrazeno v levém horním rohu nad jménem obchodníka. Obrázek musí být k dispozici prostřednictvím HTTPS protokolu, jinak může docházet k zobrazování varovné hlášky v prohlížeči.
- SecurePay používá sadu znaků unicode (UTF-8). Pokud Váš web používá jinou sadu znaků, například. iso8859, pak je nutná znaková konverze. Příklad konverzního kódu v .Net je níže.
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, žádné technické změny nejsou zapotřebí k aktivaci těchto zabezpečení. Prosím zašlete požadavek na aktivaci na: podpora@teya.com, uveďte webovou adresu a ID obchodníka (Merchant ID).
- Desetinná čísla mohou být zasílána s tečkou nebo s čárkou.
- Každý pár MerchantId / PaymentGatewayId může podporovat pouze jednu měnu. Pokud je potřebná podpora více než jedné měny, musí web umět přepínat páry MerchantId/PaymentGatewayId v závislosti na měně.
PARAMETRY ZASÍLÁNÉ E-SHOPEM PLATEBNÍ STRÁNCE
|
Název
|
Hodnota
|
|
Merchantid
Potrebný |
ID obchodníka dodané společností Teya.
|
|
paymentgatewayid
Potřebný |
ID platební brány dodané společností Teya; identifikuje platební metodu.
|
|
Orderid
Potřebný |
ID objednávky generované e-shopem; zahrnuje se do platební transakce; maximální délka: 12 alfanumerických znaků; nesmí být použity znaky rozšířené znakové sady.
|
|
reference
Volitelný |
Libovolný text (string) vrácen se stejnou hodnotou, s jakou byl poslán. Hlavní funkcí je zjednodušení adaptace na systém obchodníka; slouží jako externí id objednávky.
|
|
checkhash
Potřebný |
Podpis, který je vytvořen spojením následujících parametrů s|jako oddělovačem a použitím HMAC SHA256 v kombinaci s tajným klíčem Secret key.MerchantId|ReturnUrlSuccess|ReturnUrlSuccessServer|OrderId|Amount|Currency (Secret key je vydán společností Teya a je známý pouze obchodníkovi a společnosti Teya)
|
|
amount
Potřebný |
Finální součet; maximálně 2 desetinná čísla; Platné hodnoty např.: 350 nebo 12.34 nebo 54,43.
|
|
currency
Potřebný |
Kód měny; možné hodnoty: GBP, USD, EUR, DKK, NOK, SEK, CHF, CAD, HUF, BHD, AUD, RUB, PLN, RON, HRK, CZK, JISK. defaultní hodnota je ISK.
|
|
language
Potřebný |
Jazyk platební stránky. V současnosti podporujeme tyto jazyky: Český (CZ), Islandský (IS), Anglický (EN), Německý (DE), Francouzský (FR), Ruský (RU), Španělský (ES) Italsky (IT), Portugalský (PT), Slovinský (SI), Maďarský (HU), Švédský (SE), Nizozemský (NL), Polský (PL), Norský (NO), Slovák (SK), Chorvatský (HR), Srbský (SR), Rumunský (RO), Dánský (DK), Finský (FI), Faerský (FO).
|
|
buyername
Volitelný |
Jméno zákazníka, je-li prázdné, zákazník může doplnit na platební stránce.
|
|
returnurlsuccess
Potřebný |
URL pro přesměrování zákazníka po úspěšně zrealizované platbě.
|
|
returnurlsuccessserver
Podmíněný |
URL pro zaslání notifikace o úspěšné platbě ze serveru, není-li parametr vyplněn, bude pro notifikaci automaticky použita URL v parametru returnurlsuccess.*
|
|
returnurlcancel
Volitelný |
URL pro přesměrování zákazníka po zrušení platby, zákazník stiskl tlačítko Zrušit
|
|
returnurlerror
Volitelný |
URL pro přesměrování zákazníka v případě neočekávané chyby.
|
|
pagetype
Volitelný |
Pokud je nastavena hodnota ‘1’, budou od držitele karty vyžadovány tyto informace: e-mailová adresa, telefonní číslo, místo trvalého bydliště. V tomto případě musí být nastaven i parametr merchantemail, protože na tento email jsou obchodníkovi zasílána výše uvedená data.
|
|
merchantlogo
Volitelný |
Pokud tento parametr obsahuje URL obrázku (100x100 pixelů), bude obrázek zobrazen v levé části nad obchodníkovo jméno. Důležité: Pokud není obrázek dostupný přes SSL protokol, IE zobrazí varovnou hlášku.
|
|
skipreceiptpage
Volitelný |
Pokud je nastavena hodnota ‘1’, není zákazníkovi zobrazeno potvrzení o platbě. Zákazník je okamžitě přesměrován na URL uvedenou v parametru returnurlsuccess. V tomto případě musí potvrzení o platbě zákazníkovi zobrazit e-shop.
|
|
merchantemail
Volitelný |
Pokud je vyplněn, je na tuto adresu zaslán e-mail s potvrzením o úspěšné platbě. Zpráva obsahuje informaci o obchodníkovi a kupujícím a obsahu nákupního košíku.
|
|
buyeremail
Volitelný |
Pokud je vyplněno, je zákazníkovi zasláno e-mail o úspěšné platbě. Zpráva obsahuje informace o obchodníkovi, kupujícím a obsah nákupního košíku.
|
|
displaymode
Volitelný |
Pokud je nastaveno „iframe“, platební stránka je kompaktnějšího vzhledu a vhodná pro zobrazení v iframes. Minimální podporovaná šířka je 370px a maximum je 755px.
|
|
showadditionalbrands
Volitelný |
Pokud je nastaveno "false", nebudou se zobrazovat jiná loga kromě VISA a MasterCard.
|
|
|
Obsah nákupního košíku se z pohledu platební stránky skládá z jedné nebo více položek, přičemž každý typ položky musí být na novém řádku. Každý řádek se pak skládá z jednoho typu položky se spoustou, jednotkovou cenou a mezisoučtem za typ položky. Položky nákupního košíku jsou zasílány s pořadovým číslem. Číslování začíná nulou a přírůstek je 1. Každá sada parametrů představuje jeden řádek v nákupním košíku.
|
|
Itemdescription_x
Potřebný |
Popis položky, maximální délka: 80 znaků.
|
|
Itemcount_x
Potřebný |
Počet položek daného typu.
|
|
Itemunitamount_x
Potřebný |
Cena za jednotku.
|
|
Itemamount_x
Potřebný |
Mezisoučet za typ položky. itemamount = itemcount * itemunitamount
|
PARAMETRY ZASÍLÁNÉ PLATEBNÍ STRÁNKOU E-SHOPU
- Úspěšná platba: zákazník je přesměrován na URL nastavenou v parametru returnurlsuccess
- Zrušení platby zákazníkům: zákazník je přesměrován na URL nastavenou v parametru returnurlcancel
- Neočekávaná chyba: zákazník je přesměrován na URL nastavenou v parametru returnurlerror
Úspěšná platba
POZNÁMKA: Je vysloveně doporučeno, aby obchodník verifikoval Orderhash, který se vrátí ze serveru Teya na returnurlsuccessserver, aby se předešlo pokusům o podvody.
Pokud je platba úspěšná, zákazník je přesměrován na url adresu definovanou v parametru returnurlsuccess s následujícími HTTP POST parametry Použití je na rozhodnutí webu, ale je důležité verifikovat Orderhash, aby se zvalidovala zpráva o úspěšné platbě od společnosti Teya.
|
Názov |
Hodnota |
|
status |
„Ok“ |
|
orderhash |
Podpis, který je vytvořen spojením následujících parametrů s|jako oddělovačem a použitím HMAC SHA256 v kombinaci s tajným klíčem secret key.
orderid|amount|Currency (Secret key je vydán společností Teya je znám pouze obchodníkovi a společnosti Teya) Víc v přílohe: HMAC value creation appendix. |
|
orderid |
Číslo objednávky generováno a zasláno e-shopem platební stránce během inicializace platby. |
|
authorizationcode |
Autorizace platby z Teya. |
|
creditcardnumber |
Částečně maskované číslo platební karty (1234******1234). |
|
step |
Teya zasílá úspěšnou zprávu do e-shopu ve dvou případech. 1. Zákazník zrealizoval úspěšnou platbu a Teya zobrazil zákazníkovi potvrzení o platbě. Důležité: tento URL požadavek přichází ze serveru Teya, není dodán ze strany zákazníka a není ani ve stejné aktivní session. 2. Zákazník stiskl tlačítko ‘Zpět do e-shopu’. Kroky jsou označeny následujícími hodnotami:
Platba: platba byla úspěšně provedena. Pro další informace viz oddíl C.
Potvrzení: Zákazník se vrátil z platební stránky zpět do e-shopu. |
|
ticket |
Pouze v případě, že se k platební stránce přistupovalo s použitím ticketu (viz Sekce Ticket API). Tento parametr bude obsahovat identifikátor použitého ticketu.
|
|
buyername |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyeraddress |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyerzip |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyercity |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyercountry |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyerphone |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyeremail |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyerreferral |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
|
buyercomment |
Pouze v případě, že byla vyžadována registrace (pagetype = 1) |
Zrušení
Ak zákazník stlačí tlačidlo Zrušenie, je presmerovaný na URL uvedenú v parametri returnurlcancel
|
Název |
Hodnota |
|
Status |
"Cancel" |
Neočekávaná chyba
V případě neočekávané chyby je zákazník přesměrován na URL uvedenou v parametru returnurlerror
|
Název |
Hodnota |
|
Status |
„Error“ |
|
errordescription |
Popis chyby pro zákazníka |
|
errorcode |
Kód chyby. |
V tomto případě vrátí testovací verze platební brány následující parametry:
|
Názov |
Hodnota |
|
errordetail |
Detaily chyby. |
|
auditlog |
Dáta z auditu logu. |
Odpověď na oznámení o platbě
Pokud parametr step obsahuje hodnotu „Payment“, tak preferovaná odpověď od e-shopu by měla být XML dokument, který indikuje, že e-shop úspěšně obdržel notifikaci.
Struktura XML by měla být následující:
<PaymentNotification>Accepted</PaymentNotification>Pokud je od e-shopu obdržena tato odpověď, je vytvořen záznam do logu, že e-shop úspěšně obdržel notifikaci o platbě. V opačném případě bude záznam v logu obsahovat pouze informaci, že notifikace o platbě byla zaslána e-shopu.