Dibs Payment Window
- Order information.
The order information is divided into three groups; types, names, and data. The order information is shown on the DIBS Payment Window via a link on the page. When clicked it shows the order information in a layer. The types decides the styling (left/right justified) of the order information. The names provided are shown as the headers. ITEMID is for your product code - if you have a such - corresponding to the product described in the order row. UNITCODE is for the unit description of your product, like pcs, boxes, crates, etc.
Note: These parameters are mandatory when using invoices as payment methods.
Parameter | Type | Description |
| oiTypes | String. Max 1024 characters | Order information column types must be in upper case. The data should be delimited by a semicolon. The order is significant and should match the other rows. |
VATAMOUNT as a specific amount must be stated in the smallest currency unit. The amount corresponds to one (1) quantity of the item. If declaring VATAMOUNT you must calculate the VAT amount and pass the amount through to DIBS.
Example:
|
<input type="hidden" name="oiTypes" value="QUANTITY;UNITCODE;DESCRIPTION;AMOUNT;ITEMID;VATAMOUNT" /> <input type="hidden" name="oiNames" value="Items;UnitCode;Description;Amount;ItemId;VatAmount" /> <input type="hidden" name="oiRow1" value="1;pcs;ACME Rocket Roller skates\; ultra fast;1000;98;25" /> <input type="hidden" name="oiRow2" value="1;pcs;ACME Band Aid;1000;99;25" /> <input type="hidden" name="oiRow3" value="1;pcs;Some description;1000;45;25" /> |
The total VATAMOUNT for these orderrows is 0,75 when added to the total amount (1000) the result is 1075 = 10,75.So the amount that must be passed to Dibs is 1075.
VATPERCENT as a percentage must be multiplied by 100. E.g. the value 2500 corresponds to 25%. If declaring VATPercent DIBS automatically calculates the VAT amount based on the oirows amount + VAT percentage submitted.
Example:
|
<input type="hidden" name="oiTypes" value="QUANTITY;UNITCODE;DESCRIPTION;AMOUNT;ITEMID;VATPERCENT" /> <input type="hidden" name="oiNames" value="Items;UnitCode;Description;Amount;ItemId;VatPercent" /> <input type="hidden" name="oiRow1" value="1;pcs;ACME Rocket Roller skates\; ultra fast;1000;98;2500" /> <input type="hidden" name="oiRow2" value="1;pcs;ACME Band Aid;1000;99;2500" /> <input type="hidden" name="oiRow3" value="1;pcs;Some description;1000;45;2500" /> |
The VATPERCENT is 25% when added to the total amount (1000) the result is 1250 = 12,50.So the amount that must be passed to Dibs is 1250.
Parameter | Type | Description |
| oiNames | String. Max 1024 characters | Order information column names. The data should be delimited by a semicolon and the order is significant and should match the other rows. The names provided are shown as the headers when displaying the order information in the payment window. |
| oiRow(1..n) | String. Max 1024 characters | Order information data row (oirow1, oirow2, oirow3 etc). The data should be delimited by a semicolon and the order is significant and should match the other rows. Semicolons that are part of the order information are to be escaped with a backslash. oirow1=1;pcs;ACME Rocket Roller skates\; ultra fast;100;98;25 oirow2=1;pcs;ACME Band Aid;100;99;25 oirow3=1;pcs;Some description;100;45;25 |
Form example and screenshot.
|
<form action="https://sat1.dibspayment.com/dibspaymentwindow/entrypoint" method="post"> |
