Get Payment Methods

GET https://api.paysera.com/checkout-project/integration/v1/methods

Retrieves all available payment methods for your project. Use this endpoint to display payment options to customers or to get method keys for pre-selection.

Authorization

This endpoint requires OAuth2 Bearer token authentication.

Authorization Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

For more details, see the Authentication section.

Query Parameters

Parameter	Type	Description
`amount`	integer	Transaction amount in minor units for filtering by limits
`currency`	string	ISO 4217 currency code for filtering by limits
`payer_country`	string	ISO 3166-1 alpha-2 country code. Selects the per-country transaction limits used for filtering.

Filtering

Filtering by amount limits only applies when both amount and currency are provided. If omitted, all payment methods are returned.

payer_country is separate and optional: without it, the method's global limits apply.

Response

Field	Type	Description
`items`	array	List of available payment methods
`items[].key`	string	Unique method identifier (use for pre-selection)
`items[].title`	string	Display name of the payment method
`items[].description`	string (nullable)	Detailed description of the payment method
`items[].type`	enum	Type of payment method: `pis`, `card`, `wallet`, `banklink` or `bnpl`. Today's catalogue uses only `pis`, `card` and `bnpl`, but handle the full set.
`items[].flow`	enum	Flow type: `redirect`, `decoupled` or `direct`. Every method currently uses `redirect`.
`items[].available_countries`	array	ISO 3166-1 alpha-2 country codes. An empty array means no payer-country restriction. With `amount` and `currency` supplied, the list is trimmed to the countries whose limits accept that amount.
`items[].available_currencies`	object	Available currencies configuration, keyed by currency code
`items[].logo_url`	string (nullable)	URL of the icon variant of the logo, a 48 px disc. Built from the method key, so in practice always present.
`items[].logo_wide_url`	string (nullable)	URL of the wide variant, the wordmark for wide slots. Built the same way.
`items[].display_order`	integer (nullable)	Position in the ordering. `null` means unranked — unranked methods follow the ranked ones, sorted by name. A project can override the catalogue default.
`items[].display_order_group`	integer (nullable)	Group the method belongs to. Methods sharing a group are meant to be rendered as one block.

Example

Request - All Methods

GET https://api.paysera.com/checkout-project/integration/v1/methods
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

Request - Filtered by Amount

GET https://api.paysera.com/checkout-project/integration/v1/methods?amount=2500&currency=EUR
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

Response

{
  "items": [
    {
      "key": "paysera",
      "title": "Paysera",
      "description": "Versatile e-wallet for online payments.",
      "type": "pis",
      "flow": "redirect",
      "available_countries": [],
      "available_currencies": {
        "EUR": { "main": true }
      },
      "logo_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/paysera/logo",
      "logo_wide_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/paysera/logo/wide",
      "display_order": 1,
      "display_order_group": null
    },
    {
      "key": "revolut",
      "title": "Revolut",
      "description": "Digital banking with instant payments",
      "type": "pis",
      "flow": "redirect",
      "available_countries": ["AT", "BE", "BG", "CY", "CZ", "DE"],
      "available_currencies": {
        "EUR": { "main": true }
      },
      "logo_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/revolut/logo",
      "logo_wide_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/revolut/logo/wide",
      "display_order": 5,
      "display_order_group": null
    },
    {
      "key": "swedbank",
      "title": "Swedbank",
      "description": "Leading Nordic-Baltic bank.",
      "type": "pis",
      "flow": "redirect",
      "available_countries": ["EE", "LT", "LV"],
      "available_currencies": {
        "EUR": { "main": true }
      },
      "logo_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/swedbank/logo",
      "logo_wide_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/swedbank/logo/wide",
      "display_order": null,
      "display_order_group": null
    },
    {
      "key": "seb",
      "title": "SEB",
      "description": "Major Nordic financial group.",
      "type": "pis",
      "flow": "redirect",
      "available_countries": ["EE", "LT", "LV"],
      "available_currencies": {
        "EUR": { "main": true }
      },
      "logo_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/seb/logo",
      "logo_wide_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/seb/logo/wide",
      "display_order": null,
      "display_order_group": null
    }
  ]
}

The items come back in display order: Paysera is pinned first, Revolut is ranked fifth, and the unranked methods follow alphabetically.

Revolut's available_countries is shortened here — it holds 31 entries. Paysera returns an empty array, which means the method has no payer-country restriction at all.

Available Payment Methods

Listed in the order the checkout displays them.

