Paraméterek

Frissítve 

FUNKCIÓK ÉS KORLÁTOZÁSOK

  • A Teya biztonságos fizetési oldala beállítható úgy, hogy a kártyabirtokosoktól e-mail-címet, mobiltelefonszámot és lakcímet is kérjen.
    securepay-additional-fields.jpg

  • Ha a skipreceiptpage paraméter értéke 1-re van állítva, a vásárlónál a bizonylatot nem jelenítjük meg, hanem a vásárlót közvetlenül a returnurlsuccess paraméterben megadott URL címre irányítjuk tovább. Ebben az esetben a bizonylatot a kereskedőnek kell megjelenítenie.

  • A kereskedő logója megjeleníthető a fizetési oldalon, ha érvényes URL szerepel a merchantlogo paraméterben. A logót a bal felső sarokban, a kereskedő neve fölött jelenítjük meg. Megjegyezzük, hogy ahhoz, hogy a böngészőben ne jelenjen meg figyelmeztető üzenet, a képet https protokollal kell elérhetővé tenni.

  • A Teya biztonságos fizetési oldalaUTF-8 karakterkódolást használ. Ha a webshop másik karakterkódolást alkalmaz, abban az esetben át kell konvertálni a karaktereket.

copy

publicstaticstringiso8859ToUnicode(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 = newchar[iso.GetCharCount(unibytes,0,unibytes.Length)];​
​ unicode.GetChars(unibytes,0,unibytes.Length,unichars,0);​
​returnnewstring(unichars);​
​}
  • A Teya biztonságos fizetési oldala támogatja a Verified By Visa (VbyV) és MasterCard SecureCode rendszereket, nincs szükség változtatásokra a használatukhoz. Az aktivációhoz vegye fel velünk a kapcsolatot az: ugyfelszolgalat@sTeya.co címre és adja meg benne a weboldal címét és a MerchandID-t.

  • Tizedes jegyeket lehet vesszővel vagy ponttal elválasztva is küldeni.

  • Minden MerchantId és PaymentGatewayId pár egy devizával használható. Több deviza elfogadásához a webshopnak tudnia kell váltani a különböző devizákhoz tartozó MerchantId/PaymentGatewayId párok között. Több MerchantId/PaymentGatewayId használata nem jelent semmilyen plusz költséget.

WEBSHOP ÁLTAL KÜLDÖTT PARAMÉTEREK A FIZETÉSI OLDALNAK

Név

Érték

Merchantid
Kötelező

A Teya által kiadott Kereskedői Azonosító

paymentgatewayid
Kötelező

A Teya által kiadott Fizetési Átjáró Azonosító, amely a fizetési módot azonosítja

Orderid
Kötelező
A webshop által generált megrendelésszám, amely szerepel a hitelkártyás tranzakcióban. Legfeljebb 12 alfanumerikus karakter lehet, a bővített karakterkészlet karakterei nem használhatóak.
reference
Opcionális

A hivatkozási szám bármilyen karaktersor lehet, azonos érték kerül visszaküldésre is. Fő funkciója, hogy külső megrendelés-azonosítóként egyszerűsítse a kereskedői rendszerhez való illeszkedést.

checkhash
Kötelező
Ezt a digitális aláírást az alábbi paraméterek összekapcsolásával, | elválasztó karakterrel, HMAC SHA256 titkosítással a tőlünk kapott secretkey segítségével hozzuk létre a checkhash-t.
MerchantId|ReturnUrlSuccess|ReturnUrlSuccessServer|OrderId|Amount|Currency
(A titkos kulcsot a Teya adja ki, és ezt csak a kereskedő és a Teya ismeri.)
HMAC melléklet
amount
Kötelező

A végösszeg, amely legfeljebb két tizedesjegyet tartalmazhat. Elfogadható értékek például: 350 vagy 54,43 vagy 12.34

currency
Kötelező

A választott pénznem kódja. Lehetséges értékek: GBP, USD, EUR, DKK, NOK, SEK, CHF, CAD, HUF, BHD, AUD, RUB, PLN, RON, HRK, CZK and ISK. Az alapbeállított érték az ISK.

