Quick start

1 Quick start with payments

With PayU, you will quickly activate payments on your website or mobile device.

Before integrating with PayU Payment Service, make sure that Point of Sale of the type Checkout - Express Payment will be used for processing payments (you can check this in Management Panel).

Copy the code below and paste it to the code of a web page, where the online payment service is to be available. Save changes in the page source.

<form method="post" action="https://secure.payu.com/api/v2_1/orders">
    <input type="hidden" name="continueUrl" value="http://shop.url/continue">
    <input type="hidden" name="currencyCode" value="PLN" >
    <input type="hidden" name="customerIp" value="123.123.123.123" >
    <input type="hidden" name="description" value="Order description" >
    <input type="hidden" name="merchantPosId" value="145227" >
    <input type="hidden" name="notifyUrl" value="http://shop.url/notify" >
    <input type="hidden" name="products[0].name" value="Product 1" >
    <input type="hidden" name="products[0].quantity" value="1" >
    <input type="hidden" name="products[0].unitPrice" value="1000" >
    <input type="hidden" name="totalAmount" value="1000" >
    <input type="hidden" name="OpenPayu-Signature" value="sender=145227;algorithm=SHA-256;signature=bc94a8026d6032b5e216be112a5fb7544e66e23e68d44b4283ff495bdb3983a8">
    <button type="submit" formtarget="_blank" >Pay with PayU</button>
</form >
            

Refresh the page to see the button.

For more info about creating form like above please refer to Integration of payment form in our REST API documentaction.

1.1 CSS styles

Add a definition of CSS styles.

You can place it in the <head> section of your web page or in a separate file with styles attached to the page. Styling will make the online payment service clearly visible and recognisable by your customers.

<style>
#payu-payment-form button[type=submit] {
    border: 0px;
    height: 35px;
    width: 140px;
    background: url('http://static.payu.com/pl/standard/partners/buttons/payu_account_button_long_03.png');
    background-repeat: no-repeat;
    cursor: pointer;
}
</style>
            

Refresh the page to see the button.

1.2 Example

The button you see should be exactly the same as the one below.

Click on the button – it will redirect you to a page where your customers’ payments will be accepted.

Congratulations! You have just integrated the online payment service with your shop.

Note! The service is now using test values. To configure its operations with your shop, set values assigned to your seller’s account in PayU.

Refresh the page to see the button.

2 Glossary

PayU PayU S.A. - a licensed payment services provider and an acquirer (member of Visa and MasterCard). For the purpose of this documentation, PayU means also an application for settling payments.
Merchant A merchant (aka "payment acceptor") means an entity which has signed a payment acceptance agreement with PayU and has been registered to PayU application. From the application perspective, "merchant" is a set of entites: Company/Shop/POS (see entries below).
Panel Management Panel or Administration Panel is the user interface of PayU application provided to the merchants. A link to the panel is sent to the merchant's users upon registration in PayU. The guide is available here.
Company / Firm A legal entity that uses PayU mechanisms to collect funds from customers. The entity is characterized with a set of features such as legal name, address, tax id etc.
Shop Online shop that collects payments; one company may have several shops.
POS Point of sale that accepts payments. All service parameters are defined for a given point of sale. A single Shop may operate a few POSs.
Customer / Buyer Shoper - a person that makes a payment in an online shop.
UrlofPlatnosci.pl URL where the PayU application is installed https://secure.payu.com/paygw. Formerly application's name and address was "platnosci.pl".
UrlPositive URL of a Shop application to which  the customer is redirected if a transaction started successfully.
UrlNegative URL of a Shop application to which  the customer is redirected if a transaction started unsuccessfully.
UrlOnline URL of a Shop application to which  information about changes in payment statuses (reports) are sent using the POST method

3 Payment types

