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 | Shop identification. The Merchant number appears in the e-mail received from DIBS during registration with DIBS or on your contract. Your merchant number can also be retreived by contacting your respective DIBS support department below. Denmark Norway Sweden |
| amount | The smallest unit of an amount, eg. cent for EUR , øre for Danish crowns, Example: 1,00 EUR = 100 or 1,50 EUR =150 |
| accepturl | The URL of the page to be displayed if the purchase is approved. |
| cancelurl | The same as declineurl |
| orderId | The shop’s order number for this particular puchase. It can be seen later when payment is captured, and will in some instances appear on the customer’s bank statement (both numerals and letters may be used). |
| declineurl | The URL of the page to be displayed if the purchase is denied. |
| currency | Currency specification as indicated in ISO4217 where the EUR is no. 978. Either the numeric or alphabetic code is accepted. Also see our list of currencies. |
| [uniqueoid] | If this field exists, the orderid-field must be unique, i.e. there is no existing transaction with DIBS with the same order number. If such a transaction already exists, payment will be rejected with reason=7. Unless you are unable to generate unique order numbers, we strongly urge you to utilize this field.Note: Order numbers can be composed of a maximum of 50 characters (DIBS automatically removes surplus characters) and that uniqueoid is therefore unable to work as intended if order numbers consisting of more than 50 characters are used. |
| [timeout] | Specifies the timeout in seconds, which must be greater than 180 seconds (3 minutes). It defaults to 5 minutes. |
| [account] | If multiple departments utilize the company’s acquirer agreement with the acquirer, it may prove practical to keep the transactions separate at DIBS. An ”account number” may be inserted in this field, so as to separate transactions at DIBS. |
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 at minimum a 6-digit integer, e.g. transact=123456. If "split" is used, then "transact" is replaced by "transact1", "transact2", etc. |
| [orderid] | string | The shop's original order identification number is returned. |
| [?x= | 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, except credit card details. |
If the transaction was declined, danskenet.cgi returns the following response parameters:
Parameter | Type | Description |
| reason | integer | If the transaction is rejected, it returns with a reason for the rejection. Please refer to error codes for a list of possible values. |
| [?x= | 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, except credit card details. |
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="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="www.minbutik.dk/betal_godkendt.asp">
<input type="hidden" name="declineurl" Value="www.minbutik.dk/betal_fejl.asp">
<input type="hidden" name="cancelurl" Value="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>