Order information in DIBS

DIBS offers the option to store order information on the DIBS system, e.g. what the order contains, who ordered it, where to deliver it etc. This information must be sent to the DIBS system along with the authorisation information (i.e. in the authorisation process). The order information is subsequently available in the DIBS administration interface. Hence, all order information may be kept and accessed on the DIBS system.

There are two models for transferring order information to the DIBS server; a simple model and a more complex model.

Simple model

In the simple method, all order information is summarised in one text string and posted to the DIBS in the parameter ordertext. For instance as in the following example: 

<input type=”hidden” name=”ordertext” value=”1 strawberry @ 25 cent <br>
2 cherries @ 10 cents each”>

In the DIBS administration interface this entry will show up as: 

1 strawberry @ 25 cent
2 cherries @ 10 cents each

Complex model

The Integration package is a prerequisite for using complex order information in DIBS. In the more complex method each piece of information is submitted via its own parameter. This allows the information to be more detailed and specific. Generally there are three types of order information available:

• Delivery information, e.g. name, address, email, delivery number etc.
• Product information,  e.g. product number,  amount, description, price etc.
• Price information, e.g. VAT, delivery costs, discounts etc.

These informations are posted to the DIBS server as the parameters delivery, ordline, and priceinfo, respectively.

For example, the delivery information should be posted as:

<input type=”hidden” name=”delivery1.Name” value=”John Smith”>
<input type=”hidden” name=”delivery2.Address” value=”27 Main rd., 9999 Neverland">
<input type=”hidden” name=”delivery3.Comment” value=”Send fast please”>

The above example will show up in the DIBS administration interface as:

Name: John Smith
Address: 27 Main rd., 9999 Neverland
Comment: Send fast please

In other words, the parameter name determines the name of the order information, and the order in which the information is shown.

The format for order information (ordline) is slightly different as more information is required. For ordline the parameter must include two numbers, both the number of the row and the column. The maximum total number of parameters is 9. Or as the following example shows:

<input type=”hidden” name=”ordline0-1” value=”Product number”>
<input type=”hidden” name=”ordline0-2” value=”Amount”>   
<input type=”hidden” name=”ordline0-3” value=”Price”>
<input type=”hidden” name=”ordline1-1” value=”999”>
<input type=”hidden” name=”ordline1-2” value=”2”>
<input type=”hidden” name=”ordline1-3” value=”80”>
<input type=”hidden” name=”ordline2-1” value=”1”>
<input type=”hidden” name=”ordline2-2” value=”5”>
<input type=”hidden” name=”ordline2-3” value=”125”>

This example will show up in the DIBS administration interface as:

Finally, the price information parameter format is similar to the delivery information in its format,

<input type=”hidden” name=”priceinfo1.Deliverycosts” value=”36”>
<input type=”hidden” name=”priceinfo2.VAT” value=”27”>

This information will show up below the product listing in the DIBS administration interface as: 

Deliverycosts    36
VAT              27

Please note: The order information submitted is for the shops own use, and is not in any way parsed by DIBS or used for the credit card transaction. In other words, it is the parameter amount alone that determines the amount to be drawn from the customers credit card. Also note that the order information parameters must be numbered consecutively, e.g. the parameter delivery1 must be followed by delivery2. Otherwise the DIBS system will only read the first parameter.