Vent venligst ...


Loading...

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

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

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
Ekspress Bank31Other
Masterpass34Other

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

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.

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.

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

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

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 Bambora-administrationen. Husk at bruge kodning (encoding) for at undgå problemer med specialkarakterer. 

hash

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

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.

accountinformation

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


NameValuesComment
authentication.dataType: stringData that documents and support the method used by the customer to authenticate to the account.
authentication.methodType: string
Values: "NoAuthentication", "FederatedId", "ThirdPartyAuthentication", "FidoAuthenticator"
Method used by the customer to authenticate, or log in, to the account.
authentication.timestampType: stringDate and time, in ISO 8601 format, when the customer authenticated.
prior3dsauthentication.dataType: stringData that documents and support 3DS authentication of the customer prior to this transaction.
prior3dsauthentication.methodType: string
Values: "FrictionlessAuthenticationOccurredByAcs", "CardholderChallengeOccurredByAcs", "AvsVerified", "OtherIssuerMethods"
3DS authentication method of the customer prior to this transaction.
prior3dsauthentication.referenceType: string
Values: UUID
Reference, as a UUID, to the 3DS authentication of the customer prior to this transaction.
prior3dsauthentication.timestampType: stringDate and time, in ISO 8601 format, when the 3DS authentication happened.
createdindicatorType: 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
createddateType: stringThe date, in ISO 8601 format, when the customer account used with this purchase was created.
changedindicatorType: 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.
changeddateType: stringThe 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.
nameidenticaltoshippingaddressnameType: booleanIndication if customer/cardholder name is identical to shipping address name.
passwordchangedindicatorType: 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.
passwordchangeddateType: stringThe date, in ISO 8601 format, when the customer account used with this purchase had a password change or account reset.
shippingaddressfirstusedindicatorType: 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.
shippingaddressfirstuseddateType: stringThe date, in ISO 8601 format, when the shipping address used for this purchase was first used by the customer.
shippingaddressidenticaltobillingaddressType: booleanIndication if customer billing address is identical to the shipping address.
transactionspast24hoursType: integerTransactions, both approved and declined, during the past 24 hours for this customer account, across all payment accounts and methods.
transactionspastyearType: integerTransactions, both approved and declined, during the past year for this customer account, across all payment accounts and methods.
transactionsapprovedpastsixmonthsType: integer
Max value: 999
Approved transactions, or purchases, for this customer account during the last six months
paymentaccountcreatedindicatorType: 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.
paymentaccountcreateddateType: stringThe date, in ISO 8601 format, when the paymen account used for this purchase was created with the customer account.
provisionattemptspast24hoursType: integerThe number of tokenize card attempts, successful or not, during the past 24 hours.
suspiciousactivityType: booleanIndication 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 } 

recurringfrequency

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.

recurringexpiration

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.

merchantrisk

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


NameValuesComment
shippingmethodType: string
Values: "ShipToBillingAddress", "ShipToAnotherVerifiedAddress", "ShipToAddressDifferentThanBillingAddress", "PickUpAtLocalStore", "DigitalGoods", "TravelAndEventTicketsNotShipped", "Other"
Shipping method chosen for this purchase.
deliverytimeframeType: string
Values: "ElectronicDelivery", "SameDayShipping", "OvernightShipping", "TwoDayOrMoreShipping"
Delivery time frame for this purchase.
deliveryemailType: stringThe email address used for delivery for purchase that requires electronic delivery.
reorderitemsindicatorType: string
Values: "FirstTime", "Reordered"
Indication if the customer has ordered the item(s) previously.
orderavailabilityType: string
Values: "MerchandiseAvailable", "FutureAvailablility"
The order availability for this purchase.
preorderavailabilitydateType: stringFor a pre-order purchase, the expected date, in ISO 8601 format, when the order will be available.
giftcard.currencyType: string
Length: 3
For prepaid or gift cards purchased, the currency of the cards in ISO 4217 format.
giftcard.amountType: integer
Min value: 0
For prepaid or gift cards purchased, the total amount in minorunits of the cards.
giftcard.countType: 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 } } 

subscriptiontype

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

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

Default: "recurring"

securitylevel

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.

securityexemption

Type: string 
Values: "LowValuePayment"

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