Please wait ...


Loading...

Parameters

This is an overview of available parameters. Default values are set in bold.

You'll find detailed specifications for each parameter under Specifications

NameValuesCommentDefault valueRequired
merchantnumberFind your merchant number in the menu Settings -> Payment system in the Bambora administrationYes
currencySee a list of currenciesUse either the currency code name or the numeric code, e.g. DKK or 208.Yes
amountAmount in minor unitsIf subscription is enabled, this can be set to 0.Yes
orderidAlphanumeric. a-Z 0-9. Max. 20 characters. For further information see: http://epay.bambora.com/en/specification#261
Orderid is your reference from your shopsystem to our administration. It is also passed on to the acquirer. The use of special characters is not recommended, though they might be accepted.No
windowstate

1 = Overlay
2 = iframe
3 = Full screen
4 = Integrated payment form

Overlay, iframe and the integrated payment form will only work correctly if you're using the simple integration. Please note that when using the integrated payment form, you can only accept payment cards (i.e. paymentcollection =1).1No
mobile

0 = Disabled
1 = Auto detect
2 = Force mobile

Apply this parameter to use the mobile window. Please notice that not all payment methods are supported by the mobile window.1No
windowidThis defines which window to use. Available windows are found in the Bambora administration under Settings -> Payment window.1No
paymentcollection0 = Customer choice
1 = Payment cards
2 = Home Banking
3 = Invoice
4 = Mobile
5 = Other
7 = ViaBill
0No
lockpaymentcollection0 = Disabled
1 = Enabled
If paymentcollection is not 0, this is used to lock the payment collection.0No
paymenttypeSee all payment typesSpecify which payment type logos to show. Use a comma (,) to separate multiple payment types. If you don't want to accept a specific payment type, please contact our support team.No
language

0 = Auto detect
1 = Danish
2 = English
3 = Swedish
4 = Norwegian
5 = Greenlandic
6 = Icelandic
7 = German
8 = Finnish
9 = Spanish
10 = French
11 = Polish
12 = Italian
13 = Dutch


1No
encodingUTF-8No
cssurlUse this to override parts of the payment window v2 stylesheet.No
mobilecssurlThis is used to override a URL to a custom theme for the mobile window.No
instantcapture0 = Manual
1 = Enabled
0No
splitpayment0 = Disabled
1 = Enabled
Please read this before using splitpayment. Split payment is supported by Nets/Teller, Clearhaus and Bambora. You only need to specify the Parameter when you have Nets/Teller as acquirer
0No
instantcallback0 = Asynchrony
1 = Instantly
1No
callbackurlMust be a valid http or https URL. Only port 80 and 443 can be used. Accept parameters will be appended.No
accepturlMust be a valid http or https URL Accept parameters will be appended.No
cancelurlMust be a valid http or https URL.No
ownreceipt0 = Disabled
1 = Enabled
0No
ordertextOnly text is accepted. HTML will be stripped.No
groupMax. 100 characters.No
descriptionMax. 1024 characters.No
hashThis is the MD5 string of all parameters combined with the Bambora secret key.Only if MD5 is enabled
subscription0 = Disabled
1 = Enabled
2 = Update subscription
subscriptionid is returned with the accept and callback parameters. If this parameter is enabled, amount can be set to 0.0No
subscriptionidWhen subscription = 2, subscriptionid must be the ID of the subscription you want to update.No
subscriptionnameMax. 100 characters.No
mailreceiptUse this to receive an email with information about the payment when it is completed. This is NOT for your customer's order confirmation.No
googletrackerTypically in the form UA-XXXXXXX. Click here for details.No
backgroundcolorHEX color code without #. Only used for windowstate = 1 and windowstate = 2A7A7A7No
opacity0-100Only used for windowstate = 150No
declinetextOverwrites the system decline text.No
iframeheightOnly available for windowstate = 2. Set the iframe height in pixels (px).780No
iframewidthOnly available for windowstate = 2. Set the iframe width in pixels (px).778No
timeoutDefines a time span in which the payment can be completed. The value is specified in minutes, e.g. 15 for 15 minutes.
No