Skip to main content

OpenCart

Official dpay.pl payment extension for OpenCart 4.x. Delivered in OCMOD format, it enables online payment acceptance in your OpenCart store. Supports BLIK Level 0, Apple Pay, Google Pay, inline card form, and refunds from the admin panel.

Requirements​

  • OpenCart 4.x
  • PHP 8.0 or newer
  • An active account in the dpay.pl Dashboard with a configured Payment Point

Supported Payment Methods​

  • BLIK (including BLIK Level 0 - inline)
  • Bank transfers (pay-by-link)
  • Credit/debit cards (inline)
  • Google Pay and Apple Pay
  • PayPal
  • Paysafecard
  • Installments

Installation​

Method 1 - From the admin panel (recommended)​

  1. Download the latest extension version from dpay.pl or GitHub in .ocmod.zip format.
  2. Go to Extensions > Installer in the OpenCart admin panel.
  3. Click Upload and select the downloaded file.
  4. After installation is complete, go to Extensions > Extensions > Payments.
  5. Find dpay.pl - Payment Gateway and click Install (green + button).

Method 2 - Manual installation​

  1. Download and extract the extension archive.
  2. Copy the contents of the admin/, catalog/, and system/ directories to the corresponding directories in your OpenCart installation.
  3. Copy the dpay.ocmod.xml file to the OpenCart root directory.
  4. Go to Extensions > Extensions > Payments and install dpay.pl - Payment Gateway.

Configuration​

Step 1 - Prepare credentials in the dpay.pl Dashboard​

  1. Log in to the dpay.pl Dashboard.
  2. Go to the Payment Points section.
  3. Create a new Payment Point or select an existing one.
  4. Note down:
    • Service name (service_name) - the unique name of your Payment Point
    • Secret hash (secret_hash) - the key used to sign requests
  5. In the Payment Point settings, set the IPN URL to: 
    https://your-store.com/index.php?route=extension/dpay/payment/dpay|callback
Important

The secret hash should be treated like a password. Never share it publicly or include it in frontend code.

Step 2 - Configure the extension in OpenCart​

  1. Go to Extensions > Extensions > Payments.
  2. Find dpay.pl - Payment Gateway and click Edit (blue pencil button).
  3. Fill in the configuration form:
FieldDescription
Service NameService name from the dpay.pl Dashboard
Hash KeySecret hash from the dpay.pl Dashboard
Enable PayPalEnable PayPal payments
Enable Credit CardEnable credit card payments
Enable PaysafecardEnable Paysafecard payments
Enable InstallmentsEnable installment payments
Disable Bank TransfersDisable bank transfers and pay-by-link
BLIK ZeroEnable entering a BLIK code directly in the checkout
Apple PayEnable Apple Pay payments
Google PayEnable Google Pay payments
Inline Card FormEnable the inline card form in the checkout
Order StatusOrder status after a successful payment
Failed StatusOrder status after a failed payment
StatusEnable/disable the extension
Geo ZoneRestrict availability to a specific geographic zone
Sort OrderDisplay order for the payment method
  1. Click Save (floppy disk icon in the top right corner).

Step 3 - Verification​

  1. Place a test order in your store.
  2. Select dpay.pl as the payment method.
  3. Verify that you are correctly redirected to the dpay.pl payment page.
  4. After completing the payment, verify that the order status in OpenCart has changed according to the settings.

Refunds​

The extension supports online refunds from the OpenCart admin panel:

  1. Go to the order in Sales > Orders.
  2. In the order details, find the dpay.pl section.
  3. Click Refund and enter the amount (optional - an empty field means a full refund).
  4. Confirm the operation.

The refund (full or partial) will be automatically sent to dpay.pl.

Status Mapping​

dpay.pl StatusOpenCart Status
newPending
completedComplete (configurable)
rejectedFailed (configurable)

Troubleshooting​

Orders do not change status automatically​

  • Verify that the IPN URL is correctly configured in the dpay.pl Dashboard.
  • Make sure the endpoint is publicly accessible and not blocked by a firewall or .htaccess rules.
  • Check the OpenCart logs in the system/storage/logs/ directory.

Extension does not appear in the payment list​

  • Make sure the dpay.ocmod.xml file is properly installed.
  • Go to Extensions > Installer and verify that the extension is on the installed list.
  • Clear the cache: Dashboard > blue circle button (refresh modifications).

Permission error​

  • Go to System > Users > User Groups and add access and modify permissions for extension/dpay/payment/dpay.

Payment method does not appear in the checkout​

  • Verify that the extension is enabled (the Status field is set to Enabled).
  • Make sure the availability is not restricted to a geographic zone that does not include the customer.

More Information​