Skip to main content

Shopware 6

Official dpay.pl payment plugin for Shopware 6. Enables accepting online payments in your Shopware store. The plugin registers two payment methods - standard dpay.pl and BLIK - and supports per-sales-channel configuration.

Requirements​

  • Shopware 6.5 or 6.6
  • PHP 8.1 or newer
  • Active account in the dpay.pl Dashboard with a configured Payment Point

Supported payment methods​

  • BLIK (including BLIK Level 0 - inline, registered as a separate payment method)
  • Bank transfers (pay-by-link)
  • Credit cards (inline)
  • Google Pay and Apple Pay
  • PayPal
  • Paysafecard
  • Installments

Installation​

Method 1 - Composer (recommended)​

  1. In the Shopware root directory, run: 
    composer require dpay/shopware-payment
  2. Refresh the plugin list and install: 
    bin/console plugin:refresh
    bin/console plugin:install --activate DPayShopwarePayment
    bin/console cache:clear

Method 2 - manual installation​

  1. Download the latest plugin version from dpay.pl or from GitHub.
  2. Extract the archive to the custom/plugins/DPayShopwarePayment/ directory.
  3. Refresh the plugin list and install: 
    bin/console plugin:refresh
    bin/console plugin:install --activate DPayShopwarePayment
    bin/console cache:clear

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/dpay/webhook
Important

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

Step 2 - Plugin configuration in Shopware​

  1. Navigate to Extensions > My extensions in the admin panel.
  2. Find dPay.pl Payment Plugin and click Configure.
  3. Fill in the configuration form:
FieldDescription
Payment Point 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
Enable BLIK Zero (inline code)Enable entering the BLIK code directly in the checkout
Enable Apple PayEnable Apple Pay payments
Enable Google PayEnable Google Pay payments
Enable inline card formEnable the inline credit card form in the checkout
  1. Click Save.
  2. Navigate to Settings > Shop > Payment methods and activate the dPay.pl and dPay.pl BLIK methods for the desired sales channels.

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, check whether the order status in Shopware has changed to Paid.

Refunds​

Refunds are processed through dpay.pl after a refund request is submitted in the Shopware admin panel. To issue a refund:

  1. Go to the order in Orders > Overview.
  2. Change the payment status to Refunded or Partially refunded.
  3. The refund will be automatically sent to dpay.pl.

Status mapping​

dpay.pl statusShopware status
newPending (Open)
completedPaid
rejectedCancelled

Troubleshooting​

Orders do not change status automatically​

  • Verify that the IPN URL (https://your-store.com/dpay/webhook) is correctly set in the dpay.pl Dashboard.
  • Make sure the webhook endpoint is publicly accessible.
  • Check Shopware logs in var/log/ - look for entries with the [dPay] prefix.

Payment methods do not appear in the checkout​

  • Navigate to Settings > Shop > Payment methods and verify that the dpay.pl methods are active.
  • Make sure the payment methods are assigned to the appropriate sales channel.
  • Verify that the channel currency is PLN.

Configuration error​

  • Make sure the Payment Point name and HASH key fields are correctly filled in.
  • After changing the configuration, clear the cache: bin/console cache:clear.

Plugin does not install​

  • Verify that the Shopware version is 6.5 or 6.6.
  • Make sure PHP version is 8.1 or newer.
  • Run bin/console plugin:refresh before installation.

More information​