Once your Mondu API integration is nearing its completion, your Integration Manager will check your integration for these best practices.

👍

Good to know

If you're using one of our official E-commerce Plugins, you can lean back! The plugins are developed with these best practices in mind.

Checkout UX

• Make sure to use the Mondu Hosted Checkout
• Make sure Legal and UX Guidelines are followed
• Ensure Mondu only gets shown to B2B customers
• Recommended: Make sure Mondu doesn’t get shown again after a buyer was declined
• Recommended: Show a link to Mondu’s FAQ Page on your payment overview page

Orders

Order Creation and Authorization

• Send full line items for every order
• If you collect optional data in the checkout (like phone number, Registration ID etc.), ensure this is also sent to Mondu - this helps with conversion rate
• For returning and registered buyers: Send customer ID as external_reference_id in the buyer object of the Create Order Request, if possible also add account_created_at and account_updated_at
• Make sure authorized orders get either confirmed, adjusted or cancelled, as authorized orders eat up buyer limits - don’t simply abandon authorized orders
• If the final order ID isn’t known during checkout yet, make sure to update it later (preferably in the Confirm Order Request)
• Make sure your system can handle Pending States

Order Adjustments

• Ensure that changes to the order after authorization (e.g. address changes) trigger an order cancellation, and a new order is created
• Recommended: Orders can only be adjusted downward
• Recommended: Don’t cancel orders that have an Invoice already

Invoices

Invoice Templates

• Make sure Mondu Invoice Snippets are shown on Invoice PDFs with correct snippets per buyer country
• Ensure either invoice ID or order ID are shown as payment reference

Invoice Creation

• Make sure Invoices get sent either via file upload (preferred) or URL for every invoice: Invoice Overview

Credit Notes

• Instead of canceling invoices, use credit notes: Create Credit Note

Webhooks

• Make sure Webhook IPs are whitelisted on your receiving systems: Webhooks Security
• Make sure to subscribe to the order/pending, order/confirmed and order/declined topics and react accordingly.