OpenCart: complete setup and operating guide
Features, installation, checkout settings, daily payment operations, testing, troubleshooting and limitations
The basics
An OpenCart extension is the store add-on that enables a Paypercut payment option. You still need to connect it to the correct merchant environment.
At a glance: what this integration supports
OpenCart supports Embedded or Redirect checkout, a statement descriptor, wallet settings, test/production mode and webhook status updates. The integration supports OpenCart 2.x, 3.x and 4.x.
Install and activate
- In OpenCart Admin go to Extensions → Marketplace, find Paypercut Payment Gateway and install it; alternatively upload the supplied extension through Extensions → Installer.
- Open Extensions → Modifications (or the equivalent Maintenance screen), select Refresh, and clear cache if available.
- Open Extensions → Extensions, choose Payments, edit Paypercut Payment Gateway, set Status to Enabled and Save.
Configure checkout and wallets
- Paste your sandbox API key, set Mode to Test and use Test connection.
- Choose Embedded to keep checkout on the store page, or Redirect to send buyers to Paypercut’s hosted page.
- Set a recognizable statement descriptor; enable Apple Pay and/or Google Pay only if supported for your selected checkout and configured domain.
- Check Geo Zone settings if you restrict where this method appears.
Connect payment-status updates
- In your Paypercut OpenCart extension, locate the payment-notification configuration.
- Make a Sandbox test payment and check whether its order status updates automatically.
- If payment succeeds but the order remains unpaid, ask your OpenCart administrator to verify the notification setup using the official integration guide.
Test and activate live payments
- Place a test order and pay with a sandbox card.
- Confirm payment succeeded, OpenCart order status changed and the customer return page works.
- Switch to Production, replace the key, check webhooks and complete a small real transaction.
Additional features and limitations
The OpenCart extension supports Embedded and Redirect modes, optional Apple Pay/Google Pay settings and a statement descriptor.
Set up
- Open Extensions → Extensions → Payments → Paypercut Payment Gateway → Edit.
- Set Status to Enabled and check Geo Zone settings.
- Choose Embedded or Redirect, then configure wallet switches if applicable.
- Set the statement descriptor, save and refresh Modifications if needed.
- Place a test order to confirm checkout and order status.
Common problems
If Paypercut does not appear at checkout, verify Enabled, Geo Zone and refreshed Modifications. If the connection fails, check the key and environment. If an order remains unpaid, check the webhook URL and server security.
Missing wallet or payment option?
Check status, Geo Zone, modification refresh, correct API key and test/production mode. Wallet buttons also depend on eligible devices and any required domain setup.
Official Paypercut documentation
For advanced configuration and technical details, see the official Paypercut documentation.
Related guides
- Test payments before going live
- Find, check and investigate a payment
- Refund a payment and solve refund problems
- Why are paid orders not updating?
Need more help?
Find the right support contact for your question.

