Specifikation

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

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

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. 

Ordre-ID’et fra dit eget system. Dit ordre-ID bruges som reference mellem dit system og Bambora. 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 og Swedbank kan maksimalt håndtere 12 karakterer.

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 Bambora-administrationen i menuen Indstillinger -> Betalingsvinduet.

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

Navn	Værdi
Deaktiveret	0
Automatisk registrering (default)	1
Gennemtving	2

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
Betalingskort	1
Gavekort	6
Netbank	2
Faktura	3
Mobil	4
Andet	5
ViaBill	7

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.

Navn	Værdi
Deaktiveret (default)	0
Aktiveret	1

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 Bambora, 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).

Navn	Værdi	Betalingsform
Dankort/Visa-Dankort	1	Betalingskort
Visa / Visa Electron	3	Betalingskort
MasterCard	4	Betalingskort
JCB	6	Betalingskort
Maestro	7	Betalingskort
Diners Club	8	Betalingskort
American Express	9	Betalingskort
Forbrugsforeningen	11	Betalingskort
Danske Netbetalinger	13	Netbank
PayPal	14	Andet
Klarna	17	Faktura
SEB (SE)	19	Netbank
Nordea (SE)	20	Netbank
Handelsbanken (SE)	21	Netbank
Swedbank (SE)	22	Netbank
ViaBill	23	ViaBill
Beeptify	24	Andet
iDEAL	25	Netbank
Paii	27	Mobil
Brandts Gavekort	28	Gavekort
MobilePay Online	29	Mobil
Ekspress Bank	31	Other
Masterpass	34	Other

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 Bambora-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.

Navn	Værdi
Automatisk registrering - auto detect (default)	0
Dansk	1
Engelsk	2
Svensk	3
Norsk	4
Grønlandsk	5
Islandsk	6
Tysk	7
Finsk	8
Spansk	9
Fransk	10
Polsk	11
Italiensk	12
Hollandsk	13

Kodningen af dine data. UTF-8 er standardformatet.

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.

Note: CSS skal placeres på et valid domæne der er åbnet for adgang til i vores systemer

Hent vores eksempel på et CSS stylesheet her.

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.

Aktiverer du dette felt, bliver betalingen hævet øjeblikkeligt. Standardværdien er 0, hvilket betyder, at betalingen skal hæves manuelt i din Bambora-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.

Navn	Værdi
Manuelt (default)	0
Aktiveret	1

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.

Navn	Værdi
Deaktiveret (default)	0
Aktiveret	1

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. 

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 Bambora-administration under Indstillinger -> Betalingssystemet. Hvis det ikke er opsat, vil du modtage en fejlmeddelelse. Dette skyldes sikkerhedsmæssige hensyn. 

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

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

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

Navn	Værdi
Asynkront	0
Aktiveret (default)	1

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.

Navn	Værdi
Kvittering i betalingsvinduet (default)	0
Egen kvittering	1

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

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.

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

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

Se eksempler her. 

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.

Navn	Værdi
Deaktiveret (default)	0
Opret nyt abonnement	1
Opdatér abonnement	2

Bemærk
Du kan ikke oprette et abonnement, hvis du bruger en af følgende betalingsmetoder:

• Nordea e-betaling
• Danske Netbetaling
• PayPal

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

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.

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.

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.

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. 

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

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

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.

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

The accountinformation object must be converted to a JSON string and added to the paymentwindow request

Name	Values	Comment
authentication.data	Type: string	Data that documents and support the method used by the customer to authenticate to the account.
authentication.method	Type: string Values: "NoAuthentication", "FederatedId", "ThirdPartyAuthentication", "FidoAuthenticator"	Method used by the customer to authenticate, or log in, to the account.
authentication.timestamp	Type: string	Date and time, in ISO 8601 format, when the customer authenticated.
prior3dsauthentication.data	Type: string	Data that documents and support 3DS authentication of the customer prior to this transaction.
prior3dsauthentication.method	Type: string Values: "FrictionlessAuthenticationOccurredByAcs", "CardholderChallengeOccurredByAcs", "AvsVerified", "OtherIssuerMethods"	3DS authentication method of the customer prior to this transaction.
prior3dsauthentication.reference	Type: string Values: UUID	Reference, as a UUID, to the 3DS authentication of the customer prior to this transaction.
prior3dsauthentication.timestamp	Type: string	Date and time, in ISO 8601 format, when the 3DS authentication happened.
createdindicator	Type: string Value: "NoAccount", "CreatedDuringTransaction", "LessThan30Days", "Between30And60Days", "MoreThan60Days"	Length of time the customer has had the account used with this purchase. This value can be set if the exact account creation date is unknown
createddate	Type: string	The date, in ISO 8601 format, when the customer account used with this purchase was created.
changedindicator	Type: string Values: "ChangedDuringThisTransaction", "LessThan30Days", "Between30And60Days", "MoreThan60Days"	The length of time since the customer account used with this purchased was last changed, including billing or shipping address, new payment account, or new user(s) added. This value can be set if the exact account changed date is unknown.
changeddate	Type: string	The date, in ISO 8601 format, when the customer account used with this purchase was last changed, including billing or shipping address, new payment account, or new user(s) added.
nameidenticaltoshippingaddressname	Type: boolean	Indication if customer/cardholder name is identical to shipping address name.
passwordchangedindicator	Type: string Values: "NoChange", "ChangedDuringThisTransaction", "LessThan30Days", "Between30And60Days","MoreThan60Days"	The length of time since the customer account used with this purchase had a password change or account reset. This value can be set if the exact password change date is unknown.
passwordchangeddate	Type: string	The date, in ISO 8601 format, when the customer account used with this purchase had a password change or account reset.
shippingaddressfirstusedindicator	Type: string Values: "ThisTransaction", "LessThan30Days", "Between30And60Days", "MoreThan60Days"	The length of time since the shipping address used for this purchase was first used by the customer. This value can be set if the exact date is unknown.
shippingaddressfirstuseddate	Type: string	The date, in ISO 8601 format, when the shipping address used for this purchase was first used by the customer.
shippingaddressidenticaltobillingaddress	Type: boolean	Indication if customer billing address is identical to the shipping address.
transactionspast24hours	Type: integer	Transactions, both approved and declined, during the past 24 hours for this customer account, across all payment accounts and methods.
transactionspastyear	Type: integer	Transactions, both approved and declined, during the past year for this customer account, across all payment accounts and methods.
transactionsapprovedpastsixmonths	Type: integer Max value: 999	Approved transactions, or purchases, for this customer account during the last six months
paymentaccountcreatedindicator	Type: string Values: "NoAccount", "DuringThisTransaction", "LessThan30Days", "Between30And60Days", "MoreThan60Days"	The length of time since the payment account used for this purchase was created with the customer account. This value can be set if the exact date is unknown.
paymentaccountcreateddate	Type: string	The date, in ISO 8601 format, when the paymen account used for this purchase was created with the customer account.
provisionattemptspast24hours	Type: integer	The number of tokenize card attempts, successful or not, during the past 24 hours.
suspiciousactivity	Type: boolean	Indication if any suspicious activity, including fraud, has been experienced on the account.

