PrestaShop: complete setup and operating guide

Features, installation, checkout settings, daily payment operations, testing, troubleshooting and limitations

The basics
A payment module is an add-on that lets your PrestaShop store accept payments through Paypercut. Its API key authorises the connection; a webhook reports payment results back to the store.

At a glance: what this integration supports

The PrestaShop plugin supports Hosted and Embedded checkout, configurable Apple Pay and Google Pay for Embedded checkout, a statement descriptor, a successful-payment order status and automatic payment-status updates via webhooks. The integration supports PrestaShop 1.7, 8 and 9.

Install the module

  1. Download the current Paypercut PrestaShop .zip from the official release link in the technical setup guide.
  2. In PrestaShop Admin open Modules → Module Manager → Upload a module.
  3. Upload the .zip. Once installed, find Paypercut Payments and select Configure.

Connect and configure payments

  1. Paste your Paypercut sandbox API key in API Configuration; choose Test connection.
  2. Choose Hosted to send customers to a Paypercut payment page or Embedded to keep the form in your shop.
  3. If using Embedded checkout, enable Apple Pay and/or Google Pay as required; confirm domain verification and device eligibility before announcing wallet support.
  4. Set a statement descriptor, the short name a customer sees on a bank statement. The documentation limits it to 22 characters.
  5. Choose Success Order Status, normally Payment accepted, and save.

Keep PrestaShop orders in sync

Under Webhooks choose Create Webhooks. A webhook is a secure notification from Paypercut to your shop. Without it a payment may succeed while the shop continues to show an unpaid order.

Test and launch

  1. Enable optional debug logging in the General tab so technical failures can be traced.
  2. Create an order in the store and pay with a Paypercut sandbox test card.
  3. Confirm the order becomes Payment accepted (or your selected successful status), and the payment appears in Paypercut.
  4. Switch to a live key when approved, save settings and make one small real payment.

Additional payment options

The PrestaShop payment module covers card payments and supported wallet checkout options. For any additional payment capability, contact Paypercut before advertising it to customers.

turn on Apple Pay and Google Pay

Apple Pay and Google Pay can be enabled for eligible Embedded checkout payments. Open Paypercut Payments in your PrestaShop module settings, enable the wallets you want and test checkout on a compatible device.

Enable wallets

  1. Open Modules → Module Manager → Paypercut Payments → Configure.
  2. Set Checkout Mode to Embedded.
  3. Enable Apple Pay and/or Google Pay in Payment settings.
  4. Check any requested domain verification and save settings.
  5. Open your checkout on an eligible device and verify the button appears and payment succeeds in sandbox.

Set the descriptor

  1. Open Paypercut Payments → Configure.
  2. Enter the name you want customers to recognize on their bank statement in Statement descriptor (up to 22 characters).
  3. Save the settings.

Choose the paid order status

  1. Set Success Order Status, typically Payment accepted.
  2. Use Create Webhooks in the Webhooks tab.
  3. Run a sandbox order and confirm the expected status appears after payment.

If an order stays unpaid

Check the payment in Paypercut and verify that webhooks were created and are reachable. A webhook communicates the outcome automatically from Paypercut to your store.

When it does not appear

Confirm Embedded mode, device compatibility, wallet setup and domain verification. A missing button on an unsupported device is not necessarily an integration error.


Official Paypercut documentation

For advanced configuration and technical details, see the official Paypercut documentation.

Open documentation


Need more help?

Find the right support contact for your question.

Contact support