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 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

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.