Przelewy24

Przelewy24 provides the widest possible choice of payment methods in the Polish market.

This section provides reference information about processing Przelewy24 payments with the CURO API.
Please check the Transactions for generic information applicable to all payment methods.

Przelewy24 Payment

Entry point: /rest/v1/curo/payment/przelewy24/

REST request elements

See the Przelewy24 request parameters in the API reference.

Field name	Type Length	Required	Description
`[request]`	container	required	General container for this resource. Includes the generic request items.
`[consumer]`	container	required	Consumer information for this transaction (See the generic Consumer and Shipping elements for this transaction.)
`[cartitems]`	container	required	The cart items of the webshop order. (See the generic CartItems elements.)
`email`	string 64	required	The E-mail address of the consumer for this payment.
`currency_id`	string 3	mandatory: PLN	Przelewy24 can only process PLN transactions.

REST response elements

See the Przelewy24 Payment response elements.

Examples

JSON example request

POST /rest/v1/curo/payment/przelewy24/ HTTP/1.1
Authorization: Basic dXNlcm5hbWU6YXBpa2V5
Host: secure.curopayments.net
Content-type: application/json
Accept: application/json

{
    "site_id": "1234",
    "currency_id": "PLN",
    "amount": "100",
    "reference": "Reference 1",
    "description": "Description 1",
    "url_success": "http://www.example.com/ok.html",
    "url_pending": "http://www.example.com/pending.html",
    "url_failure": "http://www.example.com/wrong.html",
    "url_callback": "http://www.example.com/callback.html",
    "country_id": "PL",
    "language_id": "pl",
    "ip": "1.2.3.4",
    "email": "[email protected]",
    "consumer": {
        "firstname": "John",
        "lastname": "Doe",
        "email": "[email protected]",
        "address": "Nowhereroad 12",
        "city": "NonVille",
        "zipcode": "12345",
        "country_id": "PL",
        "phone": "0612345678",
        "dob": "10-07-1970",
        "gender": "m"
    },
    "cartitems": [
        {
            "quantity": 1,
            "sku": "spijkers_01",
            "name": "Spijkers",
            "price": "150",
            "vat": 21,
            "vat_inc": true,
            "type": 1
        },
        {
            "quantity": 1,
            "sku": "Discount",
            "name": "Discount total",
            "price": "-50",
            "vat": 21,
            "vat_inc": true,
            "type": 4
        }
    ]
}

JSON response for correct request

HTTP/1.1 200 OK
Content-Type: application/json

{
    "payment": {
        "action": "redirect",
        "transaction_id": "T1234567890",
        "url": "https://secure.przelewy24.pl/trnRequest/0050002306563522"
    },
    "success": true
}

JSON response for incomplete request

HTTP/1.1 200 OK
Content-Type: application/json

{
    "payment": {
        "action": "redirect",
        "external": "false",
        "url": "https://secure.curopayments.net/v1/payment/przelewy24.app?transaction=T1234567890",
        "transaction_id": "T1234567890"
    },
    "success": true
}

Przelewy24 Refund

The Refund operation must be done using the Transaction ID of a successfully completed transaction. The Refund operation, as its name states, consists of returning the money already collected by a Payment or a Capture transaction. The amount collected can be refunded in total or partially. You cannot refund amounts bigger than the one sent in the original transaction.

📘
Note

You can perform multiple refunds until you reach the total amount of the original Payment and your balance in the system is sufficient.

A Przelewy24 refund will be sent to the bank for processing immediately and can not be cancelled.

Refunds will be returned to the same account (unknown to us, only @Przelewy24) as the original payment.

See the generic Refund information and request elements.

Przelewy24 Recurring

📘
Przelewy24 does not support recurring!

Przelewy24 Cancel

📘
Przelewy24 does not support cancel!