Vent venligst ...


Loading...
Teknisk Dokumentation
Hjemmesider

Specifikation

Denne sektion beskriver de tilgængelige parametre enkeltvis.

merchantnumber

Obligatorisk
Du har to forretningsnumre: ét til test (testbetalinger) og ét til produktion (rigtige betalinger). 

currency

Obligatorisk
Denne parameter accepterer både valutanummer og valutakode. F.eks. 208 eller DKK. Se en liste med gyldige valutaer her.

amount

Obligatorisk
Beløbet i mindste enheder. Eksempelvis skal danske kroner (DKK) skrives i “øre”, og britiske pund (GBP) skrives i ”pennies”. Beløbet DKK 104,95 skal skrives 10495. Ved valutaer uden mindste enheder skal beløbet 95 skrives som 95.

Denne parameter accepterer ikke separatorer (f.eks. punktum (.) som tusindseparator).    

amount kan sættes til 0, hvis subscription er aktiveret. 

orderid

Ordre-ID’et fra dit eget system. Dit ordre-ID bruges som reference mellem dit system og ePay. Alle tal fra 0-9 og bogstaver fra a-Z er tilladt. 

Bruger du Swedbank, bliver ikke-numeriske karakterer fjernet. 

Bemærk
Nets/Teller kan som udgangspunkt maksimalt håndtere 9 karakterer i ordrenummeret.
Bambora (tidligere Euroline) og Swedbank kan maksimalt håndtere 12 karakterer.

windowid

Definerer, hvilket betalingsvindue du vil bruge. Hvis du har flere shops/domæner og ønsker at åbne forskellige vinduer (f.eks. med forskellige logoer eller indstillinger) fra dine domæner, skal du bruge windowid til at styre, hvilket vindue der åbnes fra det pågældende domæne.

Du kan se dine betalingsvinduer og tilføje nye fra ePay-administrationen i menuen Indstillinger -> Betalingsvinduet.

mobile

Denne parameter bruges til at aktivere det mobile betalingsvindue. Bemærk, at ikke alle betalingsformer er understøttet af det mobile betalingsvindue.

NavnVærdi
Deaktiveret0
Automatisk registrering (default)1
Gennemtving2

paymentcollection

paymentcollection er en gruppering af forskellige betalingsformer. Ved at sætte en værdi åbnes betalingsvinduet med denne betalingsform som standard.

Kundens valg (default)0
Betalingskort1
Gavekort6
Netbank2
Faktura3
Mobil4
Andet5
ViaBill7

lockpaymentcollection

Hvis du definerer en værdi for paymentcollection, kan du fastlåse denne værdi. Det betyder, at kunden ikke kan ændre betalingsformen. Du kan bruge det, hvis du f.eks. kun vil acceptere betaling med betalingskort. I det tilfælde skal du sætte paymentcollection til 1 og lockpaymentcollection til 1.

NavnVærdi
Deaktiveret (default)0
Aktiveret1

paymenttype

Denne parameter definerer, hvilke betalingsformers logoer du vil vise. Du kan vise flere logoer ved at separere værdierne med komma (,). Hvis du f.eks. vil vise Dankort, Visa og MasterCard, skal du bruge følgende værdier: 1,3,4. Kunden kan stadig betale med en betalingsform, selvom du ikke viser logoet. Kontakt ePay, hvis du ikke vil acceptere betaling med en bestemt betalingsform.

paymenttype bliver ignoreret, hvis paymentcollection er defineret og betalingsformen (ved paymenttype) ikke stemmer med den valgte betalingsform (ved paymentcollection).

NavnVærdiBetalingsform
Dankort/Visa-Dankort1Betalingskort
Visa / Visa Electron3Betalingskort
MasterCard4Betalingskort
JCB6Betalingskort
Maestro7Betalingskort
Diners Club8Betalingskort
American Express9Betalingskort
Forbrugsforeningen11Betalingskort
Danske Netbetalinger13Netbank
PayPal14Andet
Klarna17Faktura
SEB (SE)19Netbank
Nordea (SE)20Netbank
Handelsbanken (SE)21Netbank
Swedbank (SE)22Netbank
ViaBill23ViaBill
Beeptify24Andet
iDEAL25Netbank
Paii27Mobil
Brandts Gavekort28Gavekort
MobilePay Online29Mobil

