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
required

Customer segment classification.

  • NATURAL - Individual consumers (B2C)
  • LEGAL - Business customers (B2B)

This is an extensible enum.

Available options:
NATURAL,
LEGAL
Example:

"NATURAL"

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_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_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> | string)[]
required

Customer segments supported by this payment method group.

Customer segment classification.

  • NATURAL - Individual consumers (B2C)
  • LEGAL - Business customers (B2B)

This is an extensible enum.

Available options:
NATURAL,
LEGAL
Example:

"NATURAL"

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"