# Prestashop integration

This document explains how to integrate BTCPay Server into your PrestaShop store. If you do not have a store yet, follow this step by step article (opens new window) to create one from scratch.

To integrate BTCPay Server into an existing PrestaShop store, follow the steps below.

TIP

This document only applies to the latest v5 version of the module. If you want the v4 module documentation, click here (opens new window).

# Server Requirements

Please ensure that you meet the following requirements before installing this plugin.

  • You are using PHP 7.3.0 or higher
  • Your PrestaShop is version 1.7.7.0 or higher.
  • Your BTCPay Server is version 1.3.0 or higher
  • The PDO, curl, gd, intl, json, and mbstring PHP extensions are available

# Install BTCPay Plugin

  1. Download the latest BTCPay Server plugin (opens new window)
  2. PrestaShop > Modules > Module Manager > Upload a module
  3. Upload the .zip-file you just downloaded
  4. Click on configure to setup the module
BTCPay Server PrestaShop plugin installation

# Connecting the store

The Prestashop BTCPay Server module is a bridge between your server (the payment processor) and your e-commerce store. No matter if you're using a self-hosted or third-party solution from step 2, the setup process is identical.

  1. In the BTCPay Server URL-field, enter the full URL of your host (including the https) – for example https://testnet.demo.btcpayserver.org
  2. Select the default transaction speed (this will change how much BTCPay recommends as transaction fee).
  3. Select the relevant order mode for your store (order is created before or after payment).
  4. Select if you want to send customer metadata to your BTCPay server instance for bookkeeping.
  5. Press Connect to save your settings and be redirected to your BTCPay Server instance to create an API key.
  6. When creating the API key, make sure to give the permissions to a specific store (multiple stores are not supported).
BTCPay Server PrestaShop API key setup
  1. Press the Authorize app-button after which you will be redirected back to your Prestashop store.
  2. Prestashop will try and create a connection to your BTCPay Server instance.
  3. A message will be shown if the connection was successful (but it is smart to make a test purchase).
BTCPay Server PrestaShop setup finished

# 3. Contribute

BTCPay is built and maintained entirely by volunteer contributors around the internet. We welcome and appreciate new contributions.

Contributors looking to help out, before opening a pull request, please create an issue (opens new window) or join our community chat (opens new window) to get early feedback, discuss the best ways to tackle the problem and to ensure there is no work duplication.

# PrestaShop Support

PrestaShop support can be found through its official channels.