language

Definer sproget, som betalingsvinduet vises i. Hvis du bruger automatisk registrering (auto detect), og det fundne sprog ikke er tilgængeligt, skifter den automatisk til engelsk.

Hvis du ikke definerer en værdi, er standardindstillingen dansk.

Du kan selv redigere i teksterne, som vises i betalingsvinduet. Det gør du fra din ePay-administration ved at klikke på Indstillinger -> Betalingsvinduet og så vælge vores oversættelsesværktøj. Når oversættelsesværktøjet åbner, skal du oprette et sprog (klik på 'Create language') og tilknytte sproget til et land. Vælg derefter ’Edit translations’ ud for sproget i menuen. Du får så vist sprogfilerne, og du kan ændre alle oversættelserne for det valgte sprog.

NavnVærdi
Automatisk registrering - auto detect (default)
0
Dansk
1
Engelsk2
Svensk3
Norsk4
Grønlandsk5
Islandsk6
Tysk7
Finsk8
Spansk9
Fransk10
Polsk11
Italiensk12
Hollandsk13

encoding

Kodningen af dine data. UTF-8 er standardformatet.

cssurl

Denne kan overskrive dele af betalingsvinduets stylesheet. For at bruge parameteren skal du definere en gyldig http- eller https-adresse til den ønskede stylesheets placering.

Hent vores eksempel på et CSS stylesheet her.

mobilecssurl

Brug denne til at opsætte dit eget tema i mobilvinduet. 

Vores mobiltema kan hentes her. Start med at importere den i ThemeRoller. Modificer temaet, og hent det ned. Upload *.css-filen til din hjemmeside, og sæt mobilecssurl til offentlig lokation. Mobilvinduet åbner så med dit eget tema.

instantcapture

Aktiverer du dette felt, bliver betalingen hævet øjeblikkeligt. Standardværdien er 0, hvilket betyder, at betalingen skal hæves manuelt i din ePay-administration. 

Du må kun aktivere denne parameter, hvis kunden også får sin vare med det samme.

Bemærk
Når du bruger instantcapture ved betalinger til Teller, sker der to ting: Betalingen autoriseres og hæves. Nogle gange kan hævningen fejle, hvilket medfører, at transaktionen afvises helt.

NavnVærdi
Manuelt (default)0
Aktiveret1

splitpayment

Hvis en ordre afsendes over flere gange, kan denne parameter aktiveres. Du kan så hæve dele af betalingen, hver gang du afsender en del af bestillingen. Det hedder delhævning. 


Det er indtil videre kun indløserne Nets og Teller, der understøtter delhævning. De øvrige indløsere vil med tiden også understøtte funktionen.


Bemærk
Hvis splitpayment er aktiveret, men din indløser ikke understøtter delhævning, bliver transaktionen behandlet som en normal betaling, der ikke kan hæves over flere gange. 

Du kan ikke bruge splitpayment ved 3D Secure-betalinger.

NavnVærdi
Deaktiveret (default)0
Aktiveret1

accepturl

Din accepturl er den adresse, som dine kunder sendes til, når deres betaling er godkendt og betalingsvinduet er lukket, eller når ownreceipt er sat til 1. 


cancelurl

Din cancelurl er den adresse, dine kunder sendes til, hvis betalingsvinduet lukkes. Kan kun bruges, hvis windowstate er 3.


Bemærk

Domænet skal tilføjes i din ePay-administration under Indstillinger -> Betalingssystemet. Hvis det ikke er opsat, vil du modtage en fejlmeddelelse. Dette skyldes sikkerhedsmæssige hensyn. 

callbackurl

Din callbackurl bruges til at opdatere ordresystemet. Det kaldes også (I)PN eller (Instant) Payment Notification. Når betalingen er godkendt, kalder ePay denne URL, som var det en accepturl (server til server).

Bemærk
Domænet skal tilføjes i din ePay-administration under Indstillinger -> Betalingssystemet. Hvis det ikke er opsat, vil du modtage en fejlmeddelelse. Dette skyldes sikkerhedsmæssige hensyn.

instantcallback

Hvis du bruger callbacks, kan du med denne parameter bestemme, hvornår kaldet til din callbackurl skal ske.

