Troubleshooting

Understanding Shopify "Webhook is Failing" Notifications

Occasionally, you may receive an email notification from Shopify with the subject Your webhook is failing, containing the following message: Example Notification Email Your webhook for ... at https:// ... .postaffiliatepro.com/plugins/Shopify/shopify.php?ac=order&status=paid is failing to return a successful response. This webhook has been attempted ... times. If your webhook continues to fail, it will be removed and your application will not receive any more notifications. Although these not...

Troubleshooting Slow or Unresponsive Post Affiliate Pro Cloud Accounts

If your Post Affiliate Pro cloud account is slow or not loading at all, there may be several reasons for this issue. We have servers located in various regions around the world, and our network configuration is quite complex. As a result, specific issues can occur. For example, your account might work for us in Europe but not for you in Asia. In such cases, it is very helpful if you assist us in identifying the problem directly from your location. To help us, you can execute a few simple comma...

Resolving the ‘Request Not Executed Yet’ Error in API v1

One of our customers, who uses a PHP server with Nginx and PHP-FPM, encountered an issue when attempting to use a generic PHP API v1 code for [creating an affiliate](https://support.qualityunit.com/961744-Pap_Api_Affiliate#newaffiliate). When the add() function was called, the following error was thrown: ‘Request not executed yet’. How Was This Issue Resolved? Here’s what the customer reported: “The zend.ze1 setting was set to off, and everything worked correctly. To identify this, I had to e...

Troubleshooting Affiliate Import Issues in Post Affiliate Pro

Sometimes you may want to import affiliates into Post Affiliate Pro, but for some reason, the import does not work. What should you do? 1) Ensure you have the correct file format In the merchant panel, navigate to Tools > Import/Export > Export, check 'Affiliates', and click Export data. Below the table listing the export options, you will find a link labeled Exported files that will redirect you to the exported files screen. There, you can click the D button next to the exported file. ...

Template Error: Invalid Smarty syntax

Incorrect Widget Ensure your widget has a properly filled ID. Additionally, the CSS class name cannot be empty: Incorrect: {widget id=""} {widget id="" class=""} {widget id="firstname" class=""} Correct: {widget id="firstname"} or {widget id="firstname" class="signupFirstname"} Special Characters The error "Invalid Smarty syntax" may appear when editing templates. This typically occurs if you use special characters in your code. Often, this happens when you edit template text using a rich...

Why the General Affiliate Link May Not Be Displayed

There are two main reasons why the general affiliate link may not be displayed: First, your tracking settings could be the cause. If you are using either the Standard links (Redirect links) or the DirectLink style (no URL parameters) linking method, the general affiliate link will not function. In such cases, the system automatically disables this link. Second, the issue may be related to your template code. If you have modified your template, it could lead to display problems. Try switching t...

Error When Adding JavaScript (Google Analytics) Code to Affiliate Panel

