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

# Get a merchant

> Fetch a merchant's profile along with its configured `settlements` (crypto and fiat). Crypto settlements use [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset IDs and [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) destination accounts.



## OpenAPI

````yaml api/2026-02-19.preview.json GET /v1/merchants/{merchantId}
openapi: 3.1.0
info:
  title: WalletConnect Pay API
  version: 2026-02-19.preview
servers:
  - url: https://api.pay.walletconnect.com
security:
  - API Key: []
  - ApiKey: []
  - AppId: []
tags:
  - name: Gateway
  - name: Payments
  - name: Refunds
  - name: Merchant Management
  - name: Settlements
  - name: Crypto Settlement
paths:
  /v1/merchants/{merchantId}:
    get:
      tags:
        - Merchant Management
      summary: Get a merchant
      description: >-
        Fetch a merchant's profile along with its configured `settlements`
        (crypto and fiat). Crypto settlements use
        [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset IDs and
        [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) destination accounts.
      operationId: MerchantManagement_get
      parameters:
        - schema:
            type: string
          in: path
          name: merchantId
          required: true
      responses:
        '200':
          description: Merchant details
          content:
            application/json:
              schema:
                type: object
                properties:
                  merchant:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Merchant ID
                        examples:
                          - mrch_7kBz2qR9xPvLmN4Yw
                      name:
                        description: Merchant display name
                        type: string
                      email:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Contact email
                        examples:
                          - billing@acme.store
                      status:
                        type: string
                        enum:
                          - active
                          - inactive
                          - suspended
                        description: Current merchant status
                        examples:
                          - active
                      iconUrl:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: Merchant logo URL, or null if not set
                        examples:
                          - https://imagedelivery.net/example/acme-icon.png
                      createdAt:
                        type: string
                        description: ISO 8601 creation timestamp
                        examples:
                          - '2025-06-15T10:30:00.000Z'
                      settlements:
                        type: object
                        properties:
                          crypto:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: Crypto settlement ID
                                asset:
                                  type: string
                                  description: >-
                                    [CAIP-19](https://standards.chainagnostic.org/CAIPs/caip-19)
                                    asset ID
                                  examples:
                                    - >-
                                      eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
                                destination:
                                  type: string
                                  description: >-
                                    [CAIP-10](https://standards.chainagnostic.org/CAIPs/caip-10)
                                    settlement destination
                                  examples:
                                    - >-
                                      eip155:8453:0x1234567890abcdef1234567890abcdef12345678
                              required:
                                - id
                                - asset
                                - destination
                          fiat:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: Settlement config ID
                                status:
                                  type: string
                                  description: Fiat settlement status
                                bankType:
                                  type: string
                                  description: Bank account type
                              required:
                                - id
                                - status
                                - bankType
                        required:
                          - crypto
                          - fiat
                    required:
                      - id
                      - name
                      - email
                      - status
                      - iconUrl
                      - createdAt
                      - settlements
                required:
                  - merchant
              example:
                merchant:
                  id: mrch_7kBz2qR9xPvLmN4Yw
                  name: Acme Store
                  email: billing@acme.store
                  status: active
                  iconUrl: https://imagedelivery.net/example/acme-icon.png
                  createdAt: '2025-06-15T10:30:00.000Z'
                  settlements:
                    crypto:
                      - id: crypto_Xk7nWp8XmQj2YrTv6
                        asset: >-
                          eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
                        destination: eip155:8453:0x1234567890abcdef1234567890abcdef12345678
                    fiat:
                      - id: fiat_Bk4nWp8XmQj2YrTv6
                        status: active
                        bankType: ACH
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Human-readable error message
                  code:
                    type: string
                    enum:
                      - missing_api_key
                      - invalid_api_key
                    description: Machine-readable error code
                  details:
                    description: Additional structured error details
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - message
                  - code
              examples:
                missing_api_key:
                  summary: Missing API key
                  value:
                    code: missing_api_key
                    message: Missing API key
                invalid_api_key:
                  summary: Invalid API key
                  value:
                    code: invalid_api_key
                    message: Invalid API key
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Human-readable error message
                  code:
                    type: string
                    const: not_found
                    description: Machine-readable error code
                  details:
                    description: Additional structured error details
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                required:
                  - message
                  - code
              examples:
                not_found:
                  summary: Not Found
                  value:
                    code: not_found
                    message: Not Found
components:
  securitySchemes:
    API Key:
      type: apiKey
      in: header
      name: Api-Key
    ApiKey:
      type: apiKey
      in: header
      name: Api-Key
      description: Private API key for wallet authentication
    AppId:
      type: apiKey
      in: header
      name: App-Id
      description: >-
        Public App ID for wallet authentication. When using this auth mode, the
        Client-Id header is also required.

````