Site integration checklist

Before going live, there are a number of things you need to take care of. An agreement has to be signed and certain information will have to be available to the customer in the webshop. This section provides you with a checklist for everything that needs to be done before a webshop can go live, from signing the DIBS agreement to the final touch on the receipt

Find your platform with your DIBS ID. If you need guidance in the integration process, please refer to our Starter guide

Site integration examples

<form type="button" method="post" action="">
    <input type="hidden" name="acceptReturnUrl" value=""/>
    <input type="hidden" name="amount" value="125"/>
    <input type="hidden" name="currency" value="208"/>
    <input type="hidden" name="merchant" value="123456789" />
    <input type="hidden" name="orderId" value="my_orderid-1234"/>
    <input type="hidden" name="billingAddress" value="Kings str. 21"/>
    <input type="hidden" name="billingAddress2" value="6th"/>
    <input type="hidden" name="billingEmail" value=""/>
    <input type="hidden" name="billingFirstName" value="Andy"/>
    <input type="hidden" name="billingLastName" value="Testname"/>
    <input type="hidden" name="billingMobile" value="+99123456789"/>
    <input type="hidden" name="billingPostalCode" value="98765"/>
    <input type="hidden" name="billingPostalPlace" value="Denmark"/>
    <input type="hidden" name="MAC" value="4a25050c229ab07ed61a2c3ef454f597246eda96f5b1512fec90dcb74f761a70"/>
    <input type="hidden" name="oiTyPes" value="QUANTITY;UNITCODE;DESCRIPTION;ITEMID;AMOUNT;VATPERCENT" />
    <input type="hidden" name="oiRow1" value="1;pcs;ACME band;427;100;2500" />

Payment flow

Sending and receiving information

First of all the shop has to be able to open the payment window and handle the response. The integration with the payment solution will need at least the following features:

  1. Be able to post data to the DIBS Payment Window, opening the window and allowing for card data to be typed.
  2. Handle the response data sent to the return page or callbackUrl. Two methods of receiving the response from DIBS are possible:
    • Redirect: The outcome of the payment is returned along with the customer
    • Server-to-server: The response is sent directly to the shop system in a "callback", without the need of the customer returning to the acceptReturnUrl. This has the advantage that the shop gets feedback that a payment has gone through even if the customer closes the browser before reaching the shop.



Website and order information

Prepare your website for site inspection

The website should fulfill the requirements stated on our site inspection page. This includes showing the correct logos, make website contact details visible, state terms & conditions and show an order receipt both at the page the customer reaches after the purchase and in a mail sent to the customer automatically.

Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00