PTS Stripe - User Guide

Introduction

PTS Stripe is an advanced payment module for PrestaShop that allows you to accept payments through Stripe, one of the safest and most reliable payment processing platforms in the world. The module offers support for more than 17 different payment methods, including credit/debit cards, Apple Pay, Google Pay, PayPal, Klarna, iDEAL and other local payment methods from different regions.

What is PTS Stripe?

PTS Stripe is an advanced payment module for PrestaShop that allows you to accept payments through Stripe, one of the safest and most reliable payment processing platforms in the world. The module offers support for more than 17 different payment methods, including credit/debit cards, Apple Pay, Google Pay, PayPal, Klarna, iDEAL and other local payment methods from different regions.

Key Features

17+ supported payment methods: Offer your customers multiple ways to pay, including international cards, European local methods, digital wallets, "buy now, pay later" (BNPL) methods and cash payment options.
Express Checkout (Express cart): Lets your customers complete purchases quickly using Apple Pay, Google Pay, Link, PayPal, Amazon Pay and Klarna directly from the product, cart and checkout pages.
Integrated payment form: Option to display all available payment methods in a single modern form (Payment Element) fully managed by Stripe.
Modern administration panel: An intuitive, responsive interface with all configuration options organized into thematic sections.
Refunds from the back office: Process full or partial refunds directly from the order detail page without leaving PrestaShop.
Webhook synchronization: Payments stay automatically synchronized through Stripe webhooks (payment confirmation, disputes, refunds, etc.).
Sandbox/test mode: Test all payment methods without processing real transactions by using Stripe's test API keys.
SCA authentication (3D Secure 2): Automatic PSD2 and SCA compliance through Stripe, with no added complexity.
Multi-currency support: Accept payments in any currency supported by Stripe, with automatic handling of zero-decimal currencies.
Detailed logging: Complete information about all transactions and errors available in the PrestaShop logs for debugging and auditing.

Compatibility and Requirements

Module version: 5.1.0
PrestaShop compatibility: 1.7.6 up to 8.x and 9.x
PHP compatibility: 7.2+

Compatible with One Page Checkout (onepagecheckoutps) v4 and v5, including v5.2.0.

Requirement	Minimum	Recommended
PrestaShop	1.7.6 (compatible with 8.x and 9.x)	Latest version
PHP	7.2	8.0+
MySQL	5.7	8.0+
HTTPS	Required	Yes

Installation

To install the PTS Stripe module in your PrestaShop store, follow these steps:

Download the module ZIP file from your PresTeamShop account
In the PrestaShop backoffice, go to Modules → Module Manager
Click "Upload a module" in the top-right corner
Drag the ZIP file or select it from your computer
Wait for the upload and automatic installation to complete
Once installed, click "Configure" to access the module's administration panel

Note: Make sure your store is using HTTPS before configuring the module. Stripe requires secure connections to process payments.

Configuration

The PTS Stripe module is configured from its administration panel, accessible through Modules → Module Manager (in PrestaShop 1.7+). The panel is divided into several thematic sections that group the configuration options.

General

This section groups general module options related to debugging, automatic behavior and event logging.

Debug mode

Enables debug mode for debugging in development environments. When activated, the module logs detailed information about payment flows in PrestaShop logs (Advanced parameters → Logs).

Type: Switch (enable/disable)
Default value: Disabled

IP

Text field to specify the IP address that is allowed to access the module in debug mode. This option is only visible when "Debug mode" is enabled.

Type: Text
Default value: Empty

Note: Includes a button that automatically adds your current IP address.

Enable debug logs

Enables detailed logging of all the module's payment flows. All events (Payment Intent creation, payment confirmation, errors, etc.) are recorded in the Advanced Parameters → Logs section of the PrestaShop back office.

Type: Switch (enable/disable)
Default value: Disabled

Recommendation: Keep it disabled in production to avoid very large log files. Enable it only when you need to debug specific issues.

Auto-refund on credit slip

When you enable this option, the module automatically processes a refund in Stripe each time a credit slip is created in PrestaShop. The refund amount will be equal to the credit slip amount.

Type: Switch (enable/disable)
Default value: Disabled

Stripe

Configuration of the Stripe API keys and webhook secret. This section is essential to connect your PrestaShop store with your Stripe account.

Sandbox mode (test)

Toggles between the test (sandbox) and production (live) API keys. When enabled, all transactions are processed in test mode and Stripe does not apply real charges. Use this option to fully test the module before going live.

Type: Switch (enable/disable)
Default value: Enabled

