PayU

PayU is an online bank transfer payment method. Consumers log in to their online banking environment. They review the payment details and authorize the payment of the funds to be credited directly to the payee's account.

Payment method properties

Markets (consumer)PL CZ
Processing currenciesPLN CZK
Consumer currenciesPLN CZK
Authentication methodsREDIRECT
Authentication timeout1 hour
Minimum payment amountPLN = 1.00, CZK = 3.00
Maximum payment amountIt depends on the bank. Usually 999999.99
Payment instrumentBANK_ACCOUNT
Recurring paymentsNo
Separate capturesNo
RefundFull - Partial - Multiple
Refund validity365 days
DisputesNo
Sandbox availabilityPayU sandbox

Make a PayU payment

PayU payments follow our standardized REDIRECT payment flow. However, we recommend including all relevant settings for any authentication methods you support.

To make a PayU payment, you'll need to provide the following data at minimum when calling our /v1/payment-charges API:

Field Description

paymentMethod

PAYU

amount.value

The amount to be paid in the smallest units of the currency used.

amount.currency

PLN, CZK

consumer.name

Full name of the consumer.

consumer.country

The country where the consumer is shopping.

consumer.email

Email of the consumer.

authenticationSettings: REDIRECT
settings.returnUrl

Add the url where the consumer should be redirected to after they complete the payment. Required for the REDIRECT payment flow.

Request

POST /v1/payment-charges

{
    "paymentMethod": "PAYU",
    "amount": {
        "value": 500,
        "currency": "PLN"
    },
    "consumer": {
        "name": "Julia Nowak",
        "email": "[email protected]",
        "country": "PL"
    },
    "merchantPaymentChargeReference": "ABCD-1234-PQRS-5678",
    "paymentDescriptor": "Acme Inc - Order No 12345",
    "authenticationSettings": [
        {
            "type": "REDIRECT",
            "settings": {
                "returnUrl": "https://www.ppro.com/"
            }
        }
    ]
}

Response

You'll receive our standard payment charge response with the available authentication methods:

{
    "id": "charge_73K89ikZwMiYnkGds6mdP",
    "paymentMethod": "PAYU",
    "paymentMedium": "ECOMMERCE",
    "scheduleType": "UNSCHEDULED",
    "instrumentId": "instr_6wijuXG2PKmeBLv5Tdyy2",
    "currency": "PLN",
    "country": "PL",
    "paymentDescriptor": "Acme Inc - Order No 12345",
    "status": "AUTHENTICATION_PENDING",
    "consumer": {
        "name": "Julia Nowak",
        "email": "[email protected]",
        "country": "PL"
    },
    "authenticationMethods": [
        {
            "details": {
                "requestUrl": "https://authman.sandbox.lp-pl.ppro.com/v0/redirections/forward?redirection_token=eyJhbGciOiJIUzUxMiJ9.eyJzZXNzaW9uIjp7InIiOiJjaGFyZ2VfNzNLODlpa1p3TWlZbmtHZHM2bWRQIn19.3KVfYjOVGPb0cgdF1mzbK6FPP0MS18bmU8P2e5uap3EEBzpei7wOjGOPPr72wcmY0k3HUIxDyt8OYBhKSSLU0Q",
                "requestMethod": "GET"
            },
            "type": "REDIRECT"
        }
    ],
    "authorizations": [
        {
            "id": "authz_q8vbRTpRr2qc98w48X2Z4",
            "amount": 500,
            "status": "AUTHENTICATION_PENDING",
            "merchantPaymentChargeReference": "ABCD-1234-PQRS-5678",
            "createdAt": "2026-03-04T16:50:51.500Z",
            "updatedAt": "2026-03-04T16:50:51.500Z"
        }
    ],
    "captures": [],
    "refunds": [],
    "discards": [],
    "voids": [],
    "createdAt": "2026-03-04T16:50:51.247Z",
    "updatedAt": "2026-03-04T16:50:51.500Z",
    "_links": {
        "authorizations": {
            "href": "/v1/payment-charges/charge_73K89ikZwMiYnkGds6mdP/authorizations"
        },
        "captures": {
            "href": "/v1/payment-charges/charge_73K89ikZwMiYnkGds6mdP/captures"
        },
        "refunds": {
            "href": "/v1/payment-charges/charge_73K89ikZwMiYnkGds6mdP/refunds"
        },
        "discards": {
            "href": "/v1/payment-charges/charge_73K89ikZwMiYnkGds6mdP/discards"
        },
        "voids": {
            "href": "/v1/payment-charges/charge_73K89ikZwMiYnkGds6mdP/voids"
        }
    }
}

Pick the desired authentication method

REDIRECT

Redirect your consumer to the returned $.authenticationMethods[?(@.type == "REDIRECT")].details.requestUrl.
For example, with the value of https://redirection-target.ppro.com/ using the returned $.authenticationMethods[?(@.type == "REDIRECT")].details.requestMethod HTTP method.

Handling the payment result

REDIRECT

  1. After the consumer completes the payment, they are redirected to the returnUrl specified in the payment charge creation request.
  2. Upon redirect back to your site, retrieve the latest payment status by performing a GET /v1/payment-charges/{paymentChargeId}. Use the returned status field to determine and display the final payment outcome to the consumer.
  3. Additionally, webhooks are triggered to notify you of the payment result. This ensures you receive the outcome even if the consumer closes their browser or fails to return to your website.

Payment instrument

A PASSTHROUGH_WALLET instrument will be created for PayU, with no additional data.

Request

GET /v1/payment-instruments/{instrument-id}

Response

{
    "id": "instr_Asu0ig2PXXZSiNrhY44A5",
    "type": "PASSTHROUGH_WALLET"
}

Sandbox testing