ePay Payment Window

ePay Payment Window – now officially known as Bambora Payment Window – is a payment solution which supports a wide portfolio of payment methods. This article will explain how to integrate a Dynamicweb solution with an existing ePay/Bambora Payment Window account.

Please note that this payment solution requires a public URL during both testing and production. This provider supports TLS 1.2.

To setup Bambora Payment Window:

  1. Go to Settings > Ecommerce > Orders > Payments and add a new payment method
  2. Select the ePay Payment Window provider
  3. Fill in the relevant parameters (Figure 2.1)
Figure 2.1 Parameters

One set of parameters is used to connect to the Bambora Payment Window account and configure basic behavior:

Parameter

Use

Notes

Merchant

Merchant number supplied by Bambora.

 

You should have one for test and one for production.

Bambora docs

Window ID

Window IDs are used if you have several payment windows and want to specify a specific one for this shop.

Bambora docs

Group

Associate payment with a specific payment group (in Bambora)

Bambora docs

Auth Mail

Send receipt to this email. Not for customer receipts.

Bambora docs

Auth SMS

Send receipt text to this email. Not for customer receipts.

May be deprecated

Instacapture

Enable/disable instacapture

Bambora docs

Split payment

Enable/disable split payment

Bambora docs

MD5 key

Add MD5 encryption

 

Encoding

Set encoding

Bambora docs

A second set of parameters is used to configure the payment window design:

Parameter

Use

Notes

CSS URL

Override standard CSS

Bambora docs

Mobile CSS URL

Override standard mobile CSS

Bambora docs

Order text

Set order text in Bambora

Bambora docs

Description

Set order description in Bambora

Bambora docs

Google tracker

Add Analytics tracking ID

Bambora docs

Background colour

Set background color

Bambora docs

Opacity

Set opacity of background color

Bambora docs

Decline text

Override default decline text when a payment is declined

Bambora docs

A third set of parameters is used to control the payment window behavior:

Parameter

Value

Notes

Window state

Select a window state:

  • Full screen
  • Overlay

Bambora docs

Post mode

Select a post mode:

  • Auto
  • Render template

 

Post template

A template

If Post mode set to Render template this template will be used to post payment data to Bambora.

Cancel template

A template

Shown if payment is cancelled

Error template

A template

Shown if an error happens

Finally, these parameters can be used to tweak the standard behavior:

Parameter

Value

Notes

Card fee added by ePay

Adds Bambora card fees to an order

Must also be enabled in Bambora administration

Payment timeout

Defines a time span in minutes in which the payment can be completed

 

Add Mobilepay to payment options

Adds paymenttype 29 to the options

Bambora docs

Use Mobilepay as only payment option

Makes paymenttype 29 the only payment option

Bambora docs

If you want to use fees (your customers are charged for the cost of payment) you need to enable Transaction fees in the ePay administration in Settings > Payment window. A list of transaction fees is also available from this page in the administration.

ePay automatically inserts test credentials in the test transaction window when you're using a test merchant ID. You can also use the following card numbers for testing purposes:

  • Dankort
    • Card number: 4444444444444000
    • Expiration date: Optional (mm / yy)
    • CVC: Optional
  • VISA
    • Card number: 3333333333333000
    • Expiration date: Optional (mm / yy)
    • CVC / kontrolcifre: Optional
  • MasterCard
    • Card number: 5555555555555000
    • Expiration date: Optional (mm / yy)
    • CVC / kontrolcifre: Optional

  • "Incorrect pbsResponse and epayresponse code received from ePay".
    Error code -1003 occurs when you’ve not opened up for your IP address in the ePay administration. Log on to your ePay administration, and go to API/Webservices > Access. Here you can add the IP address on which your system is located.