valus.cgi
Description
The function valus.cgi is for transactions via Valus . Please note that it is important to include the VAT (value-added-tax) as part of the transaction information, as the fee for Valus payments is determined from the VAT-free amount.
Usage
The general work-flow of the function valus.cgi is as follows:
- The function valus.cgi is called by posting a request to the URL: https://payment.architrade.com/cgi-ssl/valus.cgi
- The DIBS system registers the information and passes it on to the Valus login window
- The customer logs in to the Valus site and arranges for the payment
- Upon successful completion of the payment, the result is relayed to the DIBS server
- The DIBS server returns the answer to the script that called valus.cgi or to the accepturl
Function call
https://payment.architrade.com/cgi-ssl/valus.cgi
Input parameters
The function valus.cgi accepts the following input 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. |
orderid | The shops order number, which may contain a maximum of 50 characters. |
[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. |
[textreply] | If this variable is set (e.g. textreply=true) the DIBS server returns its answer in simple text format . If you are not using the standard DIBS payment window, e.g. using server-to-server requests, this significantly simplifies parsing the answer from DIBS. |
[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. |
[lang] | This parameter determines the language in which the Valus page will be opened. The following values are accpeted: da=Danish, no=Norwegian, en=English. Default language is Danish. |
[taxpercent] | This parameter determines the percentage VAT as an integer, e.g. 25% should be posted as &taxpercent=25. If taxpercent is not included, the default Danish VAT (25% as of 1. march 2005) is used. |
[taxamount] | Instead of using taxpercent it is possible to send the VAT part of the total amount. This is particularly beneficial if part of the order os VAT excempt. The taxamount should be given in smallest possible unit, similarly to amount. |
Note
Please note that it is important to include the VAT (value-added-tax) as part of the transaction information, as the fee for Valus payments is determined from the VAT-free amount. Also note that DIBS only relays the payment, and is not responsible for protection of the data transactions. Please refer to the Valus documentation to ensure that you implement your Valus payment correctly.
