Mondu Trade Account

Note: The user must be logged in to perform this action, as a customer ID is required when Mondu responds to the Trade Account request. Before displaying the form, ensure your users are logged in by using the WordPress is_user_logged_in() function.

Block:
You can add the Mondu Trade Account Form Block to the block editor, which will output a dynamic form the user can use to sign up for the Trade Account.

Shortcode:
If you want to programmatically output the shortcode, you can do so by placing the following code in your page template:

echo do_shortcode('[mondu_trade_account_form]');

How do I know what the status is of a customer?
Simply go to the user's account on WordPress by navigating to Users and click on a customer. From there, you should see the following fields:

uuid -> The external UUID that's been assigned from Mondu.
status -> The buyer status which can be one of unknown, accepted, pending, or declined.

After the buyer authorizes the onboarding process in the hosted checkout page.
Status change to accepted triggers a webhook attempt, and the email communication is sent.
Status change to declined triggers a webhook, and the declined email is sent.

It's recommended you still add email triggers for webhooks, as described below.
How do I add custom styling to the payment gateway?
There may be times you want to style the checkout gateway with your own styles. To do this, you can either latch onto the default class name mondu-trade or provide your own using a filter.

An example of this is below:

/**
* Adds a custom class to the Mondu Trade Account checkout gateway.
*
* @param string $class The existing CSS class for the Mondu Trade Account checkout gateway.
* @return string The modified CSS class with the custom class name appended.
*/
function add_custom_mondu_trade_account_class($class) {
return $class . ' my-class-name';
}

add_filter('mondu_trade_account_checkout_class', 'add_custom_mondu_trade_account_class');

How can I get a buyer status of a user?
You can use the mondu_trade_get_buyer_status function to fetch the current status of a customer. This function will throw a MonduTradeException if the provided customer ID is invalid. Ensure to handle exceptions properly when calling this function.

Parameters:
- $customer_id (int): The ID of the customer whose status you want to retrieve.

Returns:
- string: The current Mondu Trade Account status of the customer.

Throws:
- MonduTradeException: If the customer ID is not valid.

Example:
status = mondu_trade_get_buyer_status($customer_id);
How can I get a buyer limit of a user?
You can use the mondu_trade_get_buyer_limit function to fetch the buyer limit for a customer. This function will throw a MonduTradeException if the provided customer ID is invalid or if the buyer status is not accepted. Ensure to handle exceptions properly when calling this function.

Parameters:
- $customer_id (int): The ID of the customer whose buyer limit you want to retrieve.

Returns:
- array: An associative array containing the buyer limit details.

Throws:
- MonduTradeException: If the customer ID is not valid or the buyer status is not accepted.

Example:
$buyer_limit = mondu_trade_get_buyer_limit($customer_id);

Sample Output:

Array (
[purchasing_limit] => Array (
[purchasing_limit_cents] => 100000
[balance_cents] => 10000
[max_purchase_value_cents] => 90000
[max_collections_state] => no
)
)

How can I run actions when a buyer status has changed?
There are 4 different actions you can latch onto when Mondu replies with an update after a customer has applied for a Digital Trade Account. Below is a list of available actions.

Actions:
- mondu_trade_buyer_webhook_received
- mondu_trade_buyer_accepted
- mondu_trade_buyer_pending
- mondu_trade_buyer_declined

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

Example for mondu_trade_buyer_accepted:

add_action('mondu_trade_buyer_accepted', function ($customer_id, $buyer) {
// Handle accepted status
});