Troubleshooting common PayPal POS Integration errors

Error 1: The PayPal POS service was not able to reach your site (needed for updates from PayPal POS). Remove any ‘coming soon’ plugins, enable https and try to refresh the connection. 

Solution:

This error indicates that the PayPal POS service is unable to communicate with your website, which is essential for receiving updates from PayPal POS.

Short-term Solution:

1. Refresh the Connection:
   • Go to the Advanced settings section in the plugin.
   • Click the Refresh button.
2. Re-authorize the plugin:
   • If refreshing the connection doesn’t work, go to the General settings of the plugin.
   • Authorize the plugin against PayPal POS again.

Long-term Solution:

1. Check for Blocking Plugins:
   • If re-authorization fails, something might be blocking the connection between PayPal POS and your site.
   • Ensure that you have no plugins that can potentially block requests from PayPal POS (e.g., “coming soon” plugins, security plugins with restrictive firewall settings).
2. Whitelist the Webhook Endpoint:
   • If you have a firewall or CDN in front of your site, make sure that the endpoint /wp-json/izettle/webhook is whitelisted in the settings.
3. Contact Support:
   • If the error persists after trying the above steps, contact the BjornTech support at [email protected].

Error 2: [paypalpos-product-uuid] found on more posts than expected ([product_id]). when creating PayPal POS product from WooCommerce product [product_id]

Solution:

This error usually arises when a product in WooCommerce is duplicated using a plugin (like the Duplicate Post plugin) instead of the built-in functionality in WooCommerce.

Short-term Solution:

1. Identify Affected Products:
   • Find the affected products in WooCommerce (the error message will list the product IDs).
2. Trash and Restore:
   • Move these products to Trash (without permanently deleting them). This will break the link between the WooCommerce products and PayPal POS.
   • Restore the products from Trash.
3. Re-sync:
   • Run a new sync from WooCommerce to PayPal POS.

Long-term Solution:

• To prevent this issue, always use the built-in feature in WooCommerce for duplicating products, as it is the only method that works correctly with the PayPal POS integration plugin.

Error 3: Communication error with PayPal POS when creating/updating PayPal POS product from WooCommerce product [product_id]. Please try to sync the product to PayPal POS again by clicking Update in the WooCommerce product view.

Solution:

This error typically occurs when you have initially exported a simple product from WooCommerce to PayPal POS, and then later added variants to it directly in PayPal POS, effectively changing it into a variable product.

To resolve this, enable the Allow conversion from simple to variable products setting in the Advanced settings of the plugin.

This should allow the plugin to correctly handle the change from a simple to a variable product and resolve the communication error.