Dibs Payment Window

Parameter

Type

Description

Amount of transaction in smallest unit. Used to validate against prices in structured orderInformation.

The URL of the page to be displayed if the purchase is approved. Typically a page within the merchant's shop site. The parameters are returned to this URL using POST. HTTPS is not mandatory but it is highly recommended.

Note: The URL cannot be an IP-address or contain parameters. Example. ”?X=4&Y=2” The URL’s have to be ”clean”.

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.

List of oitypes availble:
QUANTITY, DESCRIPTION, AMOUNT, VATAMOUNT or VATPERCENT, ITEMID, UNITCODE

Please notice:
The VAT amount must be specified and declared, either as VATPERCENT or VATAMOUNT .

This parameter is deprecated. For compatibility reasons it will still be included in MAC calculation if sent, but it is otherwise not used.

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.

Customer's billing first name.

Customer's billing last name.

Customer's billing street address. If acquirer doesn't support getAddress but requires user to enter some billing address information, this parameter can be used to prepopulate values on IW 1st page/or set values on merchant's/legacy system's side. If acquirer returns appropriate value in getAddress/placeOrder - value from acquirer will override value sent in this parameter.

Customer's billing street address (continued).

Customer's billing postal code

Customer's billing postal place (city, town, etc).

Customer's email address. Can be passed along to the acquirer if applicable.

Note: That this parameter is mandatory when using the polish wire transfer service Przelewy24.

Example:
<input type="hidden" name="billingEmail" value="my@email.com"/>

Customer's mobile number. Can be passed along to the acquirer if applicable.

Note that we only accept a row of digits and spaces optionally prepended by a '+'

Customer's first name.

Customer's last name.

Customer's shipping street address. If acquirer supports delivery to address specified by merchant (different from registered on acquirer), this parameter should be used.

Customer's shipping street address (continued).

Customer's shipping postal place (town, city, etc.).

Shipping Fee (expressed in smallest unit of currency).

Shipping Fee VAT (e.g. "25%" is expressed as "2500"), must be filled if shippingFee is present.

Invoice specific parameter - social security number (ssn).

Merchant's name to be displayed. Default is read from the merchants Dibs agreement.

Invoice fee (expressed in minor unit of currency).

Invoice Fee VAT (e.g. "25%" is expressed as "2500"), must be filled if invoiceFee is present.

Invoice specific parameter - organization number (orgno).

The place for any additional comments.

Invoice specific parameter - type of distribution of invoices to customer. If distributiontype is set to EMAIL then billingEmail must be set.
Accepted values  EMAIL or PAPER and must be in upper case.

Used with invoice when creating order information.

Numerical code used for labelling orders, e.g., the code of the seller who handled the order. Used for statistical purposes.

Textual code used for labelling orders, e.g., the code of the seller who
handled the order. Used for statistical purposes.

 The shop's order reference.

The customer's order reference.

Campaign code. Indicates campaign used in part payments/installments.

Customer's yearly salary – specified in ore or cents.