Skip to main content

PrestaShop

Official dpay.pl payment module for PrestaShop 1.7 and 8.x. Enables accepting online payments in your PrestaShop store. The module supports online refunds, BLIK Level 0, Apple Pay, Google Pay, and an inline card form.

Requirements​

  • PrestaShop 1.7.6 or newer (including PrestaShop 8.x)
  • PHP 7.4 or newer
  • 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 cards (inline)
  • Google Pay and Apple Pay
  • PayPal
  • Paysafecard
  • Installments

Installation​

Method 1 - from the admin panel (recommended)​

  1. Download the latest module version from dpay.pl or from GitHub in .zip format.
  2. Navigate to Modules > Module Manager in the PrestaShop admin panel.
  3. Click Upload a module and select the downloaded .zip file.
  4. After the installation completes, the module will appear on the list as dPay Payment Gateway.

Method 2 - manual installation​

  1. Download and extract the module archive.
  2. Copy the dpaypayment directory to the modules/ folder in the PrestaShop root directory.
  3. Navigate to Modules > Module Manager.
  4. Search for dPay Payment Gateway and click Install.

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. Take note of:
    • Service name (service_name) - unique name of your Payment Point
    • Secret hash (secret_hash) - key used for signing requests
  5. In the Payment Point settings, set the IPN URL to: 
    https://your-store.com/module/dpaypayment/callback
Important

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

Step 2 - Module configuration in PrestaShop​

  1. Navigate to Modules > Module Manager.
  2. Find dPay Payment Gateway and click Configure.
  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
Hide Bank ListHide the bank list on the dpay.pl payment page
BLIK ZeroEnable entering the BLIK code directly in the checkout
Apple PayEnable Apple Pay payments
Google PayEnable Google Pay payments
Credit card (dPay)Enable the inline card form in the checkout
  1. Click Save.

Step 3 - Verification​

  1. Place a test order in your store.
  2. Select Pay with dPay as the payment method.
  3. Verify that you are correctly redirected to the dpay.pl payment page.
  4. After completing the payment, check whether the order status in PrestaShop has changed to Payment accepted.

Refunds​

The module supports online refunds from the PrestaShop admin panel:

  1. Go to the order in Orders > Orders.
  2. Click Partial refund or Standard refund.
  3. Enter the refund amount and confirm the operation.

The refund (full or partial) will be automatically sent to dpay.pl. Refund information will be added as a note to the order.

Status mapping​

dpay.pl statusPrestaShop status
newAwaiting payment
completedPayment accepted
rejectedCancelled

Troubleshooting​

Orders do not change status automatically​

  • Verify that the IPN URL (https://your-store.com/module/dpaypayment/callback) is correctly set in the dpay.pl Dashboard.
  • Make sure the endpoint is publicly accessible and not blocked by a firewall.
  • Check PrestaShop logs in the var/logs/ directory.

"Service name and hash key must be configured" error​

  • Go to the module configuration and make sure the Service Name and Hash Key fields are filled in.
  • Check for any extra spaces before or after the values.

Payment method does not appear in the checkout​

  • Make sure the module is active in Modules > Module Manager.
  • Verify that the order currency is PLN - the module only supports this currency.
  • Go to Payment > Preferences and check whether the dpaypayment module is enabled for the appropriate currencies.

Error during refund​

  • Verify that a dpay.pl transaction exists for this order.
  • Check the logs in var/logs/ for messages with the dPay refund error prefix.

More information​