Payment card
Name Transaction value Time of automatic cancellation (in days) Description
c 0,50 - 7000,002 5 Payment card (credit, debit, prepaid) - currency PLN.
c 0,50 - 7000,002 5 Payment card (credit, debit, prepaid) - currency EUR.
c 0,50 - 7000,002 5 Payment card (credit, debit, prepaid) - currency RUB.
c 3,00 - 7000,002 5 Payment card (credit, debit, prepaid) - currency CZK.
c 10 - 700000,002 5 Payment card (credit, debit, prepaid) - currency HUF.
ma as above for payment cards 5 Masterpass is a source of card data - authorization and settlement is done in the same way as for a standard card payment. In the Panel and on statements, Masterpass transactions are flagged as card payments, i.e. you may use 'ma' value to initiate Masterpass payment, but the transaction created will be flagged with 'c'. To check if the transaction was done via Masterpass, you need to check "payment flow" value. The value can be obtained through payment/get or Transaction Data Retrieve.
vc as above for payment cards 5 Visa Checkout is a source of card data - authorization and settlement is done in the same way as for a standard card payment. In the Panel and on statements, Visa Checkout transactions are flagged as card payments, i.e. you may use 'vc' value to initiate Visa Checkout payment, but the transaction created will be flagged with 'c'. To check if the transaction was done via Visa Checkout, you need to check "payment flow" value. The value can be obtained through payment/get or Transaction Data Retrieve.
Polish
Name Transaction value (PLN) Time of automatic cancellation (in days) Description
blik 1,00 - 999999,99 10 BLIK
m 0,37 - 999999,99 10 mTransfer - mBank
mtex 0,50 - 999999,99 10 mTransfer mobilny - mBank(*)
w 0,37 - 7000,00 10 BZWBK - Przelew24
o 0,37 - 999999,99 10 Pekao24Przelew - Bank Pekao
i 0,37 - 999999,99 10 Płacę z Inteligo
p 0,37 - 999999,99 10 Płać z iPKO
pkex 1,00 - 999999,99 10 PayU Express Bank Pekao(*)
g 0,37 - 999999,99 10 Płać z ING
gbx 1,00 - 999999,99 10 Płacę z Getin Bank
gbex 1,00 - 999999,99 10 GetIn Bank PayU Express(*)
nlx 1,00 - 999999,99 10 Płacę z Noble Bank
nlex 1,00 - 999999,99 10 Noble Bank PayU Express(*)
ib 0,37 - 999999,99 10 Paylink Idea - IdeaBank
l 0,37 - 999999,99 10 Credit Agricole
as 0,37 - 999999,99 10 Płacę z T-mobile Usługi Bankowe dostarczane przez Alior Bank
exas 0,37 - 500 (if the max. value is exceeded or PayU’s transaction risk assessment is negative, the payment will be processed via the “Płacę z T-mobile Usługi Bankowe dostarczane przez Alior Bank” method [as]) 10 PayU Express T-mobile Usługi Bankowe(*)
u 0,37 - 999999,99 10 Eurobank
ab 0,37 - 999999,99 10 Płacę z Alior Bankiem
exab 0,37-500 (if the max. value is exceeded or PayU’s transaction risk assessment is negative, the payment will be processed via the “Płacę z Alior Bankiem” method [ab]) 10 PayU Express z Alior Bankiem(*)
ps 0,37 - 999999,99 10 Płacę z PBS
wm 0,37 - 999999,99 10 Przelew z Millennium
wd 0,37 - 999999,99 10 Przelew z Deutsche Banku
wr 1,00 - 999999,99 10 Raiffeisen POLBANK(**)
wc 0,37 - 999999,99 10 Przelew z Citi Handlowego
bo 0,37 - 999999,99 10 Płać z BOŚ
bnx 0,50 - 999999,99 10 Płacę z BNP Paribas
bnex 0,37 - 999999,99 10 BNP Paribas PayU Express(*)
orx 1,00 - 999999,99 10 Płacę z Orange
orex 1,00 - 999999,99 10 PayU Express Orange(*)
b 0,50 - 999999,99 10 Przelew bankowy
pu Depending on the selected payment channel, this parameter takes a value appropriate for the given payment channel. PayU account. Read more about PayU account in "Konto PayU"
ai 300,00 - 20000,00 5 Raty PayU
t 0,50 - 1000,00 1 test payment – a form is displayed where transaction status can be changed

