Invoice parameters

The invoice acquirers require a special set of parameters. If the recommended input parameters for the DIBS Payment Window are currently implemented, the difference from the current implementation will be minimal

Examples

<form type="button" method="post" action="https://payment.dibspayment.com/dpw/entrypoint">
    <input type="hidden" name="acceptReturnUrl" value="https://domain.com/accept"/>
    <input type="hidden" name="amount" value="12625"/>
    <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="testmail@domain.com"/>
    <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" />
    <input type="hidden" name="oiRow2" value="1;kg;Foam roll;53;10000;2500" />
</form>

Essential

The following parameters are mandatory when doing invoice payments since the invoice companies need orderinformation in order to send the corresponding invoice.

ParameterTypeDescription

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. Please refer to the Order information page or more information.

oiRow(1..n) *

String. Max 1024 characters

Order information data row. Used to add order information to the purchase to be shown in the DIBS Administration. Please refer to the Order information page or more information.

organizationnumber

String

Invoice specific parameter - organization number (orgno).

socialSecurityNumberStringInvoice specific parameter - social security number (ssn).

yourRef

String

The customer's order reference.

*: These parameters are always validated by DIBS on invoice payments.

Optional

The following parameters can optionally be parsed to the DIBS Payment Window along with the optional parameters from standard parameters when conducting invoice payments. Note that shippingAddress from standard parameters is used if acquirer supports delivery to address specified by merchant.

ParameterTypeDescription
commentsstringThe place for any additional comments.
distributionTypeString. Only the value 'PAPER' is allowedInvoice specific parameter - type of distribution of invoices to customer.
exchangeRateDoubleUsed with invoice when creating order information.
invoiceFeeVATnumberInvoice Fee VAT (e.g. "25%" is expressed as "2500"), must be filled if invoiceFee is present.
invoiceFeenumberInvoice specific parameter - invoice fee (expressed in minor unit of currency). Should not be sent with zero "0" amount.
merchantNamestringMerchant's name to be displayed in the invoice window. Default is read from the merchants Dibs agreement.
ourRefstringThe shop's order reference.
shippingFeestringShipping Fee (expressed in smallest unit of currency). Should not be sent with zero "0" amount.
ShippingFeeVATstringShipping Fee VAT (e.g. "25%" is expressed as "2500"), must be filled if shippingFee is present. 
statCodeAlphaNumStringTextual code used for labelling orders, e.g., the code of the seller who handled the order. Used for statistical purposes.
statCodeNumLongNumerical code used for labelling orders, e.g., the code of the seller who handled the order. Used for statistical purposes.

 

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