danskenet.cgi
Description
danskenet.cgi is used for transactions via internet-banking. Information concerning the transaction is submitted to the function, which subsequently opens the customer's internet bank. Once the actual payment has been made through the netbank, the browser will return to the web-shop, which will then acknowledge the success or failure of the transaction. Internet bank transactions are immediate, and all such transactions will show up on the DIBS server as either failed or captured.
Usage
Transaction information is submitted to https://payment.architrade.com/cgi-bin/danskenet.cgi
- The browser opens the customers internet bank
- The transaction is made through the internet bank
- The browser returns to the web shop
Function call
https://payment.architrade.com/cgi-bin/danskenet.cgi
Input parameters
The following parameters are valid input to danskenet.cgi:
Parameter | Description |
merchant | The merchant parameter is the shops DIBS identification number. The merchant number is available in the order confirmation email and is a 7-digit integer. |
amount | Amount to be transferred. The amount must be given in smallest possible unit, e.g. cents 100 = USD 1. |
currency | Currency code of the transfer in the ISO4217 form, e.g. 208 for DKK (other ISO4217 currency codes). |
accepturl | The URL that is returned to if the authorisation is accepted. |
declineurl | The URL that is returned to if the authorisation is declined. |
cancelurl | The URL that is returned to if the authorisation is cancelled. |
orderid | The shops order number, which may contain a maximum of 50 characters. |
[timeout] | Specifies the timeout in seconds, which must be greater than 180 seconds (3 minutes). It defaults to 5 minutes. |
[uniqueoid] | If this parameter is set the DIBS server checks the order number to be unique. That is, if a previous transaction contain the same order number, the authorisation is rejected with reason=7. Unless the shop is unable to create unique order numbers it is strongly recommended to enable uniqueoid. NB! order numbers must be less than 50 characters. |
[account] | If several departments in a company use the same acquirer contract it may be beneficial to keep track of the transactions by department. Setting the account parameter enables separation of the transaction by department in the DIBS administration interface. |
Return parameters
If the payment was successful, danskenet.cgi returns the following response parameters:
Parameter | Type | Description |
transact | integer | All transactions are given a unique DIBS identification number, it is a as minimum 6-digit integer , e.g. transact=123456. |
[orderid] | string | The shops original order identification number is returned. |
[?x=<x>&y=<y>...] | optional | Parameters sent to danskenet.cgi as part of the accepturl are returned. |
All values | not a parameter | In the DIBS administration interface it is possible to enable the return of all parameters sent to danskenet.cgi. |
If the transaction was declined, danskenet.cgi returns the following response parameters:
Parameter | Type | Description |
reason | integer | If the transaction is rejected a reason for the rejection is returned. See errorcodes for a list of possible values. |
[?x=<x>&y=<y>...] | optional | All parameters sent to DIBS server as part of the cancelurl is returned. |
All values | not a parameter | In the DIBS administration interface it is possible to enable the return of all parameters sent to danskenet.cgi |
Note
If your website is using frames, it is important to ensure, that the internet bank is opened in a separate window without frames. From experience we have realised that the responses from Danske Bank Netbetaling and Nordea E-payment are not always 100% error-free. For this reason, a set of extra facilities are available, in order to ensure that the order is correctly registered in the web shop. The extra facility must be activated through the DIBS administration interface.
Example
The following example shows part of a standard HTML form that on submission will call danskenet.cgi.
<form action="<link https://payment.architrade.com/cgi-bin/danskenet.cgi>https://payment.architrade.com/cgi-bin/danskenet.cgi" method=POST>
<input type="hidden" name="merchant" Value="12345678">
<input type="hidden" name="amount" Value="2000">
<input type="hidden" name="currency" Value="208">
<input type="hidden" name="orderid" Value="11223344">
<input type="hidden" name="accepturl" Value="<link http://www.minbutik.dk/betal_godkendt.asp>www.minbutik.dk/betal_godkendt.asp">
<input type="hidden" name="declineurl" Value="<link http://www.minbutik.dk/betal_fejl.asp>www.minbutik.dk/betal_fejl.asp">
<input type="hidden" name="cancelurl" Value="<link http://www.minbutik.dk/betal_afbrudt.asp>www.minbutik.dk/betal_afbrudt.asp">
<input type="hidden" name="timeout" Value="500">
<input type="hidden" name="uniqueoid" Value="yes">
<input type="hidden" name="account" value="shop2">
</FORM>