language
Kötelező
A felhasználóknak megjelenített oldalak nyelve. Jelenleg a következő nyelveket támogatjuk: izlandi (IS), angol (EN), német (DE), francia (FR), orosz (RU), spanyol (ES) olasz (IT), portugál (PT), szlovén (SI), magyar (HU), svéd (SE), holland (NL), lengyel (PL), norvég (NO), cseh (CZ), szlovák (SK), horvát (HR), szerb (SR),román (RO), dán (DK), finn (FI) and feröeri (FO).
buyername
Opcionális

A vásárló neve. Ha nincs kitöltve, a vásárló adja meg a fizetési oldalon.

returnurlsuccess
Kötelező

Sikeres fizetés után ide irányítjuk a vásárlót.

returnurlsuccessserver
Feltételes
A szerver erre az URL-re küld értesítést a sikeres fizetésről. Ha ez a paraméter nem szerepel, a returnurlsuccess paraméternél megadott címet használjuk.*
returnurlcancel
Opcionális
Erre a címre irányítjuk a vásárlót, ha a fizetés véglegesítése helyett a Mégsem gombra kattint.
returnurlerror
Opcionális

Váratlan hiba esetén erre az oldalra irányítjuk a vásárlót.

pagetype
Opcionális

Választható paraméter. Ha 1-re van állítva, a kártyabirtokosoknak e-mail-címet, mobilszámot és lakcímet is meg kell adniuk. Ebben az esetben a merchantemail paramétert is be kell állítani, mivel a kártyabirtokosok adatait a kereskedő erre a címre kapja meg.

merchantlogo
Opcionális

Választható paraméter. Ha a merchantlogo paraméter egy kép (100x100 pixel) URL-jét tartalmazza, akkor az a bal oldalon, a kereskedő neve felett megjelenítésre kerül. Figyelem, az IE figyelmeztető üzenetet küld, ha a kép nem SSL protokollon keresztül érhető el.

skipreceiptpage
Opcionális

Választható paraméter. Ha 1-re van állítva, az adásvételről szóló elismervényt nem mutatjuk meg a vásárlónak, a böngészőt azonnal visszairányítjuk a returnurlsuccess paraméterben megadott címre. Ebben az esetben a kártyabirtokos számára a webshopnak kell megjelenítenie az elismervényt.

merchantemail
Opcionális

Választható paraméter. Ha szerepel az üzenetben, a sikeres fizetést követően erre a címre e-mail értesítést küldünk. Az üzenetben szerepelnek a kereskedő és a vásárló adatai, és a kosár tartalma.

buyeremail
Opcionális

Választható paraméter. Ha szerepel az üzenetben, a sikeres fizetést követően erre a címre e-mail értesítést küldünk. Az üzenetben szerepelnek a kereskedő és a vásárló adatai, és a kosár tartalma.

displaymode
Opcionális

Értéke lehet „iframe“, ekkor a fizetési oldal kompaktabb kivitelben jelenik meg, iframe-es megoldásokhoz igazítva. Minimum támogatott szélesség 370px, maximum 755px.

showadditionalbrands
Opcionális

Értéke lehet „false“, ekkor a fizetési oldalon csak a MasterCard, MaestroCard, Visa és Visa Electron logók jelennek meg.

 

A kosár tartalmát a fizetési oldal egy vagy több tételként látja, minden tételtípus új sorba kerül. Minden sor egy adott típusú tételt tartalmaz, mennyiséggel, egységárral és a sor alösszegével. A kosár tételei sorszámozva kerülnek elküldésre. A sorszámok 0-val kezdődnek és egyesével követik egymást. Egy paraméterkészlet a kosár tartalmából egy sornak felel meg.
Kötelező
Itemdescription_x
Kötelező

A tétel leírása, maximális hossza 80 karakter

Itemcount_x
Kötelező

A tétel darabszáma

Itemunitamount_x
Kötelező

A tétel egységára

Itemamount_x
Kötelező

A sor alösszege. itemamount = itemcount * itemunitamount

FIZETÉSI OLDAL ÁLTAL KÜLDÖTT PARAMÉTEREK A WEBSHOPNAK

A fizetési oldal a feldolgozást három különböző esetben zárhatja le::

  • sikeres fizetés, a vásárlót visszairányítjuk a returnurlsuccess paraméterben megadott címre;

  • a vásárló törli a vásárlást, visszairányítjuk a returnurlcancel paraméterben megadott címre;

  • váratlan hiba történt, a vásárlót visszairányítjuk a returnurlerror paraméterben megadott címre.

