Skip to content

Settings

Open Add-ons > Manage add-ons > Przelewy24 Payments > Settings.

Setting Default Description
Enable On When off, no new work is started. Jobs and webhooks of work that is already under way are still processed.
Debug log Off Also stores every HTTP call with masked request and response. Secrets are never stored.
Log retention (days) 90 Older log entries are removed by the cron run.
Order status when the payment is paid / failed / canceled P / F / I The order status set from the payment result. An order is never moved backwards.
Refund in full when the order status becomes empty A paid order that reaches this status is refunded once. Empty = refund by hand.

Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave a secret field empty to keep the saved value.

Field Description
Mode Test uses the sandbox (sandbox.przelewy24.pl) with the test credentials; Live uses secure.przelewy24.pl with the live credentials.
POS ID (login) The Przelewy24 account (shop) ID, a number. It is also the user name of the API.
API key (reports key) The password of the API. Panel: My data, API data and configuration.
CRC key Signs every request and every notification (SHA-384). Never shown again. Panel: same page.
Merchant ID (optional) Only when it differs from the POS ID.

Payment method (Administration > Payment methods)

Section titled “Payment method (Administration > Payment methods)”
Field Description
Payment description Shown on the payment page and in the bank transfer title before the order number.
Payment methods offered All methods enabled for the account, or BLIK only, cards only, pay-by-link only. Create one CS-Cart payment method per choice to show them separately.
Time to pay (minutes) 0 = no limit, 99 maximum.

The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:

  • php /path/to/store/admin.php --dispatch=kv_przelewy24.cron
  • https://your-store.example/index.php?dispatch=kv_przelewy24.cron&key=<secret>
  • Log lists every call, job and webhook with filters (level, action, text, dates) and a CSV export.
  • Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.

In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own account.