(*) this payment type is available for: PayU Account and PayU | Express

(**) semi-automated process

Czech
Name Transaction value (CZK) Time of automatic cancellation (in days) Description
cs 3,00 - 999999,99 10 PLATBA 24 - Česká spořitelna
mp 3,00 - 999999,99 10 mTransfer - mBank
kb 3,00 - 999999,99 10 MojePlatba – Komerční banka
rf 3,00 - 999999,99 10 ePlatby pro eKonto - Raiffeisenbank
pg 3,00 - 999999,99 10 Moneta Money Bank
pv 3,00 - 999999,99 10 Sberbank
pf 3,00 - 999999,99 10 Fio banka
era 3,00 - 999999,99 10 Era - Poštovní spořitelna
cb 3,00 - 999999,99 10 ČSOB
uc 3,00 - 999999,99 10 UniCredit
bt 3,00 - 999999,99 14 Bankovní převod
pt 3,00 - 999999,99 14 Převod přes poštu (poštovní poukázkou)

3.1 PayU Account

To activate the PayU Account service you need to set the ‘pu’ value in the pay_type field. You can do it in three ways:

  1. manually when the integration is based on creating a predefined form;
  2. dynamically using a JavaScript plugin (read more in "Website tools");
  3. automatically via a service that shares data about payment channels in the xml file (read more in "Website tools").

The PayU account allows the Buyer to define and configure favourite payment channels. Additionally, if the Buyer uses a payment card, its details can be saved on the PayU account. Afterwards, when paying by card, the Buyer can pay with one click, with card data completed automatically, thus improving the whole shopping process.

However, such integration of PayU account does not provide all its possibilities. Most of all it is impossible to change shipping/invoice data saved by the Buyer on the account.

In order to have the PayU account fully implemented, use the documentation.

3.2 T-test

The test method is used for generating test payments. Funds from such transactions are not transferred to the Shop; this method does not require any additional parameters for a new payment.

Test transactions are disabled by default, they are also automatically blocked 3 days after being used for the last time. In order to perform the tests, activate this method of payment in My shops > Shop name > List of POSs > POS name, and change the status of a “Test payment” in the Status column.

4 Endpoint reference

Before you take a closer look at full REST API reference, it maybe worth your while to have a quick look at all the endpoints provide, just to plan which of them you want to integrate.
Address HTTP Method Comment Full reference
/pl/standard/user/oauth/authorize POST Provides OAuth token. Signing API calls
api/v2_1/paymethods POST Provides available payment methods. Payment methods retrieval
/api/v2_1/orders POST Creates Order and enables to initiate payment transaction. OrderCreateRequest
/api/v2_1/orders/{orderId} GET Provides Order data and status. OrderRetrieveRequest
/api/v2_1/orders/{orderId} DELETE Cancels Order. Canceling Order
/api/v2_1/orders/{orderId}/transactions GET Provides payment transaction details (bank account details or card data). Transaction data retrieval
/api/v2_1/orders/{orderId}/status PUT Captures Order. Order capture
/api/v2_1/orders/{orderId}/refunds POST Allows to perform refunds (total or partial) Refund
/api/v2_1/payouts POST Allows to request payout directly from your application (note: automated or ad hoc payouts are also available in the Panel) Payouts
/api/v2_1/reports/{reportId} GET Allows to download transaction statement (note: automated or ad hoc statements are also available in the Panel). Visa Checkout
/api/visa-checkout/proxy/payment/data/{callId} GET Allows to download data (card number, shipping address etc.) from Visa Checkout. Visa Checkout