PrestaShop
Install and configure the Cardencer module for PrestaShop 8 and 9: embedded card checkout with automatic SCA handling.
The Cardencer module adds card, Apple Pay and Google Pay payments to your PrestaShop checkout. The payment form is embedded in your store and 3D Secure (SCA) is handled automatically.
Requirements#
- PrestaShop 8.0 to 9.x
- HTTPS on your store
1. Install the module#
- Get the latest Cardencer module package (
.zip) from Cardencer support. - In the back office, go to Modules → Module Manager → Upload a module and drop the file.
- Click Configure when the installation finishes.
2. Configure the module#
Copy your keys from API keys in the dashboard, then fill in the module settings:
| Setting | Value |
|---|---|
| Enabled | Yes. |
| Checkout title | The label customers see, for example Card, Apple Pay or Google Pay. |
| Secret API key | Your full snd_… or prd_… key. Used server-to-server only and encrypted at rest. |
| Publishable key | Your pk_snd_… or pk_prd_… key. Test publishable keys only work with test secret keys. |
| Business profile ID | Your profile ID. |
| Capture method | Automatic, or Manual (capture later) to authorize at checkout and capture when you ship. |
| Enable webhooks | Yes. |
| Webhook signing key | Your webhook signing key. |
Leave API base URL and SDK loader URL at their defaults (https://api.cardencer.com and the Cardencer SDK loader) in production. To test, set API base URL to https://sandbox.cardencer.com.
Click Save. The module refuses to activate payments if the secret and publishable keys belong to different environments.
3. Register the webhook URL#
The configuration page shows the module's Webhook URL. Send it to Cardencer support, specifying sandbox or live, so it is registered on your business profile. Webhooks keep order states correct even if a customer closes the browser before returning to your store.
4. Test a payment#
Place an order with sandbox keys and pay with 4242 4242 4242 4242, any future date and any CVC. The order is marked paid and the payment appears in the Cardencer dashboard. See Sandbox & test cards for declines and 3D Secure.
Go live#
Switch to your prd_ and pk_prd_ keys and the live webhook signing key, reset API base URL to its default, and register the webhook URL for live. See Going live.