Parameters Reference for MarketerPanel
A complete guide to understanding order statuses, custom classes, and API parameters for seamless integration and order processing.
John D
Last Update 4 maanden geleden
This guide serves as a comprehensive reference for all key parameters required for seamless integration and operation of your SMM website with MarketerPanel. It includes order status types, custom class names, and other essential configurations.
Website Order Status Types
MarketerPanel utilizes specific order statuses from your WooCommerce website to track and process SMM orders effectively. These include default WooCommerce statuses and additional custom statuses.
| Order Status | Description |
|---|---|
| Pending Payment | Order has been created, but payment hasn’t been received yet. |
| Processing | Payment has been received, and the order is being prepared for fulfillment. |
| On Hold | Order is on hold and awaiting action (e.g., payment confirmation or stock availability). |
| Completed | Order fulfillment has been completed, and no further actions are required. |
| Cancelled | Order has been canceled either by the customer or an admin. |
| Refunded | Payment has been refunded to the customer. |
| Failed | Payment failed or was declined (e.g., due to insufficient funds). |
To optimize order processing in MarketerPanel, add the following custom statuses:
Custom Order Statuses for MarketerPanel:
| Order Status | Slug Code | Description |
|---|---|---|
| In Process | in-process | Indicates the order is actively being processed with the SMM panel. |
| In Review | in-review | For orders requiring manual review or verification before processing. |
Custom Classes Names
Extra Product Options & Add-Ons for WooCommerce element class names, such as mp_quantity, mp_link, or mp_comments, are used to define and map specific product options (order parameters) in WooCommerce products to the required fields for seamless integration with SMM panels. These custom classes ensure accurate data transfer for automatic order processing.
Predefined Custom Classes:
| Class Name | Description |
|---|---|
| mp_link | The URL or link to the social media page or post for the order. |
| mp_quantity | The number of units (likes, followers, etc.) required for the order. |
| mp_runs | Number of runs or repetitions to split the delivery into. |
| mp_interval | Time gap in minutes between multiple runs of the service. |
| mp_keywords | A list of keywords, separated by \r\n or \n, for targeted services. |
| mp_comments | A list of comments, separated by \r\n or \n, to be delivered. |
| mp_usernames | A list of usernames, separated by \r\n or \n, for the service. |
| mp_hashtags | A list of hashtags, separated by \r\n or \n, for targeting. |
| mp_hashtag | A specific hashtag used to scrape usernames for the service. |
| mp_username | The URL or username to scrape followers or comment owners from. |
| mp_media | The URL of the media to scrape likers or interactions from. |
| mp_answer_number | Specifies the answer number for poll-related orders. |
| mp_groups | A list of groups, separated by \r\n or \n, for group-targeted services. |
| mp_min | The minimum quantity for orders when specifying a range. |
| mp_max | The maximum quantity for orders when specifying a range. |
| mp_posts | Limits the number of new posts for which orders will be created. |
| mp_old_posts | Specifies the number of existing posts to include in orders. |
| mp_delay | The delay time in minutes before the order starts processing. |
| mp_expiry | The expiry date (format: d/m/Y) for the service or order. |
| mp_country | The name or code of the target country for location-specific services. |
| mp_device | The device type for the service, such as mobile or desktop. |
| mp_type_of_traffic | Specifies the traffic source, e.g., Google, custom referrer, or blank. |
| mp_google_keyword | Required if traffic type is Google Keyword; specifies the keyword. |
| mp_referring_url | Required if traffic type is Custom Referrer; specifies the referral URL. |
Panel Order Status Types
MarketerPanel retrieves order status updates from connected SMM panels to keep your system synchronized. Below are the typical panel order statuses:
| Order Status | Description |
|---|---|
| Pending | The order has been received by the SMM panel but has not yet been processed. This is typically the initial status for newly submitted orders. |
| In progress | The order is currently being fulfilled by the SMM panel. Indicates that the service delivery has started but is not yet completed. |
| Completed | The order has been successfully fulfilled and completed by the SMM panel. No further actions are required for this order. |
| Partial | The order has been partially completed due to the inability to fully deliver the requested service. The remaining amount may be refunded or adjusted, depending on the panel's policy. |
| Processing | The order is being prepared for fulfillment by the SMM panel. This status indicates that the panel is initiating the order delivery process. |
| Canceled | The order has been canceled by the SMM panel or due to an issue (e.g., insufficient balance or invalid parameters). No services will be delivered for this order. |
Panel Order Parameters
When orders are submitted to an SMM panel, certain parameters must be provided to ensure smooth and accurate processing via the API. The table below highlights the key parameters required for effective order management, including those configured on your website (SMM services) and those managed within MarketerPanel:
| Order Type | Required Parameters (set wit Website SMM Service) | Optional Parameters (set with Website SMM Service) | Parameters (set on MarketerPanel) |
|---|---|---|---|
| Default | link quantity | runs interval | key action service |
| Package | link | key action service | |
| SEO | link quantity keywords | key action service | |
| Custom Comments | link comments | key action service | |
| Mentions | link quantity usernames | key action service | |
| Mentions with Hashtags | link quantity usernames hashtags | key action service | |
| Mentions Custom List | link usernames | key action service | |
| Mentions Hashtag | link quantity hashtag | key action service | |
| Mentions User Followers | link quantity username | key action service | |
| Mentions Media Likers | link quantity media | key action service | |
| Custom Comments Package | link comments | key action service | |
| Comment Likes | link quantity username | key action service | |
| Poll | link quantity answer_number | key action service | |
| Comment Replies | link username comments | key action service | |
| Invites from Groups | link quantity groups | key action service | |
| Subscriptions | username min max delay | posts old_posts expiry | key action service |
| Web Traffic | quantity country device type_of_traffic google_keyword referring_url | runs interval | key action service |
Below is a table detailing the required Order Parameters and their descriptions, as outlined in the Custom Class Name section. These parameters, derived from the original SMM panel API specifications, play a crucial role in ensuring seamless order processing. Some parameters need to be configured directly in MarketerPanel, some are automatically set by MarketerPanel, and others must be configured for each SMM service (WooCommerce product) on your SMM website using Extra Product Options & Add-Ons for WooCommerce element class name to collect necessary data from customers.
By collecting this information during the order process, MarketerPanel uses the data to process orders with the appropriate SMM panel automatically. The collected parameters are sent to the SMM panel's API through MarketerPanel, ensuring accurate and efficient order fulfillment.
| Parameters | Description |
|---|---|
| key | Your API key |
| action | add |
| service | Service ID |
| link | Link to page |
| quantity | Needed quantity |
| runs (optional) | Runs to deliver |
| interval (optional) | Interval in minutes |
| keywords | Keywords list separated by \r\n or \n |
| comments | Comments list separated by \r\n or \n |
| usernames | Usernames list separated by \r\n or \n |
| hashtags | Hashtags list separated by \r\n or \n |
| hashtag | Hashtag to scrape usernames from |
| username | URL to scrape followers from / Username of the comment owner |
| media | Media URL to scrape likers from |
| answer_number | Answer number of the poll |
| groups | Groups list separated by \r\n or \n |
| min | Quantity min |
| max | Quantity max |
| posts (optional) | Limit new posts for which orders will be created |
| old_posts (optional) | Number of existing posts for orders |
| delay | Delay in minutes |
| expiry (optional) | Expiry date (format: d/m/Y) |
| country | Country code or name |
| device | Device type |
| type_of_traffic | Traffic type (1 - Google Keyword, 2 - Custom Referrer, 3 - Blank Referrer) |
| google_keyword | Required if type_of_traffic = 1 |
| referring_url | Required if type_of_traffic = 2 |