How to install the Core Checkout payment module on your PrestaShop store

Your PrestaShop store accepts card payments in under an hour. This guide covers installation, testing in the sandbox environment, then going live.

Before you start

You need admin access to your PrestaShop back office and a store that is already created.
If you have no technical resource in house, a web agency can handle the installation. The steps below can also be completed on your own.

On our side, we provide:

• The Core Checkout module .zip file (download here)
• A Core Payment sandbox access, for testing (contact us)
• A Core Payment production access, once your payment account is validated

Step 1: install the module

1. In your PrestaShop back office, go to Modules then Module Manager
2. Click Upload a module at the top of the page
3. Drop the Core Checkout module.zip file

The module installs in a few seconds. It runs in two modes, Sandbox and Production, which you can switch at any time.

Step 2: connect your sandbox account

• Request a sandbox access from your Core contact. You will receive an email to set your password.
• In Modules then Module Manager, click Configure on the Core Checkout module.

General card

• Mode: leave on Sandbox for testing
• Display title: the payment method name as your customers will see it at checkout
• Payment display mode: choose how the payment page is displayed
• • iFrame: payment is embedded directly in your checkout page, the customer never leaves your store
  • Redirect: the customer is redirected to the payment page, then sent back to your store
  • Hosted: the payment page opens in a new window
• Enable saved cards: lets logged-in customers securely save their card for one-click checkout and manage it from their customer account
• Debug logging: logs Core Checkout API requests and responses to the PrestaShop log. Leave off in production
• Callback URL: copy this URL, you will paste it into your Core Payment dashboard in the next step

Register the Callback URL in your dashboard

This URL allows your store to automatically receive the result of every payment.

1. Log in to https://sandbox-dashboard.corebycarlo.com/partner/configuration, or go to Developer then Configuration
2. Click Webhooks in the top right corner
3. Paste the copied URL into the Endpoint URL field
4. Click Save

Sandbox card

• Email: your login email for the Core Payment sandbox dashboard
• Password: your login password for the sandbox dashboard
• API key: in your dashboard, go to Developer then Configuration, click API key, copy the key and paste it here
• Click Test credentials and Save.

Step 3: test your payments

Place a test order on your store. Real cards do not work in sandbox. Use the test cards below with any cardholder name, any 3-digit CVV and any future expiry date.

• The full list of test cards is available in our documentation.
• Then check that the order appears in your PrestaShop back office and that the transaction appears in your Core Payment dashboard. This is the test that confirms the Callback URL is correctly registered.

Step 4: go live

To accept real payments, your payment account must be opened:

1. We create your payment account
2. You sign the terms and conditions
3. You provide us the company details and documents (KY)
4. Once your file is validated, we notify you and you receive an email to set the password for your production account

Then go back to Modules, Module Manager, Configure on Core Checkout.

Production card

• Email: your login email for the Core Payment production dashboard
• Password: your login password for the production dashboard
• API key: in your production dashboard, Developer then Configuration, API key, copy the key and paste it here
• Click Test credentials and Save.

Remember to also register the Callback URL in your production dashboard, as in step 2.
Finally, go back to the General card and switch Mode to Production.

✅ Your store is now accepting real payments.

• Make a first payment with your own card to validate the full journey end to end.
• You can cancel it from your dashboard.

Updated on: 06/10/2026