Betalingssystem - teknisk implementering

Opsætning af gatewayen.

1. Forretnings type kode & forretnings nummer

Første gang du logger ind på gatewayen, skal du opsætte den ved at gå ind under menupunktet "indstillinger".

De to vigtigste værdier er ?Forretnings type kode? og ?Forretnings nummer?

Disse numre får du fra PBS lige så snart din indløsningsaftale er oprettet.

 

2. Valuta opsætning

Det næste punkt er valg af valuta.

Hvis ikke du ønsker en fast valuta, har du muligheden for at definere en variable valuta i din betalingsform. Dette gøres ved at indsætte et ekstra input felt med typen ?hidden?.

<input type="hidden" name="currency" value="208"> 

208 står for dansk valuta, i henhold til ISO4217 standarden.

En liste med isokoderne for de forskellige valutaer, kan findes her.

3. Accept og Decline URL

Accept og decline url er de to adresser gatewayen henviser til, hvis transaktionen er henholdsvis gennemført eller fejlet. De to adresser kan , ligesom valuta, defineres som hidden felter i betalingsformen, hvis du har brug for en lidt mere dynamisk opsætning.

<input type="hidden" name="accepturl" value="http://www.mitdomæne.xx/accepturl.html">
<input type="hidden" name="declineurl" value="http://www.mitdomæne.xx/declineurl.html"> 

Vær opmærksom på at hvis du definere dem i din betalingsform, så vil disse overskrive de værdier du har indtastet i betalingsinterfacet.

4. Proxy opsætning.

Proxy opsætningen er hvor du bestemmer hvilke domæner der må bruges igennem SSLproxy?en. Proxy?en skal bruges på kortintastningssiden, samt accept og decline siderne.

Proxyen bruges ved at sætte en URL foran sin orginale adresse, hvorefter indholdet på siden vil være krypteret.

https://betaling.123hotel.dk/proxy/p.php/http://www.mydomain.dk/betalingsform.html

Før proxyen vil godtage dit domæne, skal du tilføje domænet til dine proxy-indstillinger.

Skriv domænet i feltet og tryk [opret]

Domænet indbefatter kun ?domæne.xx? uden www foran.

Vær opmærksom på at SSLproxy?en ikke understøtter sessions, samt cookies

Billeder og andre filer skal placeres lokalt på webserveren for at sikre at den krypterede forbindelse ikke brydes.

Korrekt angivelse: 
<IMG src="/billeder/dankortikon.gif"> 

Forkert angivelse:
<IMG src="http://www.domæne.dk/billeder/dankortikon.gif"> 

5. Opsætning af betalingsform på din hjemmeside.

Download eksempel af betalingform

Før en transaktion kan finde sted skal du oprette en betalingsform, hvor din kunde kan indtaste sine kortoplysninger.

Betalingsformen skal udformes på følgende måde.

 <form method="post" action="https://betaling.123hotel.dk/auth.php" onSubmit="Submit.disabled = true">  

shopid finder du i oprettelses mailen, eller under indstillinger i betalingsgatewayen. ( skal udfyldes )

   <input type="hidden" name="shopid" value="2004091637643"> 

amount skal indeholde beløbet på transaktionen. Beløbet skal skrives i minor unit ( øre ) ( skal udfyldes )

   <input type="hidden" name="amount" value="500">  

orderid er ordrenummeret på købet i din shop. ( skal udfyldes )

   <input type="hidden" name="orderid" value="25402"> 

Betalingstypen ( skal udfyldes )

   <input type="hidden" name="paytype" value="creditcard"> 

orderidprefix kan bruges hvis du har flere shops under samme indløsningsaftale. På den måde kan du se forskel på hvor transaktionerne kommer fra.

   <input type="hidden" name="orderidprefix" value="TES">

currency er et valgfrit felt. Bruges kun hvis du ønsker dynamisk valuta som beskrevet i de forrige afsnit. 

   <input type="hidden" name="currency" value="208">  

accepturl er et valgfrit felt.

   <input type="hidden" name="accepturl" value="http://www.123hotel.dk/accepturl.php">  

declineurl er et valgfrit felt.

   <input type="hidden" name="declineurl" value="http://www.123hotel.dk/declineurl.php">  

   Kortnummer    <input type="text" name="cardnum" size="30"><BR> 
   Udløbs måned  <input type="text" name="emonth" size="2"> 
   Udløbs år     <input type="text" name="eyear" size="4"><BR> 
   CVC           <input type="text" name="cvc" size="3"><BR><BR>

		
      <input type="submit" value="Gennemfør betaling"> 
   </form>  

6. Fejlkoder

Hvis en transaktion fejler, bliver der på samme tid returneret en fejlkode fra betalings gatewayen.

1. Transaktionen blev ikke godkendt
2. Mulig snyd
3. Kommunikations fejl
4. Kort udløbet
5. Intern fejl
6. Invalid Transaktion
7. System fejl
8. Forkert forretningsnummer
9. Kortet eksistere ikke
10. Kort længen er for kort.
11. Transaktion kan ikke gennemføres igennem denne terminal
12. Kortejeren har ikke rettigheder til at gennemføre denne transaktion.
13. Kortnummeret eksistere ikke

Fejlkoderne er kun til eget brug, og må ikke fremvises for køberen.