Connect Przelewy24
Connect your Przelewy24 merchant account with the Merchant ID, POS ID, API key and CRC key, avoid the IP address setting that blocks the connection, and enable the gateway on your prices.
Przelewy24 lets customers pay for one-time prices with online transfers and BLIK through your own Przelewy24 merchant account. When you finish, the Przelewy24 card shows Connected and the gateway is enabled on your prices. You need an active Przelewy24 account and access to its panel.
Open the Payments tab
In the sidebar open Integrations and choose Payments (/integrations/payments).
Przelewy24 is in the Local payments section; if the section is folded, click its header. Click
Connect on the Przelewy24 card. The Connect Przelewy24 window opens.
Copy the credentials from the Przelewy24 panel
Fill in Merchant ID, POS ID, API Key and CRC Key; the table below says where each
one comes from. Each field has a Where do I find this? guide with a link that opens the
Przelewy24 panel (panel.przelewy24.pl).
Allow the API key to work from any address
In the Przelewy24 panel, in the "IP address" field next to the API key, enter %, click the plus
and save. Zanfia's servers have no fixed IP address, so a specific address in that field blocks
the connection.
Save
Leave Automatically enable this payment gateway on all existing prices (recommended) ticked and click Save. You see "Integration with Przelewy24 was successful" and the card moves to Connected.
Good to know
The ID fields accept digits only. If you paste a key into an ID field, the form says "This field should contain digits only. Check that you are not pasting a value from a different field."
The four credentials
| Field | Required | Where the guide points |
|---|---|---|
| Merchant ID | Yes | Log in to the Przelewy24 panel, open My data / Settings, copy your Merchant ID. Digits only. |
| POS ID | No | Your Shop ID. With a single shop it equals the Merchant ID and you can leave the field empty. Digits only. |
| API Key | Yes | In the panel open My data → API data and configuration and copy your REST API key. |
| CRC Key | Yes | On the same page, copy your CRC key. |
If the connection is refused
An error stays visible inside the window so you can compare it with what you typed:
| Message | What to do |
|---|---|
| "Przelewy24 rejected the credentials. Check Merchant ID, POS ID, API Key and CRC Key. …" | Re-copy all four values, then check the "IP address" field from step 3: it must contain %. |
| "An error has occurred during integration. Please try again in a moment" | Try again a little later. |
After connecting
- Currencies. Zanfia offers Przelewy24 on prices in PLN and EUR.
- Price types. Przelewy24 appears on one-time and recurring-payment prices. Subscriptions and installments are charged by card through Stripe. The full matrix is in Payment methods by gateway.
- Manage. Click Manage on the card to change the credentials (the pencil icon; you enter all values again, saved secrets are never shown), to set Default gateway for new prices, to Enable on all or Disable on all existing prices, or to remove the connection with the trash icon.
- Removing the connection. The confirmation says "Remove this connection? Anything that uses it will stop working." Przelewy24 stops being offered on your checkouts until you connect it again.
Przelewy24 is also one of the payment methods Stripe can offer on your checkouts. That is a separate setup on your Stripe account: see Connect Stripe.
Was this article helpful?