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​
| Parameter | Type | Required | 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. 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 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​
| Field | Type | Description |
|---|---|---|
items | array | List of available payment methods |
items[].key | string | Unique method identifier (use in payment_details.key for direct_payment links) |
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. |
items[].min_amount | object (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_amount | object (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¤cy=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_ordercan 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¤cy=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
amountcurrencypayer_countryRESPONSE
{
"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
}
]
}