Method	Key	Countries	Type
Paysera	`paysera`	Any	`pis`
Apple Pay	`apple-pay`	Worldwide	`card`
Google Pay	`google-pay`	Worldwide	`card`
Credit/Debit Cards	`card-payment`	Worldwide	`card`
Revolut	`revolut`	EEA + GB	`pis`
Wise	`wise`	77 countries	`pis`
Bunq	`bunq`	EU	`pis`
Hire Purchase	`hire-purchase`	EE, LT, LV	`bnpl`
Pay Next Month	`pay-next-month`	EE, LT	`bnpl`
Split Into Parts	`split-into-parts`	EE, LT	`bnpl`
Artea Bank	`artea`	LT	`pis`
Citadele	`citadele`	EE, LT, LV	`pis`
Coop Bank	`coop`	EE	`pis`
DSK Bank	`dsk`	BG	`pis`
LHV	`lhv`	EE	`pis`
LKU Credit Union	`lku`	LT	`pis`
Luminor	`luminor`	EE, LT, LV	`pis`
Nordea	`nordea`	FI	`pis`
SEB	`seb`	EE, LT, LV	`pis`
Swedbank	`swedbank`	EE, LT, LV	`pis`
UBB	`ubb`	BG	`pis`
Urbo Bank	`urbo`	LT	`pis`

Two things the table cannot show:

Paysera is always first, whatever its rank — it is pinned unconditionally.
display_order can be overridden per project, so the number your project receives may differ from the catalogue default and from another project's.

The bnpl methods are provided by Inbank and carry amount limits that differ per payer country — see the Instalments table. Outside the accepted range the method is not returned.

Card methods are returned only when your project is eligible, and some methods are also restricted by the merchant's own country. See Method Visibility for the full rules.

Usage Examples

Retrieve All Payment Methods

curl -X GET https://api.paysera.com/checkout-project/integration/v1/methods \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Filter Methods for Specific Transaction

# Get methods that support €25.00 transaction
curl -X GET "https://api.paysera.com/checkout-project/integration/v1/methods?amount=2500&currency=EUR" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Next Steps

Use the key value when creating a payment link with payment_details.key to pre-select a specific payment method.

AUTHORIZATION: HTTP

REQUEST

Base URL

https://api.paysera.com

Query Parameters

amount

Transaction amount for filtering payment methods by limits. Filtering is only applied when both amount and currency are provided. If omitted, all payment methods are returned without limit filtering.

currency

Transaction currency code (ISO 4217) for filtering payment methods by limits. Filtering is only applied when both amount and currency are provided. If omitted, all payment methods are returned without limit filtering.

payer_country

Payer country code (ISO 3166-1 alpha-2). When provided, the per-payer-country transaction limits are applied for that country; otherwise the method's global limits are used. Independent of the amount and currency filter.

RESPONSE

Available payment methods successfully retrieved

{
  "items": [
    {
      "key": "swedbank",
      "title": "Swedbank",
      "description": "Pay via Swedbank online banking",
      "type": "pis",
      "flow": "redirect",
      "available_countries": [
        "EE",
        "LT",
        "LV"
      ],
      "available_currencies": {
        "EUR": {
          "main": true
        }
      },
      "logo_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/swedbank/logo",
      "logo_wide_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/swedbank/logo/wide",
      "display_order": null,
      "display_order_group": null
    },
    {
      "key": "revolut",
      "title": "Revolut",
      "description": "Pay via Revolut",
      "type": "pis",
      "flow": "redirect",
      "available_countries": [
        "AT",
        "BE",
        "BG",
        "CY",
        "CZ",
        "DE"
      ],
      "available_currencies": {
        "EUR": {
          "main": true
        }
      },
      "logo_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/revolut/logo",
      "logo_wide_url": "https://api.paysera.com/checkout-engine/public/v1/assets/payment-method/revolut/logo/wide",
      "display_order": 5,
      "display_order_group": null
    }
  ]
}

Authorization​

Query Parameters​

Response​

Example​

Request - All Methods​

Request - Filtered by Amount​

Response​

Available Payment Methods​

Usage Examples​

Retrieve All Payment Methods​

Filter Methods for Specific Transaction​

Next Steps​

AUTHORIZATION: HTTP

REQUEST

RESPONSE

Authorization

Query Parameters

Response

Example

Request - All Methods

Request - Filtered by Amount

Response

Available Payment Methods

Usage Examples

Retrieve All Payment Methods

Filter Methods for Specific Transaction

Next Steps