PrestaShop
Last updated: March 15, 2023
From downloading the plugin to requesting your first test payment, learn how to get started with the Checkout.com for PrestaShop plugin. This guide assumes that you have already installed PrestaShop.
Minimum requirements
In order to use this plugin, the minimum required versions are:
- PrestaShop: 1.7.0
- Checkout.com's plugin: 2.3.5
Supported features
- 3D Secure 2.0
- Apple Pay payments
- Deferred payments (authorization and capture as a 2-step process) based on a time delay or an order status change
- Dynamic descriptors
- Frames
- Google Pay payments
- Invoice generation
- Manual capture, refund, and partial refund from the PrestaShop admin dashboard
- Multi-store / currency support
- Notifications (webhooks) for payment flow management
- Refund, void, capture, partial refund, and partial capture from the Dashboard
- Risk management
- Saved cards (stored credit cards)
Before you start
Get your API keys
To set up our PrestaShop plugin, you'll need 2 API keys: a secret key and a public key. You can create your secret and public keys in the Dashboard.
Install the plugin
- Download the latest release of our plugin from GitHub.
- Sign in to your PrestaShop admin dashboard and go to Modules > Module Manager.
- Select Upload a module and drop the
.zip
file into the window that pops up. - If successful, you'll get a
Module installed!
message. - Select Configure to start setting up the plugin.
Configure the plugin
- Sign in to your PrestaShop admin dashboard and go to Modules > Module Manager.
- Find the Checkout.com plugin and select Configure.
- Set Service to NAS.
- Select the Environment you want. Select Sandbox if you want to start testing payments.
- Enter your secret key and public key. If you're testing, make sure you use the API keys from your sandbox Dashboard account.
- Select Set webhook to automatically register your webhooks in the Dashboard, then select Save.
- Go the the CARD PAYMENTS tab and set Enable Card Payments to Yes.
- Select the Type of payment:
- With Immediate (Authorize and Capture), the charge is both authorized and captured (that is, the money due from the customer's account is moved into your account) at the same time.
- With Deferred (Authorize), the charge is only authorized. You'll either have to capture the payment manually or configure an event that will trigger the capture.
- Select Save.
That's it! You're ready to start testing card payments.
Test your integration
- Go to your storefront and add a product to your cart.
- Go to your cart and proceed to checkout.
- Enter the required billing details. We recommend using a real email address so you can receive the order confirmation.
- Select Pay by Card with Checkout.com.
- Enter the following card details:
- Number:
4242 4242 4242 4242
- Expiry date: any future date
- CVV:
100
- Number:
- Agree to the terms of service and select Order with an obligation to pay. You'll be redirected to an order confirmation page. If you entered a real email address in the billing details, you'll also receive an order confirmation email.
- Sign in to your PrestaShop admin dashboard and go to Order settings > Order settings. Your test order will be displayed there with a
Payment accepted
status, indicating that the payment was successfully captured. The transaction will also appear in the Payments section of your sandbox Dashboard account.
Tip
You can now either go live as-is or extend your configuration.
Troubleshooting
If this test does not work, first check you have configured your webhooks correctly. If you have configured them properly, check your server: if it's password-protected or it restricts unfamiliar IP addresses, it may be blocking webhook notifications. Contact our Support team at support@checkout.com if you need help.
Further testing
You'll find more test cards and a range of scenarios to trigger in our testing guide.
Go live
If you're happy with the outcome of your testing and want to start taking payments right away, please contact our Sales team in order to move to a live account.
Note
Before you go live, remember to:
- Switch the environment to Live in the plugin's settings.
- Update your secret and public API keys in the plugin's settings with the keys from your live Dashboard account.
Extend your configuration
You can extend your configuration to add more payment methods, use 3D Secure payments, and more.