Przelewy24 via Checkout.com

Accept Przelewy24 payments from customers in Poland with Checkout.com as the payment service provider (PSP). The customer selects Przelewy24, confirms the payment with their bank and returns to your site.

Supported workflows

Before you begin

Complete these steps before you send your first Przelewy24 payment through Checkout.com:

Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
Ask Checkout.com support to enable Przelewy24 on your Checkout.com account.
In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select Przelewy24 under Payment methods, and save.
Add Przelewy24 as a payment option in your workflow.

Request fields for Checkout.com

Send these fields in the authorize request, in addition to the standard authorize fields. Payrails checks Required fields and returns an error when one is missing. Fields required by the PSP pass the Payrails checks but the PSP can decline the payment without them.

Field	Status	Description
`meta.customer.country.code`	Required	Sent to Checkout.com as the payment country.
`meta.customer.name`, `meta.customer.lastName`	Required by Checkout.com	Sent to Checkout.com as the account holder name.
`meta.customer.email`	Required by Checkout.com	Sent to Checkout.com as the account holder email.
`meta.customer.phone`	Optional	Sent to Checkout.com as the customer phone number.

Authorize a Przelewy24 payment

Call authorize a payment with przelewy24 as the paymentMethodCode. The response includes the redirect to the Przelewy24 page.

Authorize request

{
  "amount": {
    "value": "50.00",
    "currency": "PLN"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "przelewy24",
      "amount": {
        "value": "50.00",
        "currency": "PLN"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Jan",
      "lastName": "Kowalski",
      "email": "jan.kowalski@example.com",
      "country": {
        "code": "PL"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer confirms the payment, they return to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Checkout.com handles Przelewy24

Checkout.com needs no payment token for Przelewy24. Payrails creates the payment at Checkout.com from the authorize request.
Payrails sends the customer name and email to Checkout.com as the Przelewy24 account holder.
Refunds use the standard Checkout.com refund flow.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Przelewy24 via Checkout.com

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a Przelewy24 payment

How Checkout.com handles Przelewy24

​Supported workflows

​Before you begin

​Request fields for Checkout.com

​Authorize a Przelewy24 payment

​How Checkout.com handles Przelewy24

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a Przelewy24 payment

How Checkout.com handles Przelewy24