---
title: "Retrieve Payment Methods for Checkout"
method: GET
path: "/checkout/sessions/{checkout_session}/payment-methods"
---

# Retrieve Payment Methods for Checkout

`GET /checkout/sessions/{checkout_session}/payment-methods`

## Path parameters

- `checkout_session` string, required

## Query parameters

- `category` string

## Response `200`

200

- object[]
  - `name` string
  - `vaulted_token` string
  - `description` string
  - `type` string
  - `category` string
  - `icon` string
  - `last_successfully_used` boolean
  - `last_successfully_used_at` string
  - `checkout` object
    - `session` string
    - `sdk_required_action` boolean
    - `conditions` object
      - `enabled` boolean
      - `rules` object[] — List of condition rules (INCLUDE/EXCLUDE) applied to the payment method. Each rule has a type (e.g. METADATA, AMOUNT, COUNTRY) and values.
        - `condition` string — INCLUDE or EXCLUDE
        - `condition_group_code` string — UUID of the condition group
        - `condition_name` string — Human-readable name of the condition
        - `type` string — Rule type: METADATA, AMOUNT, COUNTRY, etc.
        - `values` object — Values used by the rule. Structure depends on rule type: `currency`, `max`, and `min` are strings (nullable); `countries` is an array of strings (e.g. ["AF"]); `metadata` is an array of objects with `key` and `value` (e.g. [{"key": "test", "value": "test"}]).
          - `countries` string[], nullable — Array of country codes (e.g. ["AF"], ["US"]). Null when not used by the rule.
          - `currency` string, nullable — Currency code when rule type is AMOUNT. Null otherwise.
          - `max` string, nullable — Maximum value when applicable. Null otherwise.
          - `metadata` object[], nullable — Array of key-value objects (e.g. [{"key": "test", "value": "test"}]). Null when not used by the rule.
            - `key` string
            - `value` string
          - `min` string, nullable — Minimum value when applicable. Null otherwise.
  - `card_data` object
    - `iin` string
    - `lfd` string
    - `expiration_month` integer
    - `expiration_year` integer
    - `number_length` integer
    - `security_code_length` integer
    - `brand` string
    - `issuer` string
    - `issuer_code` unknown
    - `category` string
    - `type` string
  - `preferred` boolean

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)