Przelewy24
Last updated: April 29, 2022
Accept payments using Przelewy24, the most popular payment method in Poland.
Information
To start accepting Przelewy24 payments, please contact your Account Manager.
Model | Collecting |
---|---|
Payment flow | Redirect |
Payment method type | Online banking |
One-step payment | |
Authorization | |
Capture | |
Refund | |
Partial refund | |
Chargeback | |
Recurring payment |
Przelewy24 payments follow a two-step process:
Use the details below to set up your request.
You can find the full list, as well as complete request and response examples, in our API reference.
post
https://api.checkout.com/payments
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": "[email protected]",9"billing_descriptor": "P24 Demo Payment"10}11}
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 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.
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.
You can find the full list, as well as complete request and response examples, in our API reference.
get
https://api.checkout.com/payments/{payment_id}
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}
Przelewy24 supports both partial and full refunds. You can refund a payment through the hub or using the refund API.
Note
To start testing, you'll need to:
- create a test account, and
- contact your Account 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.