Skip to main content

WooCommerce

Official dpay.pl plugin for WooCommerce. Enables accepting online payments in your WordPress + WooCommerce store without writing any code. Supports WooCommerce Blocks.

Requirements​

  • WordPress 6.0 or newer
  • WooCommerce 8.0 or newer (including WooCommerce 10)
  • 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 (BLIK BNPL)

Installation​

Method 1 - from the WordPress repository (recommended)​

  1. Navigate to Plugins > Add New in the WordPress admin panel.
  2. Search for dpay.pl in the plugin search.
  3. Click Install, then Activate.

Method 2 - manual installation from a ZIP file​

  1. Download the latest plugin version from dpay.pl or from GitHub.
  2. Navigate to Plugins > Add New > Upload Plugin.
  3. Select the downloaded .zip file and click Install.
  4. After the installation completes, click Activate Plugin.

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/?wc-api=dpay_ipn
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 WordPress​

  1. Navigate to WooCommerce > Settings > Payments.
  2. Find dpay.pl on the list and click Manage.
  3. Fill in the configuration form:
FieldDescription
Enable/DisableCheck to activate the payment gateway
TitlePayment method name visible to the customer (e.g., Online payment - dpay.pl)
DescriptionDescription displayed on the order page
Service nameService name from the dpay.pl Dashboard
Secret hashSecret hash from the dpay.pl Dashboard
Test modeEnable to use the sandbox environment
  1. Click Save changes.

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 payment page.
  4. After completing the payment, check whether the order status in WooCommerce has changed to Paid.

Refunds​

The plugin supports online refunds directly from the WooCommerce admin panel:

  1. Go to the order in WooCommerce > Orders.
  2. Click Refund.
  3. Enter the refund amount and confirm.

The refund will be automatically sent to dpay.pl.

Status mapping​

dpay.pl statusWooCommerce status
newPending
completedPaid
rejectedCancelled

Troubleshooting​

Orders do not change status automatically​

  • Verify that the IPN URL is correctly set in the dpay.pl Dashboard.
  • Make sure the IPN URL is publicly accessible (not blocked by a firewall).
  • Check WooCommerce logs: WooCommerce > Status > Logs.

"Invalid checksum" error​

  • Make sure the Secret hash in the plugin settings matches the hash in the dpay.pl Dashboard.
  • Check for any extra spaces before or after the hash value.

Redirect is not working​

  • Make sure the plugin is enabled in WooCommerce > Settings > Payments.
  • Verify that the Service name is correct.

More information​