Skip to main content


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

You'll find detailed specifications for each parameter under Specification.

NameValuesCommentDefault valueMandatory
merchantnumberFind your merchant number in the menu Settings -> Payment system in the ePay 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.

See specification for more
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
windowstate1 = 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
mobile0 = 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 ePay administration under Settings -> Payment window.1No
paymentcollection0 = Customer choice
1 = Payment cards
2 = Home Banking
3 = Invoice
4 = Mobile
5 = Other
7 = ViaBill
lockpaymentcollection0 = Disabled
1 = Enabled
If paymentcollection is not 0, this is used to lock the payment collection.0No
paymenttypeSee specification for moreSpecify 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
language0 = 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
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
splitpayment0 = Disabled
1 = Enabled
Please read this before using splitpayment.

Split payment is supported by Nets/Teller, Clearhaus and ePay. You only need to specify the Parameter when you have Nets/Teller as acquirer
instantcallback0 = Asynchrony
1 = Instantly
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
ownreceipt** 0 = Disabled**
1 = Enabled
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 ePay 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. See specification for moreNo
backgroundcolorHEX color code without #. Only used for = 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
invoiceType: JSON stringThe invoice object as a JSON stringNo
phonenumberType: string
Max-length: 8
A Danish mobile number without the international country code, it will be prefilled in the MobilePay window when doing the actual MobilePay payment.No
accountinformationType: JSON stringThe accountinformation object as a JSON stringNo
recurringfrequencyType: 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.No
recurringexpirationType: stringThe 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.No
merchantriskType: JSON stringThe merchantrisk object as a JSON stringNo
subscriptiontypeType: string
Values: "recurring", "cardonfile"
Indicates if the subscription is a recurring payment subscription or a cardonfile subscription used for making MIT (Merchant Initiated) transactions. Default is recurring."recurring"No
securitylevelType: 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.No
securityexemptionType: string
Values: "LowValuePayment"
The exemption to be used, if omitted, exemption is not attempted for payment.No