Skip to content

    PayU

    Overview - PayU

    PayU is an innovative payment system that is very popular in Poland and the Czech Republic.

    PayU allows customers to pay via bank transfer, credit card, BLIK, digital wallet (Google Pay, Visa Checkout, Masterpass, etc.).

    In addition, customers could pay in installments or pay later by invoice.

    Customer Experience - PayU

    StepDescriptionImage
    1Choose PayU
    2Click Pay
    3Redirect to PayU
    4 Proceed on the PayU page. Choose between the following payment options:
    • Bank transfer
    • BLIK
    5AIn case of bank transfer, choose your bank and proceed with the inputs.
    5BIn case of BLIK,
    enter the BLIK code and proceed.

    Note: This customer experience is valid for a live environment. In a test environment, the customer experience may look different.

    PayEngine Details - PayU

    General

    NameDetails
    ProductPayU
    Payment Options (for Customer)
    • Bank transfer
    • BLIK
    ChannelsECOM
    CurrenciesPLN, CZK
    CountriesPL, CZ
    Technical FlowAsynchronous
    RecurringNo
    ChargebacksNo
    B2B applicableNo

    Supported Features and Services

    NameDetails
    DebitYes
    PreauthorizationNo
    CancelationNo
    CaptureNo
    RefundsYes
    NotificationsYes (webhook and email)
    Settlement Reporting
    Yes - Unified Settlement Reporting

    Integration Types

    NameDetails
    APIYes
    WidgetYes
    BridgeNo
    Shop PluginNo
    PaylinkNo

    Integration via API - PayU

    Technical Flow

    PayU-tech-flow

    Webhook and email notifications

    At the time of the redirect, it is still uncertain whether a transaction will be completed successfully or not. Therefore, Payengine awaits for the final asynchronous notification before the status of a DEBIT transaction is changed from PENDING to SUCCESS or FAILURE.

    A merchant should register for Payengine's notifications to receive this final status update.

    Alternatively, a GET request on the order or DEBIT transaction would also work, but it is not ensured that the final status will be available immediately after the redirect and a merchant might have to query the GET multiple times.

    Therefore, it is strongly recommended that Payengine's asynchronous notifications are used instead.

    Merchants could receive notifications via URL (webhook) or email.

    The notifications could be subscribed:

    Specifications - PayU

    Input Parameters for Authorizing Transactions

    ParameterMandatory/Optional (M/O)DescriptionTypeExample
    async.cancelUrlMRedirect URL when payment is canceledstringhttp://my.shop.com/cancel
    async.failureUrlMRedirect URL for unsuccessful paymentstringhttp://my.shop.com/fail
    async.successUrlMRedirect URL for successful paymentstringhttp://my.shop.com/success
    currencyMThe currency of the transaction.
    Accepted values: PLN, CZK
    stringPLN
    payment.accountHolderOThe PayU accountholder namestringDr. Hans-Peter Meier
    payment.compliantEmailOThe accountholder's emailstringtest@test.com

    Samples

    Debit transaction

    POST/{{publicApiUrl}}/v1/orders/debit

    Create Debit Request

    {
        "product": "payu",
        "terms": 1468590412476,
        "privacy": 1468590412476,

    Create Debit Response

    {
        "createdAt": 1583335400722,
        "modifiedAt": 1583335400781,
        "merchantId": "merchant_bwwo5xstjr",

    Refund transaction

    POST/{{publicApiUrl}}/{{apiVersion}}/orders/{{orderId}}/transactions/{{transactionId}}/refund

    Create Refund Request

    {
        "description": "description for transaction.",
        "initialAmount": 6060,
        "currency": "PLN",

    Create Refund Response

    {
        "createdAt": 1583327063079,
        "modifiedAt": 1583327063130,
        "type": "REFUND",

    Testing

    PayU can be tested via the Payengine Simulator.

    The testing amounts for the two scenarios can be found below:

    ResultDescription
    SuccessAny applicable amount (excluding failure amounts listed below). The transaction's status changes from OK to SUCCESS.
    Failure Each of the amounts listed below:
    11111 (€111,11)
    111 (€1,11)

    The transaction's status changes from "OK" to "FAILURE".

    Was this helpful?

    What was your feeling about it?