Skip to content

Troubleshoot your integration

Performance

Learn how to optimize loading the Cublox script and rendering the buttons for the best performance.

Script tag

Load the Payment Widget script from https://unpkg.com/@paycore/merchant-widget-js@0.3.0/dist/merchantWidget.umd.js only.

Reasons include:

  • The script is dynamically bundled, based on your client ID and on the current buyer. It includes only the specific code, images, localization, and other resources needed and does not slow down your page with unnecessary code. This approach is not possible with a statically distributed script.
  • The script also loads inside the button iframe and Checkout popup window to communicate with the parent window. Loading from unpkg.com means your users' browsers cache the script and there is no need to download the script again inside the iframe or popup.
  • Security updates and bug fixes are instantly available to your users.
  • Conversion updates to drive extra sales and revenue through Cublox are instantly available.
  • Backwards compatibility with previous versions of the script is guaranteed.

Minified script

The script is minified by default. To disable this for development purposes only, add debug=true to the script URL.

Embedded options

Entity names

You can use the HPP code generated in the Sandbox and embed it on your shop page as a script or as an inline link. But in case of embedded link, it's a known issue that browsers may misinterpret some characters combination with ampersands & as HTML special characters.

For example, the &curren combination may be converted to ¤ and partially broke the link. To prevent, use the entity code for ampersand itself (&) or post the currency attribute at the beginning of the links, i.e. {BASE COM API URL}/hpp?public_key=your_pk_test&amount=10&currency=EUR or {BASE COM API URL}/hpp?currency=EUR&public_key=your_pk_test&amount=10.

Browser Support

Supported browsers

Support is guaranteed for the following browsers. For any browsers not on this list, the buttons could continue work but compatibility is not guaranteed.

Desktop

  • Chrome version 41 and later
  • Firefox version 43 and later
  • Safari version 8 and later
  • Opera version 12 and later
  • Edge version 14 and later
  • Internet Explorer version 11 and later

Mobile

  • Chrome version 41 and later
  • Firefox version 15 and later
  • Safari version 9 and later
  • Samsung Browser 8.2 and later
  • Silk Browser 72 and later

Browser features and polyfills

The Cublox JavaScript SDK works as a standalone script, with no strict requirement for installing polyfills. However, if you use features such as fetch or promise in your integration to call your server or run asynchronous tasks, you might need to install a polyfill to allow your app to work in older browsers.

Web views

  • If your site loads in a third-party web view, for example, if a customer views your store after clicking a link on a social media mobile app, the Checkout continue to work.
  • We do not recommend loading your own site in a web view. This integration style is unsupported.

The Checkout continue to work if popup blockers are active. However, we recommends that you do not use popup blockers with this integration.