E-Invoicing

E-Invoicing is a highly flexible MultiSafepay BNPL method that gives you full control of credit management, the collection flow, and customer communications in multiple languages. Optionally, leverage MultiSafepay's powerful customer credibility score technology to reduce fraud.

Read how E-Invoicing can benefit your business on multisafepay.com

SupportsDetails
CountriesWorldwide
CurrenciesEUR
ChargebacksNo
Partial captureYes
Payment pagesYes (current and deprecated versions)
RefundsYes: Full, partial, and API refunds, and discounts
Second ChanceYes

Payment flow

This diagram shows the flow for a successful transaction. Click to magnify.

E-invoicing payment flow

Payment statuses

The table below sets out the order status and transaction status for payments and refunds.

DescriptionOrder statusTransaction status
The customer credibility score (if requested) is in progress. You can still cancel.InitializedInitialized
MultiFactor has authorized the transaction.
You can no longer cancel. You can only refund.
CompletedInitialized
āš ļø Note: Manually change the order status to Shipped.
You must ship to receive payment.
ShippedInitialized
MultiSafepay has collected payment.CompletedCompleted
MultiFactor declined the transaction.DeclinedDeclined
The transaction has been cancelled.Void/CancelledVoid/Cancelled
The customer didn't complete payment, or the order expired.ExpiredExpired
Refunds: Refund initiated.InitializedInitialized
Refunds: Refund complete.CompletedCompleted

Activation

  1. Sign in to your MultiSafepay dashboard .
  2. To activate the payment method for:
  • All sites, go to Settings > Payment methods.
  • A specific site, go to Sites, and then click the relevant site.
  1. Select the checkbox for the payment method, and then click Save changes.

šŸ’¬ Support: If the payment method isn't visible in your dashboard, email [email protected]

Integration

API

See API reference ā€“ Create order > BNPL order.

Example requests

For example requests, on the Create order page, in the black sandbox, see Examples > E-Invoicing direct/redirect.

Ready-made integrations

Supported in all ready-made integrations (direct and redirect).

Testing

See Testing payment methods ā€“ BNPL methods.


User guide

Addresses

Different billing and shipping addresses are supported. Email a request to [email protected]

Batches

You can generate E-Invoicing transactions in batches for subscription payments.

How to batch transactions for subscriptions
  1. Sign in to your MultiSafepay dashboard .
  2. Go to E-Invoicing > Batches.
  3. Upload a file in .xls, .xlsx or .csv format.
  4. Follow the templates in your MultiSafepay dashboard.

Cancellation

You can cancel the invoice order before shipment or after partial shipment.

How to cancel an order

In your dashboard

  1. Sign in to your MultiSafepay dashboard .
  2. Go to Transactions > Transaction overview, and then click the relevant transaction.
  3. On the Transaction details page, click Cancel.
  4. Add a description of what happened with the order, and then click Complete.
    The order status changes to Void and the transaction status to Cancelled.

Via the API

See API reference ā€“ Update or cancel order.


Collection flow

You can fully customize the collection flow.

How to customize collection flows
  1. Sign in to your MultiSafepay dashboard .

  2. Go to E-Invoicing > Workflows.

  3. Click Create new.

  4. Under Settings, you can select a previous template, if relevant.

  5. In the Description field, enter the name of this collection flow.

  6. From Drag and drop, drag and drop the relevant collection flow elements under Drop elements here.

  7. For each element, in the Communication settings dialog, you can:

    • Rename the communication flow in the Description field.
    • Request manual approval before the communication is sent.
    • Adjust the transaction fee by a fixed amount or percentage.
    • Set how many days the payment link is valid for.
    • Schedule when the next step in the collection flow will take place.
    • Specify the day of the week and time of day to send the communication.
  8. Click Save.


Communications with the customer

You can fully customize your communications with the customer, including via email, letter (within the EU), SMS, and WhatsApp.

MultiSafepay can also append a PDF invoice (with your custom formatting) to the communication (except for SMS) on request. Email [email protected]

How to customize communications
  1. Sign in to your MultiSafepay dashboard .
  2. Go to E-Invoicing > Actions.
  3. Click Add new template.
  4. Select the delivery method: Email, SMS, or letter.
  5. In the Description field, enter the name of the template.
  6. From the Language list, select the template language: Dutch, English, French, German, Italian, Portuguese, Russian, Spanish.
  7. In the From address field, enter the email address you want the communication to appear to be sent from.
  8. In the From name field, enter your company name.
  9. In the Subject field, enter the communication subject line.
  10. Edit the text either in the Body plain field, or if you know HTML and CSS, you can fully customize the content and layout in the Body HTML field. To view the HTML/CSS code, click Source.
  11. Click Save.

Customer credibility score

You can request MultiSafepay to perform a credibility assessment of the customer to help reduce fraud.
Email [email protected]

Customer pays you directly

If the customer pays you directly instead of MultiSafepay, to complete the order, simply pay MultiSafepay the order amount from your account balance. This stops MultiSafepay sending the customer an invoice.

If you do so:

  • After MultiSafepay has paid you out, then we refund you the order amount
  • Before MultiSafepay pays you out, then we cancel the payout

After paying for an order from your account balance, you can no longer refund the customer.

How to complete an order with your own funds
  1. Sign in to your MultiSafepay dashboard .
  2. Go to Transactions > Transaction overview, and then click the relevant transaction.
  3. On the Transaction details page, click Complete own funds.
  4. Add a description of what happened with the order, and then click Complete.
    The transaction status changes to Completed.

