FAQ – Integration af Bambora

Når du har modtaget din indløsningsaftale og er klar til at modtage betalinger på din webshop, skal du videresende den til Bambora på support@bambora.com. Så aktiverer vi din konto i vores system.

Du skal selv udskifte dit testforretningsnummer med dit produktionsforretningsnummer i dit shopsystem. Brug parameteren merchantnumber eller indstillingerne til betalingsmodulet, hvis du bruger et open source-system.

Bemærk ved Clearhaus: Du skal tilføje Bambora som bruger i din Clearhaus-administration, så vi kan hente din API-nøgle. Se her, hvordan du gør.

Dit forretningsnummer er dit aftalenummer med din indløser. Du kan finde det på din Bambora-administration under Indstillinger -> Betalingssystemet og på din indløsningsaftale.

Der er to typer forretningsnumre: Et testforretningsnummer, som udelukkende bruges til testbetalinger, og et produktionsforretningsnummer, som bruges til rigtige betalinger.

Læs mere her: "Jeg har fået min indløsningsaftale. Hvad gør jeg nu?"

Du finder fejlkoderne i din Bambora-administration her:

ssl.ditonlinebetalingssystem.dk/admin

Fejlkoderne er delt op i to grupper: fejlkoder fra Nets og fejlkoder fra Bambora. Fejlkoder fra Nets har en større værdi end 0, mens fejlkoder fra Bambora er mindre end 0 (kendetegnet ved et minustegn foran tallet).

Fejlkoder fra Nets
Findes i administrationen i menuen Support -> Fejlkoder fra Nets/Teller.

Fejlkoder fra Bambora
Findes i administrationen i menuen Support -> Systemfejlkoder.

Hvis dit domæne blokeres, når du prøver at gennemføre en betaling, skyldes det, at domænet ikke er registreret i Bambora-administrationen. Du kan ændre dit domæne i administrationen i menuen Indstillinger -> Betalingssystemet.

Hvis du allerede har registreret dit domæne, skal du se artiklen Hvorfor får jeg fejlen “Referring domain is not allowed/URL not allowed for relaying”? nedenunder.

Som standard kan du bruge ét domæne, men du kan købe flere. Kontakt Bambora, hvis du ønsker flere domæner. 

Fejlmeddelelsen “Referring domain is not allowed” eller "URL not allowed for relaying" opstår, når det domæne, som du prøver at gennemføre en betaling fra, ikke stemmer overens med det domæne, der er koblet på din Bambora-konto. Det kan du ændre på din Bambora-administration i menuen Indstillinger -> Betalingssystemet. 

Hvis du åbner betalingsvinduet fra eksempel.dk, så skal eksempel.dk registreres på din Bambora-administration. 

Hvis du åbner betalingsvinduet fra et subdomæne, f.eks. betalings.eksempel.dk, skal du stadig bare indtaste eksempel.dk i Bambora-administrationen. Det skyldes, at systemet godkender alle subdomæner til eksempel.dk.

De findes i din Bambora-administration i menuen Support -> Valutakoder og på vores hjemmeside her.

MD5 er en sikkerhedskode, der sikrer din forretning mod datasvindel. 

Du skal bruge parameteren hash til at lave et MD5-stempel, som består af værdien af alle de parametre, du sender til Bambora + din MD5-nøgle. Værdierne skal skrives i den rækkefølge, som parametrene sendes. MD5-nøglen er en hemmelig kode, som du selv finder på. Den skal indtastes i din Bambora-administration under Indstillinger -> Betalingssystemet.

Her er et eksempel på, hvordan det sættes op.

Et transaktionsnummer eller transaktions-ID er en unik reference på din betaling. Den oprettes i Bamboras system, når betalingen autoriseres.

Som standard blokerer Google Chrome pop-up-vinduer. Derfor åbner Bamboras betalingsvindue ikke, når du prøver at gennemføre et køb på en webshop. 

Følg nedenstående guide for at tillade pop-ups i Chrome:

1. Når betalingsvinduet ikke åbner, klikker du på dette ikon.
2. Så kommer denne besked.
3. Klik på ‘Always allow pop-ups’ og på ‘Done’. 
4. Opdater siden (tryk på F5-tasten), så åbner betalingsvinduet. 

Ja. Du skal dog være opmærksom på, at accepturl, cancelurl og callbackurl skal være på et gyldigt domæne. Callbacks ikke kan ramme localhost, da callbackurl skal være offentlig tilgængelig. 

Det domæne, der peger på localhost, skal opsættes inde på din Bambora-administration under Indstillinger -> Betalingssystemet. Hvis ikke domænet er opsat, får du fejlen ”Referring domain not allowed”.

