Monitis Reseller Account

As soon as WHMCS Admin accepts the order, a request will go to Monitis Reseller API (see here: http://api.monitis.com/api/apiActions.html ) to create orders in the admin’s Monitis account to match the WHMCS order.

C:\Users\monitis_user\Google Drive\MY DOCUMENTS_JUNE 2016\000-AAA-^^-WHMCS - v 2\FINALIZE\FINAL\SCREENS\WHMCS_IMAGES\WHMCS_IMAGES\image24.png

If this was the first order of the WHMCS client, a new client will be created in Monitis for the reseller.

C:\Users\monitis_user\Google Drive\MY DOCUMENTS_JUNE 2016\000-AAA-^^-WHMCS - v 2\FINALIZE\FINAL\SCREENS\WHMCS_IMAGES\WHMCS_IMAGES\image25 (1).png

Note that relationship between WHMCS order and Monitis order is one-to-many: depending on the configuration of the underlying WHMCS offer there can be more than one Monitis order created to match one WHMCS order.

 

Naming of Monitis Orders

Notice the naming of Monitis order(s) that were created to match the WHMCS order.

C:\Users\monitis_user\Google Drive\MY DOCUMENTS_JUNE 2016\000-AAA-^^-WHMCS - v 2\FINALIZE\FINAL\SCREENS\WHMCS_IMAGES\WHMCS_IMAGES\image26.png

It mentions the type of WHMCS offer (“option” in the above screen stands for “configurable option”), and also contains the unique WHMCS order ID as well as unique Monitis ID.

 

The Error Log

Whenever Monitis API call returns an error you will be directed to the Error log.

C:\Users\monitis_user\Google Drive\MY DOCUMENTS_JUNE 2016\000-AAA-^^-WHMCS - v 2\FINALIZE\FINAL\SCREENS\WHMCS_IMAGES\WHMCS_IMAGES\image27.png

To see all the messages in the error log click Show more.

C:\Users\monitis_user\Google Drive\MY DOCUMENTS_JUNE 2016\000-AAA-^^-WHMCS - v 2\FINALIZE\FINAL\SCREENS\WHMCS_IMAGES\WHMCS_IMAGES\image28.png

The Response column will tell you the exact problem and the action to take to try and fix it. E.g. if unable to perform upgrade/downgrade because the client’s current usage of Monitis services exceeds the new plan, it will tell you the exact services currently in use by the client that need to be removed or downgraded in order for the upgrade/downgrade to pass successfully (see Upgrading/Downgrading WHMCS Offer).

Handling of Monitis Order Creation Failure

When WHMCS admin accepts the order in WMCS, depending on the number and specifics of underlying WHMCS offers one or more orders are created in Monitis to match the WHMCS order.

If creation of one or more Monitis orders fails, the whole transaction is rolled-backed on Monitis side, and the WHMCS admin is redirected to the error log page of Monitis Addon where he is shown the following error message:

Order not accepted.

Failed to create the following order in Monitis:

[Monitis_order_1]

As a result, no order was created in Monitis and monitoring services were not added.

Please try again later.

On WHMCS side the order will remain in “Pending” status.