Public test key

Stripe publishable key for the test environment. It is used on the front end to initialize Stripe.js and create interactive payment elements. Only visible when "Sandbox mode" is enabled.

Type: Password field
Default value: Empty
Format: Must begin with pk_test_
Where to get it: Stripe Dashboard → Developers → API keys

Secret test key

Stripe secret key for the test environment. It is used on the back end to create, confirm and process payments. Only visible when "Sandbox mode" is enabled.

Type: Password field
Default value: Empty
Format: Must begin with sk_test_
Where to get it: Stripe Dashboard → Developers → API keys

Important: Never share this key. Store it securely.

Public live key

Stripe publishable key for production. Only visible when "Sandbox mode" is disabled.

Type: Password field
Default value: Empty
Format: Must begin with pk_live_
Where to get it: Stripe Dashboard → Developers → API keys

Secret live key

Stripe secret key for production. Only visible when "Sandbox mode" is disabled.

Type: Password field
Default value: Empty
Format: Must begin with sk_live_
Where to get it: Stripe Dashboard → Developers → API keys

Important: Never share this key. Store it securely.

Webhook secret

Secret value used to validate the authenticity of the events sent by Stripe. Every webhook received is validated using this secret. If the HMAC signature is invalid, the webhook is rejected.

Type: Password field
Default value: Empty
Format: Begins with whsec_
Where to get it: Stripe Dashboard → Developers → Webhooks → Select your endpoint → Reveal signing secret

Special note: The section displays an information box with the full webhook URL that you must configure in the Stripe dashboard, along with a button to copy it to the clipboard. This URL must be registered in Stripe so the module can receive payment notifications.

Payments

This section configures the payment methods available at your store's checkout. Here you decide which payment options you will offer your customers.

Enable integrated payment form

When you enable this option, all enabled payment methods are displayed in a single modern form (Payment Element) designed and managed by Stripe. When disabled, each payment method is shown as an individual payment option in the PrestaShop checkout.

Type: Switch (enable/disable)
Default value: Disabled

Integrated form design

Defines how the payment methods are visually arranged within the integrated form. Only visible when "Enable integrated payment form" is enabled.

Type: Dropdown selector
Default value: tabs
Available options:

tabs: Payment methods are displayed in horizontal tabs
accordion_radio: Methods are displayed in an expandable accordion with radio buttons to select
accordion: Methods are displayed in an expandable accordion without radio buttons

Integrated form theme

Defines the visual appearance and color scheme of the integrated payment form. Only visible when "Enable integrated payment form" is enabled.

Type: Dropdown selector
Default value: stripe
Available options:

