Skip to content
APIs/APMs/
Przelewy24

Last Updated: 09 July 2025 | Change Log

Przelewy24

Przelewy24 is a real-time bank transfer, pre-payment or offline payment method for customers based in Poland.

Note

Make yourself familiar with our API Principles to ensure a resilient integration.

Product Overview

Why use Przelewy24?

Przelewy24 is the largest online payment operator in Poland offering innovative solutions for e-commerce.

Feature summary

Payment typeCustomer CountryAcceptance CurrencyRecurringReversalsPartial Reversals
Bank TransferPolandPLN❌
  • Refund - yes
  • Cancel- No
  • Partial refund - yes
  • Partial cancel- No
  • The maximum amount for a single transaction is: 50.000 PLN

Set your headers

Setting your headers is an important part of an API request. The headers represent the meta-data associated with your API request.

Authorization: {your_credentials}
Content-Type: application/json
WP-Api-Version: 2023-06-01
HeaderDescription
AuthorizationWe use the Authorization header to identify and authenticate you within Access Worldpay. You -must- use the Authorization header for any request you send to our APM API.
Content-TypeWe require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a POST or a PUT.
WP-Api-VersionWe use the WP-Api-Version header to identify which version of our APM API you are using. You must use the WP-Api-Version header for any request you send to our API.

If you're using both the Content-Type and WP-Api-Version headers, they must match.

Note

Replace {your_credentials} with your base64-encoded Basic Auth username and password. To get your Access Worldpay credentials contact your Implementation Manager.

Take a payment

POST https://try.access.worldpay.com/apmPayments

Example request

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant":
    {
        "entity": "default"
    },
    "instruction":
    {
        "narrative":
        {
            "line1": "Mind Palace Ltd"
        },
        "value":
        {
            "amount": 50,
            "currency": "PLN"
        },
        "paymentInstrument":
        {
            "type": "przelewy",
            "country": "PL",  
            "shopperEmailAddress": "email@example.com",
            "cancelURL": "https://example.com/cancel",
            "pendingURL": "https://example.com/pending",
            "successURL": "https://example.com/success"
        }
    }
}

Parameters

ParameterRequired?DescriptionData typeLength
merchant✅An object that contains information about the merchant.ObjectN/A
merchant.entity✅Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for Authentication and Queries.
Contact your Implementation Manager for more details.		StringMust be between 1 and 32 characters.
transactionReference✅A unique reference generated by you that is used to identify a payment throughout its lifecycle. See transaction reference format.StringMust be between 1 to 64 characters.
instruction✅An object that contains all the information related to the payment.ObjectN/A
instruction.narrative✅An object that helps your customers better identify you on their statement.ObjectSee our formatting rules
instruction.narrative.line1✅The first line of the narrative which appears on your customer's statement (If a character is not supported it is replaced with a space.).
See narrative line1 format for more details.		Object24
instruction.value✅An object that contains information about the payment transaction.ObjectN/A
instruction.value.amount✅The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2,50. You can find the relevant exponent in our currency table.IntegerN/A
instruction.value.currency✅The payment currency. Refer to the individual APM page for supported currencies.Integer3
instruction.paymentInstrument✅An object that contains information about the payment method.ObjectN/A
instruction.paymentInstrument.type✅The payment type and details. It defines which alternative payment method you wish to use. Value is "przelewy".ObjectN/A
paymentInstrument.country✅The country of your customer. Follows alpha 2 ISO 3166-1 standard.Object2
paymentInstrument.shopperEmailAddress✅The email address of your customer.StringN/A
instruction.paymentInstrument.cancelURL✅When your customer cancels a transaction, we redirect your customer to that cancel URL.StringN/A
instruction.paymentInstrument.pendingURL✅When we receive the payment result for a pending payment transaction, we redirect your customer to that pending URL.StringN/A
instruction.paymentInstrument.successURL✅When we receive the payment result for a successful payment, we redirect your customer to that success URL.StringN/A

Response

Successful request response

  • an HTTP code 201
  • an id which is unique to the payment - we recommend storing the "id" as this can be used to manage the payment later
  • a url to redirect your customer to the APM provider to complete the payment
  • a link to query the payment status

Example Response

{
    "paymentId": "nFxASqw-LV9HE_rr1mMONJmqBDeXmnv5dzt9IxAXgXbfpu0O_8mOnTpFSIM9gnTSygCKQgvlwQdUbu5rExIpJA_5Uq2LEGXXAanycRpxfDPNA-E70zIWdnaMb2gJhC8AIhbOkM6xDiVNu90YCXo2snTzi_k1sEOQnKIAJNTW3Qc",
    "lastEvent": "pending",
    "_links": {
        "self": {
            "href": "https://access.worldpay.com/apmPayments/nFxASqw-LV9HE_rr1mMONJmqBDeXmnv5dzt9IxAXgXbfpu0O_8mOnTpFSIM9gnTSygCKQgvlwQdUbu5rExIpJA_5Uq2LEGXXAanycRpxfDPNA-E70zIWdnaMb2gJhC8AIhbOkM6xDiVNu90YCXo2snTzi_k1sEOQnKIAJNTW3Qc"
        }
    },
    "_actions": {},
    "url": "https://payments.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey="
}
Note

In case of an error, you can get further information in our error reference.

Next Steps

Manage your Prelewy24 payment