NavnVærdi
Asynkront0
Aktiveret (default)1

ownreceipt

Ved brug af ownreceipt sendes kunden øjeblikkeligt til din accepturl ved gennemført betaling. Kvitteringssiden i betalingsvinduet springes over. For at bruge denne parameter skal accepturl først defineres.

NavnVærdi
Kvittering i betalingsvinduet (default)0
Egen kvittering1

ordertext

Denne definerer en tekst, som vises i betalingsvinduet, mens betalingen gennemføres, og når kvitteringen vises. Teksten vil fremgå på udskriften af kvitteringen. 

group

Angiv, hvilken gruppe betalingen skal knyttes til. Parameteren er en streng, der kan indholde a-Z og 0-9. Hvis gruppen ikke eksisterer, bliver den automatisk oprettet, når du begynder at bruge parameteren.

Klik her for at læse mere om grupper.

description

Dette er en beskrivelse af betalingen. Beskrivelsen kan ses i ePay-administrationen. Husk at bruge kodning (encoding) for at undgå problemer med specialkarakterer. 

hash

Denne bruges til at lave et MD5-stempel, som valideres af ePay for at sikre din forretning mod datasvindel. Stemplet skal skabes ud fra værdierne af alle parametre, der sendes til ePay, kombineret med din hemmelige nøgle.

Se eksempler her

subscription

Hvis denne parameter er aktiveret, oprettes et abonnement. Værdien kan sættes til 0, hvis betalingen ikke skal gennemføres, men du blot vil oprette et nyt abonnement. Et unikt subscriptionid bliver returneret til din accepturl og callbackurl.

Når du vil autorisere en ny transaktion på abonnementet, skal du gøre det via vores abonnementsbetalinger.

Bemærk
Denne funktion kræver en særskilt aftale hos din indløser. Kontakt din indløser for at høre mere.

NavnVærdi
Deaktiveret (default)0
Opret nyt abonnement1
Opdatér abonnement2


Bemærk
Du kan ikke oprette et abonnement, hvis du bruger en af følgende betalingsmetoder:
  • Nordea e-betaling
  • Danske Netbetaling
  • PayPal

subscriptionid

subscriptionid sættes til det subscription-ID, som skal opdateres, når subscription = 2.

subscriptionname

Denne kan bruges sammen med subscription. Hvis subscription er sat til 1, kan du specificere et navn eller en reference. Hvis du ikke definerer en værdi, bliver værdien fra orderid brug som subscriptionname.

mailreceipt

Brug denne parameter, hvis du vil modtage en e-mail med information om betalingen, hver gang der gennemføres en betaling i din shop. Den er IKKE beregnet til din kundes ordrebekræftelse.

googletracker

Dette felt bruges til at spore dine ordrer med Google Analytics. Typisk bruges formatet UA-XXXXX-X.

Sporingen bliver i Analytics tracket som disse sider:

/epay-close.html => Betalingsvinduet lukkes.
/epay-decline.html => Betaling blev afvist - kunden kan prøve igen.
/epay-accept.html => Betalingen blev godkendt.
/epay-payment.html => Kunden sendes til betalingsvinduet.
/epay-selectpayment.html => Kunden vælger betaling.

Du skal opsætte ’cross domain auto linking’, for at sporingen virker korrekt. Det kan du læse om her: https://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain#autolink

Hvis du vil spore dine konverteringer (e-handelssporing), anbefaler vi, at du bruger ownreceipt til at sende kunden til din egen kvitteringsside.

backgroundcolor

Med denne parameter kan du styre baggrundsfarven i betalingsvinduet, når windowstate er enten 1 eller 2. Er windowstate lig 1, bliver baggrundsfarven påvirket af opacity-parameteren. 

opacity

Definer baggrundsfarvens gennemsigtighed, når windowstate er 1. Vælg en værdi mellem 0 og 100.

declinetext

Angiv en tekst her, hvis du vil overskrive teksten, der vises, når en betaling afvises.

timeout

Definer et tidsrum, hvori det er muligt at gennemføre betalingen. Værdien af timeout sættes til det ønskede antal minutter, f.eks. "15" for 15 minutter.

invoice

Parameteren invoice bruges til at håndtere fakturabetalinger. Klik her for at læse mere om fakturadata.