# 🚀 Introduction

Book an appointment

# Who is this documentation for?

This documentation is intended for partners, sellers, developers, and agencies who create and distribute modules and/or themes that will be added to the PrestaShop Marketplace (opens new window).

# Why read this?

PrestaShop is an extremely customizable e-commerce platform that was designed so that third-party modules could easily build upon its foundations.

The goal of this documentation is to help you take advantage of the PrestaShop Integration Framework to connect your modules to the PrestaShop ecosystem so you can optimize development and usability.

# What is the PrestaShop Integration Framework?

Previously known as "SaaS App", the PrestaShop Integration Framework includes several different services that you can select according to your needs. It improves merchant experience and streamlines the development of commonly used features such as billing and data synchronization.

# Why Use the PrestaShop Integration Framework?

# ✴️ General Benefits

Faster time to market: The PrestaShop Integration Framework allows you to upgrade PrestaShop module less frequently, so you can deploy your services as soon as they are ready, and make them available to all merchants right away.

Open tech stack: You can develop your services in any language (PHP, Node.js, Go, Rust, Java, ...) or framework available. APIs allow your developers to agnostically integrate a PrestaShop environment.

Breaking changes loose coupling: When PrestaShop releases a major version, only your module has to be updated. You can keep your backend services as they are.

High computing load: You can manipulate data without compromising the merchants' ability to serve their customers. Heavy data processing can be performed on your own services.

# 🛂 PrestaShop Account

PrestaShop Account establishes a link between the module and the PrestaShop accounts. It allows you and PrestaShop to identify the merchant in the PrestaShop system.

# Why Use It?

  • Required to use other services of the PrestaShop Integration Framework
  • Saves time for merchants through automatic login
  • Improves your visibility on merchant data: insights on conversions

# 💳 PrestaShop Billing

PrestaShop Billing allows the PrestaShop billing system to deal with the management and invoicing of merchant subscriptions.

# Why Use It?

  • Optimized payment experience for merchants
  • New payment model for you with automatic monthly payments
  • Improvement of GDPR compliance, as merchants are requested to consent to the processing of their data when proceeding to payment
  • Better tracking of the store activations for your module
  • Possibility to offer different pricing plans

# ☁️ PrestaShop CloudSync

At the core of PrestaShop, CloudSync allows you to duplicate and synchronize merchant store data on PrestaShop cloud servers (carriers, carts, orders, products and more) so you can access and integrate comprehensive data into your modules or services to offer merchants the most optimized experience.

# Why Use It?

  • Capture comprehensive merchant store data into the cloud
  • Access reliable, structured, and fresh data in just a few clicks
  • Easily integrate PrestaShop data in your modules or services: CloudSync handles the support of all versions of PrestaShop, and standardize data models across PrestaShop versions
  • Get a better understanding of your modules or services usage through data monitoring

# Prerequisites

# Compatibility chart

The following configuration is required to use the PrestaShop Integration Framework:

PrestaShop platform PHP PrestaShop Account PrestaShop Billing (components) PrestaShop Billing (PHP helper) PrestaShop CloudSync (EventBus)
8.0 7.2 – 8.1 6.x Yes 1.x 2.0.x - PHP 7.1+
1.7.8 7.1 – 7.4 5.x Yes 1.x 2.0.x - PHP 7.1+
1.7.7 7.1 – 7.3 5.x Yes 1.x 2.0.x - PHP 7.1+
1.7.5 – 1.7.6 5.6 – 7.2 5.x Yes 1.x 2.0.x - PHP 7.1+
1.7.4 5.6 – 7.1 5.x Yes 1.x 2.0.x - PHP 7.1+
1.7.0 – 1.7.3 5.6 – 7.1 5.x Yes 1.x 2.0.x - PHP 7.1+
1.6.1.x 5.6 – 7.1 5.x Yes 1.x No

Important

PrestaShop eventbus module (CloudSync) does not support PHP 5.6. Compatibility starts with PHP 7.1.

# Supported languages

To perform the integration of your module with the PrestaShop ecosystem, you need to use the following languages:

Note

For the frontend, you can also use Vue.js 3 (opens new window) or React (opens new window), but PrestaShop does not provide support for integrations implemented with these languages.

Note

For your own services, that you will connect to the PrestaShop ecosystem, you can use the language of your choice. See PrestaShop Integration Framework Architecture for more information.

# Getting help

If you need any extra help, please get in touch with your Solution Engineer at PrestaShop.