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 | 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. |
| [md5key] | This variable enables a MD5 key control of the values received by DIBS. This control confirms that the values sent to DIBS has not been tampered with during the transfer. The MD5 key is calculated as:
MD5(key2 + MD5(key1 + "merchant=<merchant>&orderid=<orderid>¤cy= <currency>&amount= <amount>")) 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. |
| [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
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 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 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, except credit card details. |
If the transaction was declined solo_payment.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 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, except credit card details. |
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="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" value="http://www.minbutik.dk/betal_godkendt.asp">
<input type="hidden" name="declineurl" value="http://www.minbutik.dk/betal_fejl.asp">
<input type="hidden" name="cancelurl" value="http://www.minbutik.dk/betal_afbrudt.asp">
<input type="hidden" name="uniqueoid" value="yes">
<input type="hidden" name="account" value="shop2">
</form>