Przelewy24
Accept payments using Przelewy24, the most popular payment method in Poland.
Information
To start accepting Przelewy24 payments, please contact your Customer Success Manager.
Model | Collecting |
Payment flow | Redirect |
Payment method type | Online banking |
One-step payment | |
Authorization | |
Capture | |
Refund | |
Partial refund | |
Chargeback | |
Recurring payment |
Overview
Przelewy24 payments follow a two-step process:
Request a payment
Use the details below to set up your request.
Endpoints
You can find the full list, as well as complete request and response examples, in our API reference.
https://api.checkout.com/payments
Request example
1{2 "amount": 100,3 "currency": "PLN",4 "source": {5 "type": "p24",6 "payment_country": "PL",7 "account_holder_name": "Bruce Wayne",8 "account_holder_email":"bruce@wayne-enterprises.com",9 "billing_descriptor": "P24 Demo Payment"10 }11 }
Response example
If you receive a 202 Success
response with a status
field set to Pending
, your request was successful.
1{2 "id": "pay_yo7mr2qvrj5ubirhehlbjr4yda",3 "status": "Pending",4 "customer": {5 "id": "cus_dd7efezan2xexdfhtrhoz6tvam"6 },7 "_links": {8 "self": {9 "href": "https://api.sandbox.checkout.com/payments/pay_yo7mr2qvrj5ubirhehlbjr4yda"10 },11 "redirect": {12 "href": "https://r.girogate.de/ti/simp24?tx=431811890&rs=6FlzR3BeW8SvfX4U0H7weTEkDPSWJBVb&cs=dfcf0cab1a0522652133e8dc0302cdcae683ac07f1317b3db6450893ce007831"13 }14 }15 }
Redirect the customer
Redirect your customer to the redirect
link’s href in the response. The customer will be redirected to a Przelewy24 page where they can authorize the payment, before being transferred to your predefined success or failure URL.
Get details about a payment
You can use the payment_id
found in the payment response, or the cko-session-id
from the success/failure URL (e.g., https://www.checkout.com/order/succeeded?cko-session-id=sid_vii64oquze5u3h2x6hh4rurc4y
) to retrieve details about the payment.
Note
The cko-session-id
expires 15 minutes after being created.
Endpoints
You can find the full list, as well as complete request and response examples, in our API reference.
https://api.checkout.com/payments/{payment_id}
Response example
1{2 "id": "pay_yo7mr2qvrj5ubirhehlbjr4yda",3 "requested_on": "2019-08-08T06:48:21Z",4 "source": {5 "type": "p24",6 "p24_descriptor": "P24-H99-999-999 ABC1234 Dynamic"7 },8 "amount": 100,9 "currency": "PLN",10 "payment_type": "Regular",11 "status": "Captured",12 "approved": true,13 "risk": {14 "flagged": false15 },16 "customer": {17 "id": "cus_dd7efezan2xexdfhtrhoz6tvam"18 },19 "_links": {20 "self": {21 "href": "https://api.sandbox.checkout.com/payments/pay_yo7mr2qvrj5ubirhehlbjr4yda"22 },23 "actions": {24 "href": "https://api.sandbox.checkout.com/payments/pay_yo7mr2qvrj5ubirhehlbjr4yda/actions"25 },26 "refund": {27 "href": "https://api.sandbox.checkout.com/payments/pay_yo7mr2qvrj5ubirhehlbjr4yda/refunds"28 }29 }30 }
Refund a payment
Przelewy24 supports both partial and full refunds. You can refund a payment through the hub or using the refund API.
Testing Przelewy24
Note
To start testing, you'll need to:
- create a test account, and
- contact your Customer Success Manager or Integrations engineer to activate Przelewy24 payments in the sandbox environment.
- Create a Przelewy24 transaction as above, following the redirect link in the response to Przelewy24's website.
- Leave the Bank name or BIC field blank and select Next.
- Leave the Account Number and PIN fields blank and then select Login.
- Leave the TAN field blank and select Make Payment.
- Select Back to where you came from to be redirected to your predefined success URL.