> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meld.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Search supported payment methods

> Searches payment methods supported across providers. Results are deduplicated across providers and returned as canonical payment-method entries with logo URLs for the requested filters. Provider scope rules:
- No Basic Auth and no `Meld-Account-Id`: results come from the global dataset.
- Basic Auth only: results are restricted to the authenticated identity's `providers` claim.
- `Meld-Account-Id` only: results are restricted to providers configured for that account.
- Both Basic Auth and `Meld-Account-Id`: results are restricted to the intersection of both provider sets.
- Explicit partner filters are intersected with the resolved provider scope.

Explicit `partners` filtering is intersected with the resolved provider scope.
If the effective provider scope contains no providers, this collection endpoint returns `200` with an empty result.



## OpenAPI

````yaml /openapi/networkpartner-20260203.json get /network-partner/supported/payment-methods
openapi: 3.1.0
info:
  title: Network Partners
  version: '2026-02-03'
servers:
  - url: https://api.meld.io
security: []
paths:
  /network-partner/supported/payment-methods:
    get:
      tags:
        - Supported
      summary: Search supported payment methods
      description: >-
        Searches payment methods supported across providers. Results are
        deduplicated across providers and returned as canonical payment-method
        entries with logo URLs for the requested filters. Provider scope rules:

        - No Basic Auth and no `Meld-Account-Id`: results come from the global
        dataset.

        - Basic Auth only: results are restricted to the authenticated
        identity's `providers` claim.

        - `Meld-Account-Id` only: results are restricted to providers configured
        for that account.

        - Both Basic Auth and `Meld-Account-Id`: results are restricted to the
        intersection of both provider sets.

        - Explicit partner filters are intersected with the resolved provider
        scope.


        Explicit `partners` filtering is intersected with the resolved provider
        scope.

        If the effective provider scope contains no providers, this collection
        endpoint returns `200` with an empty result.
      operationId: list-supported-payment-methods
      parameters:
        - description: Provider category
          example: CRYPTO_ONRAMP
          name: category
          in: query
          schema:
            $ref: '#/components/schemas/Category'
        - description: Country code
          example: US
          name: country
          in: query
          schema:
            type: string
        - description: Currency code
          example: EUR
          name: currencyCode
          in: query
          schema:
            type: string
        - description: Comma-separated partner ids
          example: BANXA,MOONPAY
          name: partners
          in: query
          schema:
            type: string
        - description: Payment method type
          example: CARD
          name: paymentType
          in: query
          schema:
            $ref: '#/components/schemas/PaymentType'
        - description: Country subdivision code. Supported for US and CA only.
          example: US-NY
          name: subdivision
          in: query
          schema:
            type: string
        - description: >-
            Optional. Base58 encoded account id. Restricts results to providers
            configured for the account. If Basic Auth is also present, the
            effective scope is the intersection of authenticated providers and
            account providers.
          name: Meld-Account-Id
          in: header
          schema:
            type: string
      responses:
        '200':
          description: Supported payment method list
          content:
            application/json:
              examples:
                supportedPaymentMethods:
                  summary: Matching supported payment methods
                  value:
                    - countryCode: US
                      providerMethod: CARD
                      method: CREDIT_DEBIT_CARD
                      name: Credit or debit card
                      type: CARD
                      logo:
                        dark: >-
                          https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_dark.png
                        light: >-
                          https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_light.png
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SupportedPaymentMethod'
components:
  schemas:
    Category:
      type: string
      enum:
        - CRYPTO_ONRAMP
        - CRYPTO_OFFRAMP
        - CRYPTO_TRANSFER
        - BANK_LINKING
        - FIAT_PAYMENTS
        - CRYPTO_VIRTUAL_ACCOUNT_ONRAMP
        - CRYPTO_VIRTUAL_ACCOUNT_OFFRAMP
        - CUSTOMER_KYC
        - CRYPTO_ONRAMP_SWAP
        - CRYPTO_OFFRAMP_SWAP
      description: Categories of functionality offered by a service provider
    PaymentType:
      type: string
      enum:
        - BANK_TRANSFER
        - CARD
        - CASH
        - EXCHANGE
        - LOCAL
        - MOBILE_WALLET
      description: Enumeration of payment method types supported by the platform
    SupportedPaymentMethod:
      type: object
      description: Supported payment method representation
      properties:
        countryCode:
          type: string
          examples:
            - US
          description: Country code
        providerMethod:
          type: string
          examples:
            - CARD
          description: Provider payment method code
        method:
          type: string
          examples:
            - CREDIT_DEBIT_CARD
          description: Payment method code
        name:
          type: string
          examples:
            - Credit or debit card
          description: Payment method name
        type:
          type: string
          examples:
            - CARD
          description: Payment method type
        logo:
          type: object
          description: Payment method logo variants
          allOf:
            - $ref: '#/components/schemas/PaymentMethodLogo'
        headlessSupported:
          type: boolean
          description: >-
            Whether this method is enabled for headless flows in the response
            context. For multi-provider search, true when any matching provider
            supports it headlessly.
        cardRenderMode:
          type: string
          description: >-
            Card render mode; only populated for CREDIT_DEBIT_CARD when
            headlessSupported
          allOf:
            - $ref: '#/components/schemas/CardRenderMode'
    PaymentMethodLogo:
      type: object
      description: Payment method logo variants
      properties:
        dark:
          type: string
          examples:
            - >-
              https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_dark.png
          description: Dark logo URL
        light:
          type: string
          examples:
            - >-
              https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_light.png
          description: Light logo URL
    CardRenderMode:
      type: string
      enum:
        - IFRAME
        - REDIRECT
      description: Render mode for CREDIT_DEBIT_CARD payment method in headless flows

````