Skip to main content

CS-Cart

Official dpay.pl add-on for CS-Cart. Enables online payment acceptance in an online store powered by the CS-Cart platform. Supports bank transfers, credit/debit cards, PayPal, Paysafecard, and installments.

Requirements​

  • CS-Cart 4.10.1 or newer
  • PHP 7.4 or newer
  • An active account in the dpay.pl Dashboard with a configured Payment Point

Supported Payment Methods​

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

Installation​

  1. Download the add-on files from dpay.pl or GitHub.
  2. Copy the package contents to the CS-Cart root directory, preserving the directory structure:
    • app/addons/dpay/ - add-on files (addon.xml, payments, controllers, lib)
    • design/backend/templates/addons/dpay/ - admin panel templates
    • design/themes/responsive/templates/addons/dpay/ - frontend templates
    • js/addons/dpay/ - JavaScript files
    • var/langs/pl/addons/dpay.po - Polish translations
    • var/langs/en/addons/dpay.po - English translations
  3. Log in to the CS-Cart admin panel.
  4. Go to Add-ons > Manage add-ons.
  5. Find dpay.pl on the list 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. 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?dispatch=payment_notification.dpay&mode=ipn
Important

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

Step 2 - Configure the payment method​

  1. Go to Administration > Payment methods in the CS-Cart admin panel.
  2. Click + (add a new payment method).
  3. On the General tab, set:
    • Name - the name visible to the customer (e.g., Online payment - dpay.pl)
    • Processor - select dpay.pl
  4. On the Configure tab, fill in the form:
FieldDescription
Payment Point nameService name from the dpay.pl Dashboard
HASH keySecret hash from the dpay.pl Dashboard
PayPalEnable/disable PayPal payments
Credit cardsEnable/disable card payments
PaysafecardEnable/disable Paysafecard payments
InstallmentsEnable/disable installment payments
No banksHide the bank list
BLIK ZeroEnable BLIK Level 0 payments (inline)
Apple PayEnable Apple Pay payments
Google PayEnable Google Pay payments
Inline cardEnable the inline card form
Status after paymentOrder status after a successful payment
Status after errorOrder status after a failed payment
  1. Save the configuration.

Step 3 - Verification​

  1. Place a test order in the 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, verify that the order status in CS-Cart has changed to the configured paid status.

Refunds​

The add-on does not support automatic refunds from the CS-Cart admin panel. Refunds should be processed directly from the dpay.pl Dashboard or via the dpay.pl API.

Status Mapping​

dpay.pl StatusCS-Cart Status
New transactionOpen (O)
completedProcessed (P) or configured status
Payment errorFailed (F)

Troubleshooting​

Orders do not change status automatically​

  • Verify that the IPN URL is correctly configured in the dpay.pl Dashboard.
  • Make sure the dispatch=payment_notification.dpay&mode=ipn endpoint is publicly accessible.
  • Check the CS-Cart logs in the var/logs/ directory.

Currency error​

  • The add-on supports PLN currency only. Make sure the order currency is PLN.

Error "BAD SIGNATURE"​

  • Make sure the HASH key in the payment method configuration matches the hash in the dpay.pl Dashboard.

Add-on does not appear in the processor list​

  • Verify that the dpay add-on is installed and active in Add-ons > Manage add-ons.
  • Make sure the minimum CS-Cart version is 4.10.1.

More Information​