Technické informácie
Aktualizované
Celá komunikácia medzi e-shopom a zabezpečenou platobnou stránkou Teya je prostredníctvom HTTPS POST.
Production URL: https://securepay.borgun.is/securepay/default.aspx
Sandbox URL: https://test.borgun.is/securepay/default.aspx
Nižšie sú uvedené jednotlivé kroky procesu spracovania platby medzi e-shopom obchodníka a platobnou bránou Teya:
Inicializácia: internetový obchod presmeruje zákazníka na platobnú stránku Teya, zašle informácie o obsahu nákupného košíka a platobnej metóde
Zákazník má dve možnosti:
Zrušiť platbu kliknutím na tlačidlo Zrušiť čím dôjde k prerušeniu platby a automatickému návratu na URL špecifikovanú e-shopom pre tieto účely
Vyplniť dáta o platobnej karte a dokončiť platobnú operáciu
Keď je platba úspešne dokončená, server Teya zašle potvrdenie o platbe do internetového obchodu s návratovou URL poskytnutou e-shopom
Zákazníkovi je zobrazený doklad o úhrade
Po kliknutí na tlačidlo Späť do obchodu je zákazník presmerovaný na URL adresu dodanú pre tento účel e-shopom
Secret key, tajný kľúč, ktorý pozná iba obchodník a platobná brána, sa používa pre overenie, že HTTPS komunikácia prebieha medzi správnymi a oprávnenými stranami. Secret key sa nikdy neposiela priamo cez HTTPS, vždy je pridaný do HMAC podpisu a tak potvrdený nepriamo. Detailný popis, ako sa podpis tvorí nájdete v kapitole Parametre. HMAC podpis si môžete overiť na špecializovaných webových stránkach, napríklad http://www.freeformatter.com/hmac-generator.html
Nižšie je uvedený príklad HTML kódu:
copy
<html xmlns="http://www.w3.org/1999/xhtml" lang="is" xml:lang="is">
<head>
<title>Webshop</title>
</head>
<body>
<form id="form1" action="https://test.borgun.is/SecurePay/default.aspx" method="post">
Merchantid : <input type="text" name="merchantid" value="9275444" /><br>
paymentgatewayid : <input type="text" name="paymentgatewayid" value="16" /><br>
checkhash : <input type="text" size=100 name="checkhash" value="90e2ace99591128b391811a0694bf2d4da8ea960ee088a75d12a415660f46790" /><br>
orderid : <input type="text" name="orderid" value="ORDER1230001" /><br>
currency : <input type="text" name="currency" value="ISK" /><br>
language : <input type="text" name="language" value="IS" /><br>
buyername : <input type="text" name="buyername" value="Agnar Agnarsson" /><br>
buyeremail : <input type="text" name="buyeremail" value="ba@borgun.is" /><br>
returnurlsuccess : <input type="text" size=100 name="returnurlsuccess" value="http://somedomain.is/ReturnPageSuccess?order_id=ORDER1230001" /><br>
returnurlcancel : <input type="text" size=100 name="returnurlcancel" value="http://somedomain.is/ReturnPageCancel.aspx" /><br>
returnurlerror : <input type="text" size=100 name="returnurlerror" value="http://somedomain.is/ReturnUrlError.aspx" /><br>
itemdescription_0 : <input type="text" name="itemdescription_0" value="Dekk" /><br>
itemcount_0 : <input type="text" name="itemcount_0" value="1" /><br>
itemunitamount_0 : <input type="text" name="itemunitamount_0" value="800.00" /><br>
itemamount_0 : <input type="text" name="itemamount_0" value="800.00" /><br>
amount : <input type="text" name="amount" value="800.00" /><br>
pagetype : <input type="text" name="pagetype" value="0" /><br>
skipreceiptpage : <input type="text" name="skipreceiptpage" value="0" /><br>
merchant logo : <input type="text" name="merchantlogo" value="https://www.b-payment.hu/docs/images/logo.jpg" /><br>
merchantemail : <input type="text" name="merchantemail" value="test@borgun.is" /><br>
<input type="submit" name="PostButton" />
</form>
</body>
</html>