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 | 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. |
| 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. |
| [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 and is recommended. |
| [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. |
| [lang] | This parameter determines the language in which the page will be opened. The following values are accepted: da=Danish en=English de=German es=Spanish fi=Finnish fo=Faroese fr=French it=Italian nl=Dutch no=Norwegian pl=Polish (simplified) sv=Swedish kl=Greenlandic Default language is Danish. |
| [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. |
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.