Post Affiliate Pro utilizes the [Smarty template engine](https://www.smarty.net/), which requires special attention when inserting certain types of text. In particular, the characters { and } are significant because Smarty uses them to parse template code. JavaScript code often contains curly brackets, and directly placing JavaScript into a Smarty template may result in errors. Fortunately, this issue can be resolved by enclosing the JavaScript code within {literal} and {/literal} tags, as show...

API Curl Error: <url> Malformed

This error occurs when an API script uses a malformed URL, often due to specifying a relative path instead of a full (absolute) URL. To resolve this issue, update your API script to use the complete URL, including the protocol (e.g., https://), domain, and path. https://yourdomain.com/path/to/api Switching from relative links to full URLs should eliminate the error.

Referral ID Can Contain Only [a-zA-Z0-9_-] Characters. Email Given

When customers attempt to sign up as affiliates, they may encounter the following error message: Referral ID can contain only [a-zA-Z0-9_-] characters. something@something.com given This error occurs due to the Username Referral IDs plugin, which sets the Referral ID based on the username—often configured as the user's email address. Since email addresses contain characters not permitted in Referral IDs, this leads to the error. To resolve this issue, navigate to Configuration > Affiliate ...

Resolving Referral ID Plugin Conflicts During Affiliate Signup

If you are unable to sign up affiliates due to an error message regarding the Referral ID, the issue is likely related to your active plugins. Go to Plugins > Active Plugins in your merchant panel to review the currently activated plugins. One or more plugins may be conflicting with each other, causing the Referral ID error. For example, you cannot use the Referral ID Length Constraint plugin—which enforces a specific length for referral IDs—together with the Username Referral IDs plugin, w...

Resolving the "Your API file may not match your PAP installation" API File Version Error

The error "Could not communicate order status change to PAP, Your API file may not match your PAP installation." is caused by different versions of your API file and the version of your PAP installation. This happens when you use the API file on a different server than your PAP server. The error probably appeared after you updated the PAP application but forgot to update the API file on the other server. To solve the problem, copy the API file from the actual installation and overwrite the API ...

Widgets in Blue Aero Theme are Shrunk and One Over Another

If you notice that widgets in your Blue Aero theme sidebar appear shrunk or improperly sized, you can quickly restore them to their correct dimensions by following these steps: - Hover your mouse over the top edge of the affected widget until the resize cursor appears. - Click and drag the edge of the widget to adjust its height as needed. - Release the mouse button once the widget is restored to your preferred size. This process will help ensure that all sidebar widgets are displayed clearly ...

Resolving the "Error loading user 'index.html.var'" Issue in Site Replication

If you are encountering the error message Error loading user 'index.html.var' instead of seeing a replicated site, the issue is that the affiliate parameter is missing. This can occur, for example, when you use the custom location setting for site replication and specify the same URL as your main site. Typically, you access your site at: https://yoursite.com/ and you may have also set this as the custom location for site replication. As a result, your affiliates will have links such as: https://...

Welcome Message is Not Translated

The welcome message displayed beneath the affiliate manager's photo in the affiliate panel must be enclosed between and . To edit the affiliate manager's information, including the welcome message, in the merchant panel, navigate to your merchant name > Change affiliate manager info visible in affiliate panel. The welcome message should be formatted as follows: Hello and welcome to our affiliate program... If you have updated the welcome message, you will need to add it as a new t...

Some Tier Commissions are Not Generated. Why?

Let's say in a campaign we have the general commission settings the following way: 1st tier: 5% 2nd tier: 1% 3rd tier: 1% 4th tier: 1% and in the same campaign let's have a commission group (CG1) where the following commission setting can be found: 1st tier: 10% Let's have the following affiliates: John > Peter > Jack > Samuel, while John referred Peter, Peter referred Jack, Jack referred Samuel. Now let's examine 2 cases when Samuel refers a sale, so in this case, Jack is the 2...

Signup Affiliate - Syntax Error

If you experience the following error message after a new member signs up: "Syntax error: [in text://5c7645bc889e310d1e477e0c69c33638 line 18]: unrecognized tag: behavior:url(#default#VML); (Smarty_Compiler.class.php, line 448)" The problem is in the 'after signup' mail templates, specifically in the following ones: - Merchant - New User Signup - Affiliate - New User Signup Before Approval - Affiliate - New User Signup Approved Please consult [this article](https://support.qualityunit.com/...

How to Remove Shipping Charges from PayPal Affiliate Payments

If PayPal is applying shipping charges to affiliate payments, this is likely due to existing settings within your PayPal account. To update these settings, navigate to Profile > Postage Calculations and click the Clear Settings button to remove any shipping charges.

Troubleshooting Affiliate Signup Form

If there are no visible errors but the affiliate signup form still does not function—despite all required data being filled in correctly—and clicking the Signup button does not trigger any response, a deeper investigation is necessary. Use your browser’s console to inspect the signup form; you may encounter the following error: uncaught exception: com.google.gwt.event.shared.UmbrellaException: One or more exceptions caught, see full set in UmbrellaException#getCauses This error typically occur...

Missing Banners in the Affiliate Panel

Banners do not appear in the affiliate panel under Promotion > Banners & Links (as shown in the screenshot below). To resolve this issue, log in to your merchant panel. Navigate to Banners > Banner Manager, locate any HTML banner, and click Edit. Under the Details tab, in the Banner Parameters section, find the Preview option. Select Iframe and set the Iframe size to either Own size or Predefined size.

Resetting Your Password for the Merchant or Affiliate Panel

If you have forgotten your username for the merchant or affiliate panel, you can retrieve it from the login page of either affiliate or merchant panel: On the login page, click the Forgot Password link located below the form. On the next page, please enter your email address and the characters from the captcha image in the fields provided at the bottom of the form. Your username and instructions for resetting your password will be sent to your email inbox after you click the Request New Passw...
×