Skip to main content

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 the method keys to use in payment_details.key with the direct_payment flow.

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​

ParameterTypeRequiredDescription
amountintegerTransaction amount in minor units for filtering by limits
currencystringISO 4217 currency code for filtering by limits
payer_countrystringISO 3166-1 alpha-2 country code. A method that has payer countries is listed only when this country is enabled for it and the amount fits this country's limits (its own, else the global ones); available_countries then holds only this country.
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, each method lists every country whose limits accept the amount.

Response​

FieldTypeDescription
itemsarrayList of available payment methods
items[].keystringUnique method identifier (use in payment_details.key for direct_payment links)
items[].titlestringDisplay name of the payment method
items[].descriptionstring (nullable)Detailed description of the payment method
items[].typeenumType of payment method: pis, card, wallet, banklink or bnpl. Today's catalogue uses only pis, card and bnpl, but handle the full set.
items[].flowenumFlow type: redirect, decoupled or direct. Every method currently uses redirect.
items[].available_countriesarrayISO 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_currenciesobjectAvailable currencies configuration, keyed by currency code
items[].logo_urlstring (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_urlstring (nullable)URL of the wide variant, the wordmark for wide slots. Built the same way.
items[].display_orderinteger (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_groupinteger (nullable)Group the method belongs to. Methods sharing a group are meant to be rendered as one block.
items[].min_amountobject (nullable)Lowest amount the method accepts, as { "amount", "currency" } in minor units of the method's limit currency: for payer_country when given, else the lowest minimum of the listed countries (the global minimum for a method without payer countries). null when there is no minimum.
items[].max_amountobject (nullable)Highest amount the method accepts, in the same shape: for payer_country when given, else the highest maximum of the listed countries. null when there is no maximum. Useful when choosing a payer-set order's maximum_amount; with tips the bill plus the tip must fit.

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.

MethodKeyCountriesType
PayserapayseraAnypis
Apple Payapple-payWorldwidecard
Google Paygoogle-payWorldwidecard
Credit/Debit Cardscard-paymentWorldwidecard
RevolutrevolutEEA + GBpis
Wisewise77 countriespis
BunqbunqEUpis
Hire Purchasehire-purchaseEE, LT, LVbnpl
Pay Next Monthpay-next-monthEE, LTbnpl
Split Into Partssplit-into-partsEE, LTbnpl
Artea BankarteaLTpis
CitadelecitadeleEE, LT, LVpis
Coop BankcoopEEpis
DSK BankdskBGpis
LHVlhvEEpis
LKU Credit UnionlkuLTpis
LuminorluminorEE, LT, LVpis
NordeanordeaFIpis
SEBsebEE, LT, LVpis
SwedbankswedbankEE, LT, LVpis
UBBubbBGpis
Urbo BankurboLTpis

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 choose the method for a direct_payment link.

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, a method that has payer countries is listed only when this country is enabled for it and the amount fits this country's limits (its override, else the global limits), and available_countries holds only this country. If omitted, each method lists every country whose limits accept the amount.

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,
"min_amount": {
"amount": 1,
"currency": "EUR"
},
"max_amount": {
"amount": 1500000,
"currency": "EUR"
}
},
{
"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,
"min_amount": null,
"max_amount": null
}
]
}