here<\/a> for more details.<\/p>\n\nIf the webhook fails, Mondu will send the webhook in increasing intervals until the WebhookController<\/code> returns an OK<\/code> response. Mondu will send 6<\/code> attempts every minute for all buyer<\/code> and order<\/code> topics until the handler responds with an OK status code.<\/p>\n\nExample Payload<\/strong>:<\/p>\n\n{\n \"topic\": \"buyer\/{TOPIC_NAME}\",\n \"buyer\": {\n \"uuid\": \"66e8d234-23b5-1125-9592-d7390f20g01c\",\n \"state\": \"accepted\",\n \"external_reference_id\": \"DE-1-1000745773\",\n \"company_name\": \"2023-02-07T15:14:22.301Z\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\"\n }\n}\n<\/code><\/pre>\n\nCopyright<\/h3>\n\n
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.<\/p>\n\n
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.<\/p>\n\n\n
You can either download the zip file from the releases section or locate it on the WordPress Plugin install page.<\/p>\n\n\n
\nIs the plugin compatible with the WP block editor?<\/h3><\/dt>\nThe Payment Gateway is not compatible, but the form is. See below for more details.<\/p><\/dd>\n
How do I allow for signups outside the checkout?<\/h3><\/dt>\nThis plugin adds native support for allowing users to sign up to a Trade Account outside of the checkout. Perfect for CTA's or banners.<\/p>\n\n
Note<\/strong>: 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()<\/code> function.<\/p>\n\nBlock<\/strong>:\nYou can add the Mondu Trade Account Form Block<\/code> to the block editor, which will output a dynamic form the user can use to sign up for the Trade Account.<\/p>\n\nShortcode<\/strong>:\nIf you want to programmatically output the shortcode, you can do so by placing the following code in your page template:<\/p>\n\necho do_shortcode('[mondu_trade_account_form]');\n<\/code><\/pre><\/dd>\nHow do I know what the status is of a customer?<\/h3><\/dt>\nSimply go to the user's account on WordPress by navigating to Users<\/code> and click on a customer. From there, you should see the following fields:<\/p>\n\n\nuuid<\/code> -> The external UUID that's been assigned from Mondu.<\/li>\nstatus<\/code> -> The buyer status which can be one of unknown<\/code>, accepted<\/code>, pending<\/code>, or declined<\/code>.<\/li>\n<\/ul><\/dd>\nWhen will Mondu send emails to the customer?<\/h3><\/dt>\n\n- After the buyer authorizes the onboarding process in the hosted checkout page.<\/li>\n
- Status change to accepted triggers a webhook attempt, and the email communication is sent.<\/li>\n
- Status change to declined triggers a webhook, and the declined email is sent.<\/li>\n<\/ul>\n\n
It's recommended you still add email triggers for webhooks<\/strong>, as described below.<\/p><\/dd>\nHow do I add custom styling to the payment gateway?<\/h3><\/dt>\nThere 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<\/code> or provide your own using a filter.<\/p>\n\nAn example of this is below:<\/p>\n\n
\/**\n * Adds a custom class to the Mondu Trade Account checkout gateway.\n *\n * @param string $class The existing CSS class for the Mondu Trade Account checkout gateway.\n * @return string The modified CSS class with the custom class name appended.\n *\/\nfunction add_custom_mondu_trade_account_class($class) {\n return $class . ' my-class-name';\n}\n\nadd_filter('mondu_trade_account_checkout_class', 'add_custom_mondu_trade_account_class');\n<\/code><\/pre><\/dd>\nHow can I get a buyer status of a user?<\/h3><\/dt>\nYou can use the mondu_trade_get_buyer_status<\/code> function to fetch the current status of a customer. This function will throw a MonduTradeException<\/code> if the provided customer ID is invalid. Ensure to handle exceptions properly when calling this function.<\/p>\n\nParameters:<\/strong>\n- $customer_id (int)<\/code>: The ID of the customer whose status you want to retrieve.<\/p>\n\nReturns<\/strong>:\n- string<\/code>: The current Mondu Trade Account status of the customer.<\/p>\n\nThrows<\/strong>:\n- MonduTradeException<\/code>: If the customer ID is not valid.<\/p>\n\nExample<\/strong>:\n status = mondu_trade_get_buyer_status($customer_id);<\/p><\/dd>\nHow can I get a buyer limit of a user?<\/h3><\/dt>\nYou can use the mondu_trade_get_buyer_limit<\/code> function to fetch the buyer limit for a customer. This function will throw a MonduTradeException<\/code> if the provided customer ID is invalid or if the buyer status is not accepted<\/code>. Ensure to handle exceptions properly when calling this function.<\/p>\n\nParameters:<\/strong>\n- $customer_id (int)<\/code>: The ID of the customer whose buyer limit you want to retrieve.<\/p>\n\nReturns<\/strong>:\n- array<\/code>: An associative array containing the buyer limit details.<\/p>\n\nThrows<\/strong>:\n- MonduTradeException<\/code>: If the customer ID is not valid or the buyer status is not accepted<\/code>.<\/p>\n\nExample<\/strong>:\n $buyer_limit = mondu_trade_get_buyer_limit($customer_id);<\/p>\n\nSample Output<\/strong>:<\/p>\n\nArray (\n [purchasing_limit] => Array (\n [purchasing_limit_cents] => 100000\n [balance_cents] => 10000\n [max_purchase_value_cents] => 90000\n [max_collections_state] => no\n )\n)\n<\/code><\/pre><\/dd>\nHow can I run actions when a buyer status has changed?<\/h3><\/dt>\nThere 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.<\/p>\n\n
Actions<\/strong>:\n- mondu_trade_buyer_webhook_received<\/code>\n- mondu_trade_buyer_accepted<\/code>\n- mondu_trade_buyer_pending<\/code>\n- mondu_trade_buyer_declined<\/code><\/p>\n\nExample Payload<\/strong>:<\/p>\n\n{\n \"topic\": \"buyer\/{TOPIC_NAME}\",\n \"buyer\": {\n \"uuid\": \"66e8d234-23b5-1125-9592-d7390f20g01c\",\n \"state\": \"accepted\",\n \"external_reference_id\": \"DE-1-1000745773\",\n \"company_name\": \"2023-02-07T15:14:22.301Z\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\"\n }\n}\n<\/code><\/pre>\n\nExample for mondu_trade_buyer_accepted<\/code><\/strong>:<\/p>\n\nadd_action('mondu_trade_buyer_accepted', function ($customer_id, $buyer) {\n \/\/ Handle accepted status\n});\n<\/code><\/pre><\/dd>\n\n<\/dl>","raw_excerpt":"Integrates Mondu's Digital Trade Account functionality into WooCommerce, enabling customers to apply for trade accounts during checkout.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/213417","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=213417"}],"author":[{"embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ainsleydev"}],"wp:attachment":[{"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=213417"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=213417"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=213417"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=213417"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=213417"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/hat.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=213417"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}