Example

"accountinformation": { "authentication": { "data": "", "method": "No3DSRequestorAuthenticationOccurred", "timestamp": "2016-04-30T00:00:00.000Z" }, "prior3dsauthentication": { "data": "", "method": "FrictionlessAuthenticationOccurredByAcs", "reference": "0a137f3d-9fcf-4040-b6c7-e596cb79d953", "timestamp": "2016-04-30T00:00:00.000Z" }, "createdindicator": "NoAccount", "createddate": "2016-04-30T00:00:00.000Z", "changedindicator": "ChangedDuringThisTransaction", "changeddate": "2016-04-30T00:00:00.000Z", "nameidenticaltoshippingaddressname": True, "shippingaddressfirstusedindicator": "ThisTransaction", "shippingaddressfirstuseddate": "2016-04-30T00:00:00.000Z", "shippingaddressidenticaltobillingaddress": True, "transactionspast24hours": 1, "transactionspastyear": 17, "transactionsapprovedpastsixmonths": 34, "passwordchangedindicator": "NoChange", "passwordchangeddate": "2016-04-30T00:00:00.000Z", "paymentaccountcreatedindicator": "NoAccount", "paymentaccountcreateddate": "2016-04-30T00:00:00.000Z", "provisionattemptspast24hours": 3, "suspiciousactivity": False } 

Type: integer 
Max value: 9999

The minimum number of days between authorizations on the subscription. Use 1 for irregular intervals or if unknown. If no value is supplied we will default the value to 1.

Type: string

The expiration date of the subscription, when no further authorizations will be made, in ISO 8601 format. If no values is supplied we will set a value based on the card expiration date.

The merchantrisk object must be converted to a JSON string and added to the paymentwindow request

Name	Values	Comment
shippingmethod	Type: string Values: "ShipToBillingAddress", "ShipToAnotherVerifiedAddress", "ShipToAddressDifferentThanBillingAddress", "PickUpAtLocalStore", "DigitalGoods", "TravelAndEventTicketsNotShipped", "Other"	Shipping method chosen for this purchase.
deliverytimeframe	Type: string Values: "ElectronicDelivery", "SameDayShipping", "OvernightShipping", "TwoDayOrMoreShipping"	Delivery time frame for this purchase.
deliveryemail	Type: string	The email address used for delivery for purchase that requires electronic delivery.
reorderitemsindicator	Type: string Values: "FirstTime", "Reordered"	Indication if the customer has ordered the item(s) previously.
orderavailability	Type: string Values: "MerchandiseAvailable", "FutureAvailablility"	The order availability for this purchase.
preorderavailabilitydate	Type: string	For a pre-order purchase, the expected date, in ISO 8601 format, when the order will be available.
giftcard.currency	Type: string Length: 3	For prepaid or gift cards purchased, the currency of the cards in ISO 4217 format.
giftcard.amount	Type: integer Min value: 0	For prepaid or gift cards purchased, the total amount in minorunits of the cards.
giftcard.count	Type: integer Min value: 0 Max value: 99	The number of prepaid or gift cards purchased.

Example

"merchantrisk": { "shippingmethod": "ShipToCardholdersBillingAddress", "deliverytimeframe": "SameDayShipping", "deliveryemail": "john.doe@example.com", "reorderitemsindicator": "FirstTime", "orderavailability": "MerchandiseAvailable", "preorderavailabilitydate": "2016-04-30T00:00:00.000Z", "giftcard": { "currency": "SEK", "amount": 123, "count": 1 } } 

Type: string 
Values: "recurring", "cardonfile"

Indicates if the subscription is a recurring payment subscription or a cardonfile subscription. Default is recurring.

Default: "recurring"

Type: string 
Values: "none", "require3d"

The security level to be used for SCA. No value means "no preference" and decision will be up to issuer, whereas "None" means SCA excemption, and "Required3D" means mandate SCA.

Type: string 
Values: "LowValuePayment"

The exemption to be used, if omitted, exemption is not attempted for payment.