FlexWin (Method 1)

Invoice Payments Introduction

Available invoice payment methods
The invoice payment methods described in the following table are currently available in the DIBS invoice product portfolio.

Invoice in DIBS FlexWin

DIBS Flexwin offers the possibility to use invoice as payment method. Apart from the standard Flexwin integration certain additional input parameters specific for the invoice payments are needed, as well as some additional FlexWin return values needs to be handled. Below you will find information on how to create an invoice, a list of the invoice input parameters and return values, important notes and code examples.

Generating the invoice

To generate an invoice, structured order information must be posted to DIBS in an XML data parameter as part of the post to DIBS Flexwin. This information applies only to invoice transactions. The required contents of the XML data parameter is described further down.

General Invoice Information

Invoice is a payment method, which issues bills as a way of paying. In DIBS FlexWin the customer has the choice of using an invoice payment method instead of using e.g. a credit card or a netbank. If the customer chooses invoice, additional information is collected in the DIBS invoice payment flow, e.g. social security number, postal code. In addition to the order information , this additional information is forwarded to the invoice service provider. The invoice service provider then makes an evaluation of the customer and the order, and decides whether to accept the order request or not.

If accepted, the shop receives payment for the order from the invoice service provider, while the customer eventually pays the invoice service provider. So in effect, the customer gets a credit for a number of days, while the shop gets its payment more or less immediately. Customer credit period and shop payment interval depends on the agreement between the shop and the invoice service provider.

Payment behavior

In Flexwin invoice behaves similar to using a net-bank, in that Flexwin informs the customer, that he is about to be transferred to the DIBS invoice payment flow, called the invoice window. The invoice window communicates with the invoice service provider, and upon completion, the customer is returned to Flexwin and finally back to the shop.

Invoice payments features a number of extra parameters sent along in the post to Flexwin, some mandatory, some optional. The parameters are described on the parameter list page further down.

Customer address in callback

When a customer pays by Invoice using the DIBS invoice payment flow, the customer’s registered address is fetched and the customer is credit rated. At first, the customer must enter his social security number and for many invoice payment methods also e.g. the postal code is entered. These data are verified and the complete registered address for the customer may be displayed in the DIBS invoice payment flow and is ultimately returned back to the shop through the callback. The address returned in the callback from DIBS must be used for shipment of goods (if not anything else is agreed upon between the shop and the invoice service provider), even if the customer has indicated a different delivery address in the user registration when the order was initiated in the web shop.

Please notice: To receive the customer’s address from DIBS in the callback, please ensure that all return values are activated in your DIBS Administration menu Set up / Return Values. Normally, it is a requirement from theinvoice service providers that that shipment of goods is made to the customers registered address and not any other address.