How to Take Przelewy24 Payments with Gravity Forms (Bank Transfers, BLIK, Cards)

Przelewy24 is how a large share of Polish customers prefer to pay online: they pick their bank and confirm a fast transfer, approve a BLIK code on their phone, or pay by card, all on one familiar page. If you take bookings, orders, registrations or donations with Gravity Forms, you can offer exactly that checkout without building a shop. This guide shows how to take Przelewy24 payments with Gravity Forms step by step, from the keys in the Przelewy24 panel to the first verified payment and a refund.

Why take Przelewy24 payments through Gravity Forms?

Gravity Forms already works out prices, quantities, options and totals. What it needs is a safe way to collect the money in złoty and to know for sure when a payment has arrived. With a Przelewy24 feed, the form becomes the order page: the customer fills it in, pays on the Przelewy24 page, and the entry is marked Paid only after the payment has been verified with Przelewy24. Notifications to you and to the customer can wait until then, so nobody receives a “booking confirmed” email for an unpaid booking.

Because the payment happens on the Przelewy24 page, card numbers and bank logins never pass through your website. Your site only sends the order (amount, currency, description, the customer’s email) and receives the result.

Ways your customers can pay

• Fast bank transfers (pay-by-link) from the major Polish banks, confirmed within moments in most cases.
• BLIK, the six-digit code approved in the customer’s banking app.
• Cards, and wallets such as Google Pay and Apple Pay where enabled on your account.
• Traditional transfers and other methods you switch on in the Przelewy24 panel.

Which methods appear depends on your Przelewy24 account. The add-on simply sends the customer to the payment page with the right amount and lets Przelewy24 show what you offer.

Forms that work well with Przelewy24

• Workshop, class and event bookings with a fixed price per place.
• Small shops and pre-orders where a full shop would be too much.
• Membership fees, registrations and application fees.
• Donations and fundraising forms in złoty.
• Deposits for services such as photography, tours or repairs.

What you need

• WordPress with Gravity Forms 2.9 or newer.
• The Gravity Forms Przelewy24 Premium Add-on (one site $49 a year, five sites $69 a year, unlimited sites $199 a year).
• A Przelewy24 merchant account. The sandbox account for testing is switched on from the panel under My account.
• Your merchant ID, CRC key and API key (also called the report key), all found under My data in the Przelewy24 panel.
• An https site that Przelewy24 can reach, so it can send its payment notifications.

Step 1: Install the add-on and connect your account

Install and activate the add-on, then activate your licence key in Forms → Settings → Przelewy24. Leave the mode on Sandbox, paste the sandbox merchant ID, CRC key and API key, and save. The add-on asks Przelewy24 to confirm the keys (a check that changes nothing) and shows “Connected to Przelewy24 (Sandbox)” with the keys masked. The keys are stored encrypted in your database.

Set the Gravity Forms currency to Polish Zloty. If Przelewy24 has enabled euro, pound sterling or Czech koruna on your account, tick that currency in the add-on settings and set the form currency to it instead.

Step 2: Build the form

Create the form as usual with Product fields (or a single product with a quantity), a Total field, and the customer’s name, email and phone. The email field matters: Przelewy24 needs it for the payment confirmation it sends to the customer. Gravity Forms shows the prices in the Polish format, for example zł 500,00, and calculates the total as the customer changes quantities.

Step 3: Add a Przelewy24 feed

In the form settings, open Przelewy24 and add a feed. Choose Products and Services (or Donations), keep the form total as the payment amount, map the email, name and phone fields, and write a description such as {form_title} #{entry_id}, which you will see next to the transaction in the Przelewy24 panel. Tick “Send form notifications only after the customer has paid” so confirmation emails go out only for paid entries.

Step 4: Test in the sandbox

Open the form on a public page and submit it. You are taken to the Przelewy24 sandbox payment page, where you can complete a test payment. Back on your site, the page shows “Confirming your payment” for a moment and then your confirmation message. In the entry, the Przelewy24 box shows Paid, the Przelewy24 transaction number and the transfer title. Try a partial refund too: the box shows “Refund requested” and, once Przelewy24 confirms it, the refund is recorded in the notes.

