Mondu Trade Account

The Mondu Trade Account – WooCommerce plugin integrates Mondu’s Digital Trade Account functionality into your WooCommerce store, allowing your customers to apply for and manage trade accounts directly during checkout.

Features:
– Trade Account Applications: Let customers apply for a trade account while completing their order.
– Webhook Integration: Automatically update customer statuses (e.g., accepted, pending, declined) when a customer has applied for a Digital Trade Account.
– Custom Styling and Actions: Easily extend and customize the checkout experience with hooks and filters. Allows you to run actions when a buyer has been accepted or declined.
– Admin Management Tools: Access customer trade account information, logs, and webhook settings from the WordPress admin panel.
– Secure and Compliant: Fully supports WooCommerce standards and uses secure connections for API communication.

Useful Links:
– Official GitHub Repository
– Changelog

Prerequisites

Before installing and using the Mondu Trade Account – WooCommerce plugin, ensure your environment meets the following requirements:

• WordPress: Requires at least version 6.7
• PHP: Requires at least version 7.4
• WooCommerce: Requires at least version 9.4
• Mondu Plugin: Needs to be installed, tested version 3.0.3

Backwards Compatibility

This plugin has a direct dependency on the Mondu Plugin. Before updating both plugins, always test the new version on a staging environment to ensure compatibility with your customizations, integrations, and WooCommerce setup.

Buyer States

There are a total of 6 buyer states that a user can be in. If you are the admin of the WordPress install, you can change these states, but it’s recommended not to.

State
Explanation

unknown
The default status, when the customer hasn’t signed up yet.

applied
Customer has tried to apply for a Trade Account, but the webhook hasn’t been triggered.

accepted
Customer has been approved for a Trade Account and should have a buyer limit.

pending
Customer is waiting to hear from Mondu if their account has been accepted (Maximum of 48 hours).

declined
Customer has been flat-out refused credit from Mondu.

cancelled
Customer exited out of the Mondu Trade Application form.

Sandbox

If you have sandbox mode set on the Mondu plugin, you can test the following states with the email addresses listed below. Note that if an email does not follow this convention, the trade application will fail.

• Accepted: accepted.good.{random-string}@example.com
• Pending: pending.pending-brc.{random-string}@example.com
• Declined: declined.bad.{random-string}@example.com

Note that emails are sent via the Mondu internal inbox in sandbox mode. To see them, it’s best to reach out to Mondu.

Webhooks

Mondu sends buyer webhooks when a user has applied for a Trade Account. The following payload will be provided via this webhook once buyer onboarding requested is processed. See here for more details.

If the webhook fails, Mondu will send the webhook in increasing intervals until the WebhookController returns an OK response. Mondu will send 6 attempts every minute for all buyer and order topics until the handler responds with an OK status code.

Example Payload:

{
  "topic": "buyer/{TOPIC_NAME}",
  "buyer": {
    "uuid": "66e8d234-23b5-1125-9592-d7390f20g01c",
    "state": "accepted",
    "external_reference_id": "DE-1-1000745773",
    "company_name": "2023-02-07T15:14:22.301Z",
    "first_name": "John",
    "last_name": "Smith"
  }
}

Copyright

All rights reserved. This plugin and its code are proprietary to ainsley.dev LTD. Unauthorized copying, distribution, transmission, or storage of this plugin, its code, or content, in whole or in part, in any form or by any means, is strictly prohibited without prior written permission.

This plugin is licensed for use by end-users on their WordPress sites but may not be copied, shared, modified, or redistributed in any form, except with explicit written permission from ainsley.dev LTD.