Technical documentation for implementing integrated payment form

Here your can read about how to set-up your own payment html form in your internet shop. There has to be created 3 new pages in your internet shop.

1. A page for the payment HTML form
2. A page which your customers are directed to as the payment is approved ( acceptURL )
3. A page which your customers are directed to as the payment is declined ( declineURL )
4. A page which the ePay system calls the internet shop system (directly) as the payment is approved( callbackURL )

Before you start

Remind that the payment HTML form has to be showed on a HTTPS encrypted page using a SSL certificate.
We recommend that ePay relay-script is used.

If you want to use your own SSL certificate your company MUST be PCI certified.

Notice: It is not allowed to run the payment HTML form in a frame or iframe as the padlock is not available down in the right corner of the browser.

Page 1: set-up of own HTML payment form

If you are using ePay’s relay-script it is important that all of your pages on the HTML payment form are relative. Is this a problem alternative you can use the ePay Standard Payment Window instead.

Before your tag there must be implemented a form. This form must include parameters, which are transmitted by POST to the ePay auth-script. You can see the parameters to set-up in the documentation below in the section

input: It is important the form is set-up as the example below.

Page 2: AcceptURL

This is the page in your internet shop, which the customers are directed to as the payment is approved. You set the URL in the parameter

acceptURL

. In the documentation’s section

output acceptURL - you can see parameters which ePay sends to the accept-page (GET).

On the accept-page you must show a receipt to your customer. 

Page 3: DeclineURL

This is the page in your internet shop, which the customer is directed to as the payment is declined. You must set-up the URL in the parameter

declineURL

CallbackURL

To ensure that your internet shop receives an answer from ePay as the payment is approved you can also use the callbackURL. As the payment is approved ePay calls an URL (server to server) at the same time as the customer is sent to the acceptURL. This feature must be used if it is important that your ordering system is updated as the payment is approved.

Own parameters

Do you have a need for sending your own parameters to our auth-script; you can in the HTML payment form set the form hidden fields (user_attr_1 – user_attr_20). The parameters will be sent as GET parameters to the acceptURL or the declineURL whatever the payment was approved or declined. It is important that your own parameters do not conflict with existing ePay parameters.

Example

<input type="hidden" name="accepturl" value="http://www.yourdomain.dk/path/document.html?parameter1=something&parameter2=something_else" />

or

<input type="hidden" name="user_attr_1" value="value of own attribute" />

You can use the parameter ”paymenttype” to control the type of payment you would like to use. Is this parameter not defined the payment will be handled as ordinary credit card to PBS and VISA/MasterCard. Is the payment of type 3D secure you must set the paymenttype to the value of 1, 2 or 3 (read more about this in the documentation).

If the payment is of type eDankort the payment type must be set to the value of 20, Nordea: 21, Danske Bank: 22 and BG Bank: 23.

To maintain your customers sessions on the website of your internet shop you must use the field http_cookie.

Technical documentation

1. Input parametre
2. Output acceptURL
3. Output declineurl
4. Output callbackURL