Prestashop module for BTCPay Server payment integration

BTCPay Server - Prestashop Plugin

!BTCPay Server

<h3 align="center"> Accept Bitcoin payments within PrestaShop </h3>

<div align="center"> <p> <a href="https://github.com/btcpayserver/prestashop-plugin/pulse"><img src="https://img.shields.io/maintenance/yes/2025? alt="Maintained"/></a> <a href="https://github.com/btcpayserver/prestashop-plugin/actions"><img src="https://img.shields.io/github/actions/workflow/status/btcpayserver/prestashop-plugin/validate.yml? alt="GitHub Workflow Status"/></a> <a href="https://github.com/btcpayserver/prestashop-plugin/blob/6.x/LICENSE"><img src="https://img.shields.io/github/license/btcpayserver/prestashop-plugin?color=brightgreen&amp; alt="GitHub License"/></a> <a href="https://github.com/btcpayserver/prestashop-plugin#contributing"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg? alt="PRs are welcome"/></a> <a href="https://github.com/btcpayserver/prestashop-plugin/graphs/contributors"><img src="https://img.shields.io/github/contributors-anon/btcpayserver/prestashop-plugin? alt="GitHub contributors"/></a> </p> <p> <a href="https://github.com/btcpayserver/prestashop-plugin/releases"><img src="https://img.shields.io/github/v/release/btcpayserver/prestashop-plugin?sort=semver&amp; alt="GitHub release (latest SemVer)"/></a> <a href="https://github.com/btcpayserver/prestashop-plugin/releases"><img src="https://img.shields.io/github/downloads/btcpayserver/prestashop-plugin/total? alt="GitHub all releases"/></a> </p> </div>

<div align="center"> <sub>"This is lies, my trust in you is broken, I will make you obsolete" 💚 </a> </div> <br/>

<p align="center"> <a href="https://github.com/btcpayserver/prestashop-plugin/issues/new/choose">Report a bug</a> · <a href="https://github.com/btcpayserver/prestashop-plugin/discussions/new/choose">Request a feature</a> · <a href="https://docs.btcpayserver.org/FAQ/">FAQ</a> </p>

---

🔧 Requirements

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

• You are using PHP 8.0 or higher
• Your PrestaShop is version 8.0/9.0 or higher.
• Your BTCPay Server is version 1.7.0 or higher
• The PDO, curl, gd, intl, json, and mbstring PHP extensions are available
• You have a BTCPay Server, either self-hosted or hosted by a third party
• You've a registered account on the instance
• You've a BTCPay store on the instance
• You've a wallet connected to your store

Tested successfully

• Prestashop v8.0, v8.0.1, v8.0.4, v8.1.0, v8.1.3, v8.1.4, v8.2.1, v9.0.0
• BTCPay server v1.7.0, v1.7.3.0, v1.12.5, v1.13.0, v1.13.5, v2.1.5, v2.2.1
• BTCPay server v2 is supported as of module version v6.3.0.

Multistore

As of right now the module is not compatible with Prestashop's multistore feature. Any help to resolve this is very much welcomed. Please see the relevant discussion.

📗 Documentation

Please check out our official website, complete documentation and FAQ for more details.

If you have trouble using BTCPay Server, consider joining communities listed on the official website to get help from other contributors. Only create a GitHub issue for technical issues you can't resolve through other channels or feature requests you've validated with other members of the community.

🚀 Quick Start Guide

To get up and running with our plugin quickly, see the PrestaShop Guide on our documentation website.

🧑‍💻 Versioning

We use SemVer for versioning. For the versions available, see the releases within this repository.

🤝 Contributing

BTCPay Server 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 join our community chat or start a GitHub discussion to get early feedback, discuss the best ways to tackle the problem, and ensure there is no work duplication.

🔧 Development

We recommend using PrestaShop Kickstarter (which supports ngrok) and a dockerized BTCPay Server instance (or an online testnet instance) for testing locally.

🏪 PrestaShop Support

PrestaShop support can be found through its official channels.

• Documentation - contains answers to commonly asked questions and provides instructions for almost everything. Including setup, management, etc.
• Support Forums - the official Prestashop forum is a good place to find further answers and ask Prestashop related questions.

📝 License

BTCPay Server software, logo and designs are provided under MIT License.