Integration Best Practices
Learn more about the most important parts of a successful Mondu integration
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 addaccount_created_at
andaccount_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
andorder/declined
topics and react accordingly.
Updated 3 months ago