Skip to main content
GET
/
sessions
/
{sessionId}
/
payment-method-groups
Retrieve Payment Method Groups
curl --request GET \
  --url https://api.checkout.int.resurs.cloud/mock/payment/public/v1/sessions/{sessionId}/payment-method-groups
[
  {
    "id": "a7f3c9e01b2d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9",
    "methodIds": [
      "550e8400-e29b-41d4-a716-446655440000"
    ],
    "title": "Resurs Invoice",
    "subtitle": "Pay within 30 days",
    "type": "RESURS_INVOICE",
    "customerTypes": [
      "NATURAL"
    ],
    "internalData": "eyJ0eXBlIjoiUkVTVVJTX0lOVk9JQ0UiLCJtZXRob2RJZHMiOlsiaWQxIl19"
  }
]

Path Parameters

​
sessionId
string
required

Session ID for authenticating payment method requests. Session ID providing secure access to payment methods.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Query Parameters

​
amount
string
required

Purchase amount in the store's base currency as a decimal string. Used for payment method availability and pricing calculations.

Pattern: ^\d+(\.\d{1,2})?$
Example:

"1299.95"

​
customerType
enum<string>

Customer segment classification.

  • NATURAL - Individual consumers (B2C)
  • LEGAL - Business customers (B2B)
Available options:
NATURAL,
LEGAL
Example:

"NATURAL"

​
flattened
boolean

When true, returns every payment method as its own group with a single methodId. When false or omitted, payment methods may be grouped (e.g., part-payment options bundled into one group).

Response

Payment method groups successfully retrieved

​
id
string
required

Deterministic group identifier derived from the payment method IDs in this group. Stable for any given set of method IDs regardless of their display order.

Example:

"a7f3c9e01b2d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9"

​
methodIds
string[]
required

Unique identifiers for the payment methods in this group. Use these IDs when initiating a payment with a specific method.

Example:
["550e8400-e29b-41d4-a716-446655440000"]
​
title
string
required

Display title for the payment method group (e.g., payment method name). Use this to label the payment method in your selector UI.

Example:

"Resurs Invoice"

​
subtitle
string
required

Display subtitle providing additional context about the payment method. Always present (empty string if not applicable).

Example:

"Pay within 30 days"

​
type
required

Payment method type classification.

  • GENERIC - Generic
  • RESURS_INVOICE - Resurs Invoice
  • RESURS_INVOICE_ACCOUNT - Resurs Invoice Account
  • RESURS_PART_PAYMENT_SELECT_LATER - Resurs Part Payment Select Later
  • RESURS_PART_PAYMENT_SELECT_NOW - Resurs Part Payment Select Now
  • RESURS_CARD - Resurs Card
  • RESURS_REVOLVING_CREDIT - Resurs Revolving Credit
  • RESURS_NEW_REVOLVING_CREDIT - Resurs New Revolving Credit
  • NETS - Nets
  • D2I - D2I
  • SWISH - Swish
  • TRUSTLY - Trustly
  • ZERO - Zero
  • VIPPS - Vipps
  • MOBILEPAY - MobilePay
  • CARD - Card (Adyen)

This is an extensible enum.

Available options:
GENERIC,
RESURS_INVOICE,
RESURS_INVOICE_ACCOUNT,
RESURS_PART_PAYMENT_SELECT_LATER,
RESURS_PART_PAYMENT_SELECT_NOW,
RESURS_CARD,
RESURS_REVOLVING_CREDIT,
RESURS_NEW_REVOLVING_CREDIT,
NETS,
D2I,
SWISH,
TRUSTLY,
ZERO,
VIPPS,
MOBILEPAY,
CARD
Example:

"RESURS_INVOICE"

​
customerTypes
enum<string>[]
required

Customer segments supported by this payment method group.

Customer segment classification.

  • NATURAL - Individual consumers (B2C)
  • LEGAL - Business customers (B2B)
Available options:
NATURAL,
LEGAL
Example:
["NATURAL"]
​
internalData
string<byte>
required

Base64-encoded opaque data for Resurs web components. Pass this value directly to Resurs elements (e.g., <resurs-payment-method data="..." />).

Do not parse or depend on the contents of this field. The internal structure is subject to change without notice.

Example:

"eyJ0eXBlIjoiUkVTVVJTX0lOVk9JQ0UiLCJtZXRob2RJZHMiOlsiaWQxIl19"