Expiration and extensions

You define the expiration period for the order, up to a maximum of 180 days (including extensions). If the order is not at least partially shipped within this period, it is cancelled and refunded.

How to extend an order
  1. Sign in to your MultiSafepay dashboard .
  2. Go to Transactions > Transaction overview, and then click the relevant transaction.
  3. On the Transaction details page, click Extend.
    While extended, the order status remains Shipped and the transaction status remains Uncleared.

Gift cards

When paying with a gift card and E-Invoicing, customers must enter the gift card details before placing their order, i.e. on your checkout page. Otherwise our platform would interpret the gift card as a discount and generate incorrect order information, e.g. tax calculations.

You are solely responsible for this in your integration.

Invoices

MultiSafepay can customize the formatting of your invoices on request. Email [email protected]

How to view invoices
  1. Sign in to your MultiSafepay dashboard .
  2. Go to E-Invoicing > Invoices.
How to generate an invoice
  1. Sign in to your MultiSafepay dashboard .

  2. Go to E-Invoicing > E-Invoice generator.

  3. Fill out the shopping cart:

    • In the Quantity field, enter the number of units of the item.
    • In the Name field, enter the name of the item.
    • In the Unit price field, enter the unit price of the item.
    • In the Tax field, enter the tax rate that applies to the item.
    • To add a new line for a different type of item, click Add.
  4. Fill out the required fields: Address, Birthday, City, Country, Currency, Description, Email address, First name, Last name, Order ID, Phone number, Postal code / House number, State / Province.

  5. From the Site list, select the relevant site.

  6. From the Payment flow list, select the relevant collection flow.

  7. Click Generate invoice.

The invoice is sent to the email address provided.


Payment methods

Customers can pay MultiSafepay using any of our payment methods, except for BNPL methods.

Refunds

After shipment, you can refund the invoice order in full or in part, and with or without the shopping_cart object.
See Shopping carts below.

About partial refunds

For partial refunds:

Amount paidOutcome
Equal to new order amountThe order is completed.
Less than new order amountThe order is updated.
More than new order amountThe order is completed and the outstanding amount refunded.

How to refund an order

In your dashboard

  1. Sign in to your MultiSafepay dashboard .
  2. Go to Transactions > Transaction overview, and then click the relevant transaction.
  3. On the Transaction details page, click Refund order.
  4. In the Reason / Description field, enter the reason for the refund or a description of what happened with the order, and then click Complete.
  5. In the Comment field, enter any additional information.
  6. In the Amount fields, enter the amount to refund.
  7. Click Continue.
  8. Review the Refund confirmation, and then click Confirm.

Via the API

See API reference ā€“ Refund order.


Shipment

  • You must ship to receive paymen before the order expires.
  • Share the track & trace details with the customer and MultiSafepay, if relevant.
  • You can ship orders in full or in multiple parts. See Partially ship order below.
  • You must update the order status to Shipped. See Update the order status below.

Partially ship order

How to partially ship an order

If you cannot ship all the items for an order at the same time, you can ship the order in multiple parts.

See API reference ā€“ Update or cancel order > Ship order.

Partial capture

If you have partially shipped an order and the order expires, MultiSafepay collects the funds for all shipped items and cancels the unshipped items.

API integration: In your Ship order request, set the amount for the first partial shipment lower than the total order amount (or the total of the shopping_cart) in the original create order request.

Multi-shipment

MultiSafepay collects for each partial shipment when it is shipped, until all items are shipped, or you or the customer cancels the outstanding items.

Multi-shipment is disabled by default. To enable, email [email protected]

Integration

A unique shipment order_id is generated for each partial shipment.

See API reference ā€“ Update or cancel order > Ship order.

Notifications

You receive a webhook notification when the order status of each partial shipment changes to Shipped.

The status of the main transaction never changes to Completed. It remains Initialized, with a flag.

Refunds

You must must refund partial shipments separately, using the specific shipment order_id, instead of the original invoice order_id.

See API reference ā€“ Refund order.


Update the order status

How to update the order status

When you ship the order, you must update the order status via the dashboard or your integration from Completed to Shipped to receive your payout, and to prevent the order from expiring.

In your dashboard

  1. Sign in to your MultiSafepay dashboard .
  2. Go to Transactions > Transactions overview, and then click the relevant transaction.
  3. On the Transaction details page, under Order details, click Change order status.
  4. From the Change status to list, select Shipped.
  5. In the Memo field, enter a comment.
  6. Click OK.

In your backend

If you change the order status in your backend, the following ready-made integrations pass the updated status to your dashboard automatically:

  • Magento 2 and WooCommerce: When you set the order to Shipped in your backend.
  • Shopware 5: When you set the order to Delivered in your backend.

For other ready-made integrations, make an update order API request.

āš ļø Note: Some third-party plugins may not support updating the status via our API.


Shopping carts

You can choose whether or not to include a shopping_cart object in your create order request (we normally recommend this for BNPL orders).

See Recipes ā€“ Display shopping cart .

You can also then refund with or without the shopping_cart, but for simplicity we recommend matching the refund request to the original order request.

Terms and conditions

  • For direct flows, you must display your terms and conditions in your checkout.
  • For redirect flows, MultiSafepay terms and conditions are displayed by default on payment pages.


šŸ’¬

Support

Email [email protected]

Top of page