Accepturl og cancelurl kan ikke sættes til localhost. Opsæt i stedet dit udviklingsmiljø på f.eks. dev.mitdomaene.dk.

Du skal bare skrive til os, at du gerne vil have åbnet for et domæne mere og bekræfte prisen på DKK 49 om måneden. Så kobler vi et domæne mere på din konto.

Hvis du benytter overlay-vinduet, så bliver hængelåsen ikke vist. Dog foregår kommunikationen stadig over en krypteret og sikker forbindelse.

For at dine kunder ser en hængelås, skal du enten benytte fuldskærmsvisning eller selv installere et SSL-certifikat. Kontakt din hostingudbyder for nærmere information om installering af SSL-certifikat.

Det er en god ide at placere et Bambora-logo på dit website, så dine kunder kan se, at det er et sikkert og trygt sted at handle.

Logoet skal linke til www.bambora.com. Du kan hente Bamboras logo i en samlet fil her.

Du kan vise Bamboras logo sammen med en standardtekst:

DANSK VERSION

SIKKER BETALING
Bambora er PCI-certificeret af
Visa/MasterCard, og al kommunikation foregår
krypteret via en sikker forbindelse.

ENGLISH VERSION

SECURE PAYMENT
Bambora is PCI certified by Visa/MasterCard 
and all communication is encrypted.

Det styrer du fra din Bambora-administration under Indstillinger -> Betalingsvinduet. Her klikker du på ’Ret indstillinger’ ved dit betalingsvindue. På den næste side kan du uploade dit logo.

Bemærk, at billedet maksimalt må fylde 10 MB, og at formatet skal være JPG/JPEG, GIF eller PNG. Den optimale størrelse er 175 x 71 pixels.

Ved at bruge vores webservice kan du behandle dine betalinger fra dit shopsystem uden at logge ind på Bambora-administrationen for at gøre det. En webservice kaldes også et API (Application Programming Interface).

Du kan læse mere om vores webservice, og hvordan du bruger den, her. Husk at opsætte adgang til den IP-adresse, som dit shopsystem befinder sig på, under API/Webservices -> Adgang på din Bambora-administration.

Hvis du bruger et open source-system på din shop, kan du oftest aktivere API fra Bambora-modulet. Klik her for at se, hvilke moduler der har indbygget API.

Hvis du har flere shops/domæner og vil åbne forskellige betalingsvinduer (f.eks. med forskellige logoer) fra dine domæner, skal du bruge parameteren windowid (Window ID) til at styre, hvilket betalingsvindue der åbnes fra det pågældende domæne.

Læs mere om parameteren windowid.

Magento

Bruger du Magento, skal du opdatere til betaversion 2.5.7 af Bambora-modulet. Du kan herefter styre Window ID fra indstillingerne til modulet.

WooCommerce

Bruger du WooCommerce, skal du rette indstillingerne til Bambora-modulet. Sæt indstillingen Window ID til det ID, som dit vindue har (default = 1).

Hvis det ikke virker, skal du fjerne værdien helt og gemme. Herefter tilføjer du den igen og gemmer indstillingerne.

I nogle tilfælde virker tilbage-knappen ikke betalingsvinduet. Det skyldes, at betalingsvinduet er opbygget med postback. Da det kræver en ny postback at vise betalingsvinduet korrekt, kan man ikke trykke tilbage i browseren.

Du kan bruge følgende metode til at forhindre, at din kunde trykker tilbage:

1. Lav en opsætning, så kunden vælger betalingsmetode på din side, og ikke i betalingsvinduet.

2. Brug parametrene paymentcollection og lockpaymentcollection, så betalingsvinduet åbner med en bestemt betalingsmetode, som kunden ikke kan ændre. 

Så vælger kunden betalingsmetoden på din side, og valget kan ikke ændres i betalingsvinduet.

Vi skal bruge din API-nøgle fra Clearhaus for at aktivere din Bambora-konto. 

Clearhaus sender af sikkerhedsmæssige grunde ikke API-nøglen på mail. Derfor skal du fra din Clearhaus-administration tilføje Bambora som bruger.

Det gør du sådan:

1. Åbn din Clearhaus-administration.
2. Klik på ’Account’ i toppen.
3. Her kan du invitere brugere ved ’Invite’.
4. Brug e-mailadressen support@epay.dk og skriv blot Bambora som bruger.

Når vi har fået invitationen, logger vi på din Clearhaus-administration og henter din API-nøgle.

Vi aktiverer så din konto ved Bambora og sender dig en mail, når det er sket.