solo_payment.cgi
Description
solo_payment.cgi is used for payment through Dansk Nordea SOLO-Payments only. The transaction information is sent to solo_payment.cgi, which opens the customer's Nordea internet bank. The transaction is processed through the internet bank, and the transaction information is returned to the web-shop. Please note, that payment through Nordea E-payment is instant, and the transaction will therefore show up as captured in the DIBS administration interface.
Usage
- Transaction information is submitted to the URL:
https://payment.architrade.com/cgi-ssl/solo_payment.cgi - The transaction is processed through the customers internet banking
- The transaction information is returned to the web-shop
Function call
https://payment.architrade.com/cgi-ssl/solo_payment.cgi
Input parameters
solo_payment.cgi accepts the following parameters:
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 (see 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. |
md5key | This variable enables an MD5 key control of the parameters received by DIBS. This control confirms that the parameters sent to DIBS have not been tampered with during the transfer. The MD5 key for solo_payment.cgi is calculated as: MD5(key2 + MD5(key1 + “merchant=<merchant>&orderid=<orderid>
where key1 and key2 are shop specific keys available through the DIBS administration interface, and + is the concatenation operator. NB! MD5 key check must also be enabled through the DIBS administration interface in order to work. Further details on MD5 key control. |
[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
Upon a successful payment solo_payment.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 solo_payment.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 solo_payment.cgi |
If the transaction was declined solo_payment.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 solo_payment.cgi. |
Note:
If your website is using frames it is important to ensure, that the Nordea internet bank is opened in a separate window without frames. From experience we have realised that the responses from Danske Bank Netbetaling, BG Netbetaling and Nordea E-payement are not always 100% error-free. For this reason, a set of extra facilities is 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 for calling solo_payment.cgi.
<form action="<link https://payment.architrade.com/cgi-ssl/solo_payment.cgi>https://payment.architrade.com/cgi-ssl/solo_payment.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" <br /> value="http://www.minbutik.dk/betal_godkendt.asp">
<input type="hidden" name="declineurl" <br /> value="http://www.minbutik.dk/betal_fejl.asp">
<input type="hidden" name="cancelurl" <br /> value="http://www.minbutik.dk/betal_afbrudt.asp">
<input type="hidden" name="uniqueoid" value="yes">
<input type="hidden" name="account" value="shop2">
</form>