What happens behind the scenes

1. On submit, the add-on takes the total Gravity Forms calculated on the server, converts it to grosze (zł 149,90 becomes 14990) and registers a transaction with Przelewy24. The registration is signed with your CRC key, so it cannot be changed on the way.
2. Przelewy24 answers with a token, and the customer is sent to the Przelewy24 payment page for it.
3. When the customer pays, Przelewy24 sends a signed notification to your site. The add-on checks the signature, reads the transaction back from Przelewy24 and compares the session, amount and currency with the entry.
4. The add-on then verifies the payment with Przelewy24. This step is required: Przelewy24 settles the money to you only after a successful verification. Only then does the entry become Paid and the held emails go out.
5. If a notification is missed, the return page, the status check every five minutes and the Refresh status button do the same read-back and verification.

A worked example

A weaving studio in Kraków sells workshop places at zł 500,00 and a linen yarn kit at zł 250,00. A customer books two places and one kit. Gravity Forms shows the total zł 1.250,00. The add-on registers a transaction for 125000 grosze in PLN with the description “Book a workshop #1042” and the customer’s email, and the customer pays with BLIK. Przelewy24 notifies the site, the add-on verifies 125000 PLN for that session, the entry becomes Paid with the Przelewy24 transaction number, and the booking email goes out. A week later one place is cancelled: the studio refunds zł 500,00 from the entry and the note records it when Przelewy24 confirms it.

How it differs

• It connects to your own Przelewy24 merchant account directly with the Przelewy24 REST API, so the money is settled by Przelewy24 to your account under your own Przelewy24 agreement, and the payment page shows every method you have switched on there.
• It runs the verification step Przelewy24 asks for on every payment, and only a successful verification marks the entry Paid. Without it Przelewy24 does not settle the money.
• It never trusts the return address or the notification on its own: the notification signature is checked with your CRC key, the transaction is read back from Przelewy24, and the session, amount and currency must match the entry.
• Refunds, including several partial refunds, are made from the Gravity Forms entry and recorded only when Przelewy24 confirms them.

Tips for smooth payments

• Keep prices in the format Gravity Forms shows (zł 1.250,00) or as plain numbers without a thousands separator (1250).
• Use the Payment Completed notification event for receipts, so they are only sent for verified payments.
• Use a clear description with the entry number, so you can find a transaction in the Przelewy24 panel quickly.
• If you only want certain methods for a form, a short filter can set the channel or a time limit; the amount and addresses always stay as Gravity Forms calculated them.

Step 5: Go live

Paste the live merchant ID, CRC key and API key from the live Przelewy24 panel, switch the mode to Live and save. Make one small real payment and refund it to check everything end to end. Entries paid in the sandbox keep their sandbox mode, so the two never mix.

Questions

Do card or bank details reach my website?

No. The customer pays on the Przelewy24 page. Your site only sends the order and receives the result.

Can I take payments in euro?

Yes, if Przelewy24 has enabled euro (or pound sterling, or Czech koruna) on your account. Tick that currency in the add-on settings and set the Gravity Forms currency to it. Złoty works out of the box.

What if the notification never arrives?

The customer’s return, the status check every five minutes and the Refresh status button all read the payment from Przelewy24 and verify it, so a missed notification only delays the update a little. An entry still unpaid after 48 hours is cancelled, and a payment that arrives later still marks it Paid.

Can I refund part of a payment?

Yes. You can make several partial refunds from the entry, up to the paid amount. Each is recorded when Przelewy24 confirms it.

Are subscriptions supported?

Not in version 1.0.0: the add-on takes one-off payments for products, services and donations.

Get started

Get the Gravity Forms Przelewy24 Premium Add-on and follow the setup guide. Plans: one site $49 a year, five sites $69 a year, unlimited sites $199 a year.