How to Accept Bitcoin Payments on PrestaShop
PrestaShop merchants often sell across borders in EUR while their customers hold crypto. A hosted-invoice integration keeps the catalogue priced in EUR and lets PayCryptoHost quote the crypto amount at payment time, with the funds arriving in the merchant's own wallet.
- Integration method
- REST API
- Time needed
- About 30 minutes
- Skill level
- Intermediate
Before you start
- •A free PayCryptoHost account.
- •Your Bitcoin extended public key (xPub / zPub) from a wallet you control — Sparrow, Electrum, BlueWallet, Trezor or Ledger all export one.
- •Admin access to your store or billing panel.
- •PrestaShop 8.x and access to install a custom module.
An extended public key only lets software watch addresses and derive new ones — it can never move funds. Never paste a private key or seed phrase anywhere, including here.
Step-by-step setup
- 1
Set up PayCryptoHost
Verify your xPub and create an API key.
- 2
Build a payment module
Hook paymentOptions to display the crypto option, and create the invoice from the validation controller.
- 3
Redirect to the invoice
Send the buyer to the hosted payment page returned by the API.
- 4
Consume the webhook
Set the order state to Payment accepted when the confirmed webhook arrives and the signature validates.
- 5
Verify with a live test
Place a small order and confirm the order state and the invoice both settle.
What you get
- •EUR-priced catalogue with crypto settlement to your wallet.
- •No processor payout schedule or minimum withdrawal.
- •Signed webhooks for reliable order state changes.
- •No per-transaction revenue share with a middleman.
Troubleshooting
Payment option not visible at checkout
PrestaShop hides payment modules that are not enabled for the customer's country or currency group. Check the module's carrier and country restrictions.
Order stuck in Awaiting payment
Confirm the webhook URL is publicly reachable and not behind maintenance mode, which blocks front-controller requests.
Frequently asked questions
Can PrestaShop accept crypto without KYC on the merchant?
PayCryptoHost does not require merchant KYC because it never holds your funds — but you remain responsible for your own local tax and reporting obligations.
Which coins can I offer?
BTC, ETH and USDT among others; you choose which appear on the invoice.
Ready to take your first crypto payment?
Create an account, add your xPub, and send a test invoice — most merchants are live the same day.
Other platform guides
See all platform integrations, browse industry guides, or compare us against other gateways.