stripe: Stripe's default theme (recommended)
flat: Minimalist, clean theme
night: Dark theme
none: No theme (the form inherits your store's CSS styles)

Individual payment methods

The following switches are available only when "Enable integrated payment form" is disabled. Each switch enables or disables a specific payment method at the checkout.

Per-method restrictions (delivery country and customer group): Enabling any method reveals additional fields to restrict its visibility:

Allowed countries: delivery countries for which the method will be available. Empty = all countries (subject to the method's own availability in Stripe).
Allowed customer groups: PrestaShop customer groups that will see the method. Empty = all groups.

These restrictions apply per method, independently of each method's inherent geographic restrictions (e.g. iDEAL only in the Netherlands). A ⚠ warning indicates that the method requires a Stripe account registered in a specific country (e.g. PIX/Boleto in Brazil, OXXO in Mexico, Affirm in the US/Canada).

Credit/Debit Card

Enables payments with international credit and debit cards (Visa, Mastercard, American Express, Discover, etc.). Includes automatic support for 3D Secure 2 (SCA) when required.

Type: Switch (enable/disable)
Default value: Enabled
Flow: Inline form integrated into the checkout

Show postal code

Displays an additional field to request the customer's postal code when paying by card. This can increase the approval rate in some cases. Only visible when "Credit/Debit Card" is enabled.

Type: Switch (enable/disable)
Default value: Disabled

iDEAL

Redirect payment method that is very popular in the Netherlands. Allows customers to pay by bank transfer from their bank.

Type: Switch (enable/disable)
Default value: Disabled
Flow: The customer is redirected to their bank to complete the payment
Availability: Mainly in the Netherlands and Belgium

Bancontact

Redirect payment method used in Belgium and the Netherlands. Customers complete the payment through their banks.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect to the bank
Availability: Mainly in Belgium

Klarna

"Buy now, pay later" (BNPL) service popular in Europe and the United States. Allows your customers to pay for their purchase in installments through Klarna.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect to Klarna to complete the credit application
Availability: Several European countries and selected U.S. states

EPS

Redirect payment method used in Austria for bank transfers.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect
Availability: Austria

Przelewy24 (P24)

Redirect payment method that is very popular in Poland. It integrates multiple Polish payment options (e-wallets, transfers, etc.).

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect
Availability: Mainly in Poland

BLIK

Mobile payment method used in Poland. The customer enters a 6-digit code generated in their banking app to confirm the payment.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Inline code integrated into the checkout (no redirect required)
Availability: Poland

TWINT

Mobile payment method used in Switzerland. Customers pay by scanning a QR code with their TWINT app.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect
Availability: Switzerland

Afterpay / Clearpay

"Buy now, pay later" (BNPL) service. Available as "Afterpay" in selected European countries and as "Clearpay" in the United Kingdom.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect
Availability: France, Spain, Italy, the Netherlands, Belgium, Germany, the United Kingdom

PayPal

Enables payments via PayPal through the Stripe integration. Customers can use their existing PayPal accounts or complete the payment as a guest.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect to PayPal
Availability: Available in most countries

SEPA Direct Debit

SEPA direct debit for the euro area. Allows customers to pay by providing their IBAN number, which will be charged directly from their bank account.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Inline form integrated into the checkout
Availability: Euro area

Pix

Instant payment method used in Brazil. It generates a dynamic QR code that the customer scans with their banking app to confirm the payment.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Voucher with QR code
Availability: Brazil only

Important restriction: Requires a Stripe account registered in Brazil

OXXO

Cash payment method used in Mexico. It generates a voucher that the customer prints or notes down and pays at any OXXO store.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Voucher
Availability: Mexico only

Important restriction: Requires a Stripe account registered in Mexico

Boleto

Cash payment method used in Brazil. It generates a bank slip that the customer can pay at banks, lottery agents or through online banking.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Downloadable PDF voucher
Availability: Brazil only

Important restriction: Requires a Stripe account registered in Brazil

Multibanco

Bank reference payment method used in Portugal. It generates an entity and reference that the customer pays at ATMs, online banking or bank branches.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Voucher with reference data
Availability: Portugal

Affirm

"Buy now, pay later" (BNPL) service used in the United States and Canada. Allows customers to pay in interest-free installments.

Type: Switch (enable/disable)
Default value: Disabled
Flow: Redirect
Availability: United States and Canada

Important restriction: Requires a Stripe account registered in the United States or Canada

Express Checkout

Express Checkout lets your customers complete purchases quickly and securely using digital wallets and popular payment services. The Express Checkout buttons appear directly on the product, cart and checkout pages.

Product Page — Button Position

Defines where the Express Checkout buttons will be rendered on the product page.

Type: Dropdown selector
Default value: displayProductAdditionalInfo
Available options:

displayProductAdditionalInfo: After the product's additional information
displayAfterProductAddCartBtn: After the "Add to cart" button
displayProductActions: In the product actions area (next to the add-to-cart button)
Custom CSS selector (advanced): Places the buttons next to any element on the page via a CSS selector, ignoring the theme hooks

Note: The first three options depend on the hooks your theme supports. Use the "Custom CSS selector" when none of them renders in the position you need.

CSS selector (advanced)

CSS selector pointing to the element next to which the Express Checkout buttons will be injected. Only visible when "Product Page — Button Position" is set to Custom CSS selector.

Type: Text
Default value: Empty
Example: #add-to-cart-or-refresh .add-to-cart

Test it in your theme's product page DevTools (document.querySelector(...)) to confirm it matches a single element.

Position relative to the element

Defines where to place the buttons relative to the element matched by the CSS selector. Only visible in Custom CSS selector mode.

Type: Dropdown selector
Default value: afterend
Available options:

beforebegin: Before the element
afterbegin: Inside the element, at the start
beforeend: Inside the element, at the end
afterend: After the element (default)

Button Height (px)

Defines the height of the Express Checkout buttons in pixels. Stripe limits this value to between 40 and 55 pixels.

Type: Dropdown selector
Default value: 48
Range: 40 to 55 pixels

Max Columns

Defines the maximum number of columns for displaying the Express Checkout buttons in the grid.

Type: Dropdown selector
Default value: 0 (no limit)
Available options: 0 (unlimited), 1, 2, 3, 4

Max Rows

Defines the maximum number of rows for displaying the Express Checkout buttons in the grid.

Type: Dropdown selector
Default value: 0 (no limit)
Available options: 0 (unlimited), 1, 2, 3, 4

Note: When there are more buttons than fit in the defined grid, an additional overflow menu is shown (see the "Overflow Menu" option).

Overflow Menu

Defines the behavior when there are more payment buttons than the available space allowed by the Max Columns and Max Rows options.

Type: Dropdown selector
Default value: auto
Available options:

auto: Stripe automatically decides whether to show an overflow menu
never: Never shows an overflow menu; it simply hides the buttons that do not fit

Hide carriers

Lets you exclude specific carriers from the wallet modal (Apple Pay / Google Pay). Carriers selected here will not appear in the Express Checkout popup.

Type: Multiple carrier selection
Default value: Empty (all carriers visible)

Use case: Pickup-point carriers that require the customer to choose a physical location, which is not possible inside the native wallet UI. Hiding them prevents the customer from selecting an option they cannot complete correctly from the wallet.

Apple Pay

Enables the Apple Pay button for fast payments. Only available in Safari and on Apple devices.

Type: Switch (enable/disable)
Default value: Enabled

Show as a payment option

In addition to the Express Checkout button, shows Apple Pay as another option inside the checkout payment method list. With the customer already identified and their address selected, they can pay in one tap (1-tap) without re-entering data. Only appears on Apple devices / Safari. Only visible when "Apple Pay" is enabled.

Type: Switch (enable/disable)
Default value: Disabled

Show on Product Page

Displays the Apple Pay button on the product page. Only visible when "Apple Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Cart Page

Displays the Apple Pay button on the cart page. Only visible when "Apple Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Checkout

Displays the Apple Pay button on the checkout page. Only visible when "Apple Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Button Text

Defines the text shown on the Apple Pay button. Only visible when "Apple Pay" is enabled.

Type: Dropdown selector
Default value: check-out
Available options: plain, add-money, book, buy, check-out, contribute, donate, order, reload, rent, subscribe, support, tip, top-up

Button Theme

Defines the color of the Apple Pay button. Only visible when "Apple Pay" is enabled.

Type: Dropdown selector
Default value: black
Available options: black, white, white-outline

Google Pay

Enables the Google Pay button for fast payments in Chrome and other compatible browsers.

Type: Switch (enable/disable)
Default value: Enabled

Show as a payment option

In addition to the Express Checkout button, shows Google Pay as another option inside the checkout payment method list. With the customer already identified and their address selected, they can pay in one tap (1-tap) without re-entering data. Only appears on Chrome and compatible browsers. Only visible when "Google Pay" is enabled.

Type: Switch (enable/disable)
Default value: Disabled

Show on Product Page

Displays the Google Pay button on the product page. Only visible when "Google Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Cart Page

Displays the Google Pay button on the cart page. Only visible when "Google Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Checkout

Displays the Google Pay button on the checkout page. Only visible when "Google Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Button Text

Defines the text shown on the Google Pay button. Only visible when "Google Pay" is enabled.

Type: Dropdown selector
Default value: plain
Available options: plain, book, buy, checkout, donate, order, pay, subscribe

Button Theme

Defines the color of the Google Pay button. Only visible when "Google Pay" is enabled.

Type: Dropdown selector
Default value: black
Available options: black, white

Link by Stripe

Link lets customers pay quickly using payment information saved in Stripe Link. Useful for customers who already have information saved in Stripe.

Type: Switch (enable/disable)
Default value: Enabled

Show on Product Page

Displays the Link button on the product page. Only visible when "Link by Stripe" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Cart Page

Displays the Link button on the cart page. Only visible when "Link by Stripe" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Checkout

Displays the Link button on the checkout page. Only visible when "Link by Stripe" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

PayPal

Enables the PayPal button for fast payments via Express Checkout. Customers can use their PayPal accounts saved in the browser.

Type: Switch (enable/disable)
Default value: Disabled

Show on Product Page

Displays the PayPal button on the product page. Only visible when "PayPal" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Cart Page

Displays the PayPal button on the cart page. Only visible when "PayPal" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Checkout

Displays the PayPal button on the checkout page. Only visible when "PayPal" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Button Text

Defines the text shown on the PayPal button. Only visible when "PayPal" is enabled.

Type: Dropdown selector
Default value: checkout
Available options: paypal, checkout, buynow, pay

Button Theme

Defines the color of the PayPal button. Only visible when "PayPal" is enabled.

Type: Dropdown selector
Default value: gold
Available options: gold, blue, silver, white, black

Amazon Pay

Enables the Amazon Pay button for fast payments using existing Amazon accounts.

Type: Switch (enable/disable)
Default value: Disabled

Show on Product Page

Displays the Amazon Pay button on the product page. Only visible when "Amazon Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Cart Page

Displays the Amazon Pay button on the cart page. Only visible when "Amazon Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Checkout

Displays the Amazon Pay button on the checkout page. Only visible when "Amazon Pay" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Klarna

Enables the Klarna button for fast payments using "buy now, pay later".

Type: Switch (enable/disable)
Default value: Disabled

Show on Product Page

Displays the Klarna button on the product page. Only visible when "Klarna" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Cart Page

Displays the Klarna button on the cart page. Only visible when "Klarna" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Show on Checkout

Displays the Klarna button on the checkout page. Only visible when "Klarna" is enabled.

Type: Switch (enable/disable)
Default value: Enabled

Button Text

Defines the text shown on the Klarna button. Only visible when "Klarna" is enabled.

Type: Dropdown selector
Default value: pay
Available options: pay, continue

Button Theme

Defines the color of the Klarna button. Only visible when "Klarna" is enabled.

Type: Dropdown selector
Default value: dark
Available options: dark, light, outlined

Translation

The Translation section lets you manage the module's translations for the different languages installed in your PrestaShop store.

Functionality: This section is provided by the pts_modulobase framework and offers:

A list of the translation files available for each language
An inline editor with support for multiple languages without reloading the page
Export translations to a file
Import translations from a file
Share translations with the PresTeamShop team for continuous improvement

Note: No additional initial configuration is required.

Code Editors

The Code Editors section lets you edit the module's custom CSS and JavaScript files without modifying the source code.

Functionality: This section is provided by the pts_modulobase framework and offers:

Automatic detection of override files in the views/css/ and views/js/ directories
A code editor with syntax highlighting for better readability
Automatic saving of changes
Changes are stored in the PrestaShop configuration and applied immediately on the front end

Use cases: Customize the module's CSS styles, add custom JavaScript functionality, or modify behaviors without altering the module's original files.

Backups

The Backups section lets you automatically create, restore and manage backups of all the module's settings.

Functionality: This section is provided by the pts_modulobase framework and offers:

Generate new backup: Creates a snapshot of all the PTSS_* settings at that moment
Restore backup: Overwrites the current settings with those of a previous backup
Download backup: Downloads a ZIP file with the backup data
Upload backup: Imports a backup from a previously downloaded ZIP file
Delete backup: Removes backups you no longer need
History: View the history of all backups created, with date and time

Note: Backups are stored in the PrestaShop database in the ptss_backup table. Each backup includes metadata about when it was created and how it was generated (automatic, manual, imported, etc.).

Additional back office features

Stripe panel on the order page

The module adds a tab called "Stripe" on the detail page of every order in the PrestaShop back office (Orders → Orders → [Select order]). This tab displays complete payment information:

Payment details

Charge ID: Unique identifier of the transaction in Stripe, shown as a direct link to the Stripe dashboard for quick verification
Payment method used: Readable name of the method (e.g., "Card", "PayPal", "iDEAL", etc.)
Total amount: Total amount of the processed payment
Refunded amount: Money already returned to the customer through refunds
Amount pending refund: Money that can still be refunded
Mode: A clear indicator of whether the payment was processed in Test or Live mode

Refund form

When there is an amount available to refund, a form is displayed to process refunds:

Numeric field to enter the amount to refund
"Process Refund" button to execute the refund
Real-time validation of the entered amount
Confirmation before processing the refund

Voucher details

For voucher payment methods (Multibanco, OXXO, Boleto, Pix), the tab displays:

Entity/Reference (Multibanco): Data required to make the payment
Voucher number (OXXO): Code to present at OXXO stores
Downloadable PDF (Boleto): Official document to pay at banks
Voucher URL: Link to the original document in Stripe
Expiration date: When the voucher expires

Custom order states

The module creates three additional order states during installation for better management of the payment flow:

Waiting for Stripe payment

Color: Blue
When it is assigned: Automatically to orders with payment methods that require a later action from the customer (vouchers such as Multibanco, OXXO, Boleto, Pix)
Meaning: The order has been created but is waiting for the customer to complete the payment outside PrestaShop

Stripe partial refund

Color: Red
When it is assigned: Automatically when a partial refund is processed in the Stripe tab
Meaning: Part of the money has been returned to the customer, but there is still an amount left to refund

Stripe disputed payment

Color: Dark red
When it is assigned: Automatically when Stripe reports a dispute or chargeback via webhook
Meaning: The customer has disputed the charge with their bank and it is under investigation

Webhooks

The module automatically listens for the following Stripe webhook events to keep the payment status synchronized between Stripe and PrestaShop:

charge.succeeded: Confirms that the charge completed successfully and marks the payment/order as paid
charge.failed: Marks the payment as failed and sets the order status to error
charge.expired: Marks the payment as canceled when the charge expires
charge.dispute.created: Marks the order as disputed when the customer opens a dispute with their bank
payment_intent.succeeded: Confirms the payment for delayed payment methods (Multibanco, OXXO, Boleto, Pix) when the customer completes the voucher
payment_intent.payment_failed: Marks the payment as failed for delayed payment methods when the voucher expires or the payment fails definitively

The module only processes events carrying the pts_stripe marker in their metadata; events from other integrations are safely ignored.

Webhook URL: It is shown in the "Stripe" section with a button to copy it to the clipboard. You must register this URL in your Stripe dashboard under Developers → Webhooks.

Security validation: Every webhook received is validated through an HMAC signature using the "Webhook secret" you configured. If the signature does not match, the webhook is automatically rejected.

Payment flows

Standard payment flow (card, Apple Pay, Google Pay, Link)

The customer selects the payment method at the checkout
A Payment Intent is generated in Stripe (it may be pre-generated in the background)
The customer completes the payment directly in the form (no redirect)
Stripe processes the payment and notifies the module
The module validates the notification and automatically creates the order in PrestaShop

Redirect flow (iDEAL, PayPal, Klarna, etc.)

The customer selects a method that requires a redirect
The module creates a Payment Intent with a configured return_url
The customer is redirected to the provider (bank, PayPal, etc.)
The customer completes the payment on the provider's site
The provider redirects back to PrestaShop with the payment result
The module validates the result and creates the order

Voucher flow (OXXO, Boleto, Multibanco, Pix)

The customer selects a voucher method
The module generates the Payment Intent and retrieves the voucher data
The information is shown to the customer (code, download URL, etc.)
The customer completes the payment outside PrestaShop using the voucher
Stripe notifies the module when the payment is received (via webhook)
The module updates the order status to completed

Security

PTS Stripe implements several layers of security:

HTTPS required: All connections with Stripe are made over HTTPS
PCI DSS compliance: Stripe handles all card data processing
HMAC validation: All webhooks are validated using the secret signature
SCA/3D Secure 2: Strong customer authentication automatically managed by Stripe
Detailed logs: All events are logged for auditing and debugging
Sandbox mode: Full testing without processing real money

Important: Make sure your server has a valid SSL certificate installed and that your store is accessible only through HTTPS before enabling the module in production.

Zero-decimal currencies

Stripe requires special handling for certain currencies that have no decimals. The module handles these currencies automatically:

BIF, CLP, DJF, GNF, JPY, KMF, KRW, MGA, PYG, RWF, UGX, VND, VUV, XAF, XOF, XPF

Note: No special configuration is needed; the module automatically detects the PrestaShop currency and adjusts the currency calculations accordingly.

Common issues

"Connection error" or "Cannot connect to Stripe"

Verify that your API keys are correct and entered in the appropriate section (test or live)
Make sure you are using HTTPS (required by Stripe)
Verify that the server can make outbound connections to api.stripe.com

Payments are created but orders are not generated

Verify that debug logs are enabled: General → Enable debug logs
Review the PrestaShop logs: Advanced Parameters → Logs
Make sure the Webhook secret is configured correctly
Verify that the webhook URL is registered in Stripe

The Express Checkout buttons do not appear

Verify that at least one Express Checkout method is enabled (Apple Pay, Google Pay, etc.)
Check that you are using the correct browser (Apple Pay requires Safari, Google Pay requires Chrome)
In test mode, they only appear in compatible browsers/devices

Refunds are not processed

Verify that the "Auto-refund on credit slip" option is configured correctly
Make sure the transaction in Stripe can be refunded (not all methods support full refunds)
Review whether there is an amount available to refund

Contact and support

For additional help:

Help center: https://helpcenter.presteamshop.com/portal/en/kb/pts-stripe
Report issues: Use the support form on your PresTeamShop module page
Technical documentation: See the CLAUDE.md file included in the module for architectural details

Note: For specialized technical support, always include information about your PrestaShop and PHP versions and the relevant module logs.