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

# Get merchant identity for the authenticated provider

> Returns the subset of provider data safe to render in a customer-facing checkout: display name, legal name, support contact, terms and privacy URLs, and logo. Used by SDK components like MandateText and CheckoutSummary.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/sdk/merchant
openapi: 3.0.0
info:
  contact: {}
  description: The SolvaPay REST API specification
  title: SolvaPay REST API
  version: '1.0'
servers: []
security: []
tags: []
paths:
  /v1/sdk/merchant:
    get:
      tags:
        - Merchant
      summary: Get merchant identity for the authenticated provider
      description: >-
        Returns the subset of provider data safe to render in a customer-facing
        checkout: display name, legal name, support contact, terms and privacy
        URLs, and logo. Used by SDK components like MandateText and
        CheckoutSummary.
      operationId: getMerchant
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SdkMerchantResponseDto'
          description: Merchant identity
        '404':
          description: >-
            Provider not found in the requested environment. Body includes a
            `code` (`provider_not_found_in_environment`), the
            `requestedEnvironment`, and `providerExistsInSandbox` so the SDK /
            CLI can branch on the recovery path.
      security:
        - SecretKey: []
components:
  schemas:
    SdkMerchantResponseDto:
      properties:
        companyNumber:
          description: Company registration number (EIN, Companies House No, Org No)
          example: HRB12345
          type: string
        country:
          description: ISO-3166 alpha-2 country code of the merchant
          example: US
          type: string
        defaultCurrency:
          description: ISO-4217 default settlement currency
          example: usd
          type: string
        displayName:
          description: Brand name shown in UI
          example: Acme
          type: string
        iconUrl:
          description: >-
            Absolute URL to the square app icon / logomark. Consumed by MCP host
            chromes, mobile avatar slots, and any surface where the landscape
            `logoUrl` would need letterboxing.
          example: https://cdn.acme.com/icon.png
          type: string
        legalName:
          description: Legal entity name used in SCA mandate copy
          example: Acme Inc.
          type: string
        logoUrl:
          description: Absolute URL to the merchant logo
          example: https://cdn.acme.com/logo.png
          type: string
        privacyUrl:
          example: https://acme.com/privacy
          type: string
        statementDescriptor:
          description: Descriptor appearing on the customer card statement
          example: ACME INC
          type: string
        supportedTopupCurrencies:
          description: >-
            Full set of currencies a customer may pay credit topups in,
            including the default currency. Omitted/single-entry means
            single-currency behavior.
          example:
            - USD
            - EUR
            - GBP
          items:
            type: string
          type: array
        supportEmail:
          example: support@acme.com
          type: string
        supportUrl:
          example: https://acme.com/support
          type: string
        taxId:
          description: 'Tax identification number (US: EIN)'
          example: 12-3456789
          type: string
        termsUrl:
          example: https://acme.com/terms
          type: string
        vatNumber:
          description: VAT identification number (UK/EU)
          example: DE123456789
          type: string
      required:
        - displayName
        - legalName
      type: object
  securitySchemes:
    SecretKey:
      bearerFormat: JWT
      description: >-
        Provider secret API key (sk_live_… / sk_test_…) supplied as a Bearer
        token.
      scheme: bearer
      type: http

````