Sikeres fizetés

FIGYELEM: Erősen ajánlotta kereskedőnek, hogy leellenőrizze a szerverek közt (returnurlsuccessserver paraméterben megadott címre) Teyatól visszakapott orderhash értékét, ezzel elkerülve a csalás lehetőségét.

Ha a fizetési tranzakció sikeres volt, a vásárlót a returnurlsuccess paraméterben szereplő URL címre irányítjuk tovább, az alábbi HTTP POST paraméterekkel. Az adatok felhasználása már a webshop felelőssége, de az orderhash érték ellenőrzése fontos, mert így győződhetnek meg róla, hogy a sikeres fizetésről szóló üzenet valóban a Teyatól érkezett.

Név

Érték

status

Értéke „Ok“

orderhash

Ezt a digitális aláírást az alábbi paraméterek összekapcsolásával, | elválasztó karakterrel, HMAC SHA256 titkosítással a tőlünk kapott secretkey segítségével hozzuk létre a checkhash-t.
orderid|amount|Currency
(A titkos kulcsot a Teya adja ki, és ezt csak a kereskedő és a Teya ismeri.)
HMAC melléklet

orderid

A fizetési tranzakció előkészítése során a webshop által generált, és a fizetési oldalnak elküldött rendelésszám

authorizationcode

A tranzakciót engedélyező kód a Teyatól

creditcardnumber

Részben kitakart hitelkártyaszám (1234-**-1234)

step

A Teya két alkalommal küld sikeres műveletről üzenetet a webshopnak.
Először akkor, amikor a vásárló sikeresen fizetett és a Teya megjelenítette számára a fizetési bizonylatot.Figyelem, ez az URL-kérés a Teya szerveréről érkezik, a vásárló böngészője nem továbbítja, ezért nem is ugyanabban az aktív munkamenetben szerepel.
Másodszor akkor, amikor a vásárló rákattint a választható Vissza a boltba gombra.

A lépéseket az alábbi értékek azonosítják:
„Payment”: A fizetési tranzakció lezárult. További információkért ld. a C szakaszt
„Confirmation”: A vásárló a fizetési oldalról visszatért a webshop oldalára.

ticket

Akkor szerepel, ha a fizetési oldalt fizetési hivatkozás segítségével keresték fel. A paraméter tartalmazza a felhasznált fizetési hivatkozás azonosítóját.

buyername

Csak ha regisztrációt kértek (pagetype = 1)

buyeraddress

Csak ha regisztrációt kértek (pagetype = 1)

buyerzip

Csak ha regisztrációt kértek (pagetype = 1)

buyercity

Csak ha regisztrációt kértek (pagetype = 1)

buyercountry

Csak ha regisztrációt kértek (pagetype = 1)

buyerphone

Csak ha regisztrációt kértek (pagetype = 1)

buyeremail

Csak ha regisztrációt kértek (pagetype = 1)

buyerreferral

Csak ha regisztrációt kértek (pagetype = 1)

buyercomment

Csak ha regisztrációt kértek (pagetype = 1)

Visszamondott fizetés

Ha a vásárló a Mégsem gombra kattint, akkor a returnurlcancel paraméterben megadott címre irányítjuk tovább.

Név

Érték

Status

Értéke "Cancel"

Váratlan hiba

Váratlan hiba esetén a vásárlót a returnurlerror paraméterben megadott címre irányítjuk tovább.

Név

Érték

Status

Értéke „Error“

errordescription

A vásárló számára megjelenített hibaleírás

errorcode

Hibakód

A fizetési oldal tesztváltozata további paramétereket is visszaküld ebben az esetben:

Név

Érték

errordetail

A hiba részletei

A fizetési értesítésre adandó válasz

Ha a step paraméter értéke ’Payment’, a webshop küldhet egy XML dokumentumot, amely jelzi, hogy a webshop sikeresen megkapta az értesítést.

Az XML struktúrája a következő legyen:

copy

<PaymentNotification>Accepted</PaymentNotification>

Amikor ez a válasz beérkezik a webshoptól, az ellenőrzési naplóba bekerül egy feljegyzés, hogy a fizetési értesítést a webshop megkapta. Ellenkező esetben az ellenőrzési naplóba kerülő bejegyzésben csak az szerepel, hogy a fizetési értesítést a webshopnak elküldtük.