> ## 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.

# Update a merchant

> Update a merchant's profile. At least one of `merchantName`, `merchantEmail`, or `iconUrl` must be provided. Pass `iconUrl: null` to unset the existing logo.



## OpenAPI

````yaml api/2026-02-18.json PATCH /v1/merchants/{merchantId}
openapi: 3.1.0
info:
  title: WalletConnect Pay API
  version: '2026-02-18'
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}:
    patch:
      tags:
        - Merchant Management
      summary: Update a merchant
      description: >-
        Update a merchant's profile. At least one of `merchantName`,
        `merchantEmail`, or `iconUrl` must be provided. Pass `iconUrl: null` to
        unset the existing logo.
      operationId: MerchantManagement_update
      parameters:
        - schema:
            type: string
          in: path
          name: merchantId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantName:
                  description: Updated display name
                  examples:
                    - Acme Store v2
                  type: string
                  minLength: 1
                  maxLength: 256
                merchantEmail:
                  description: Updated contact email
                  examples:
                    - new-billing@acme.store
                  type: string
                  format: email
                  pattern: >-
                    ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                iconUrl:
                  description: Updated logo URL (HTTPS only), or null to unset
                  examples:
                    - https://example.com/new-logo.png
                  anyOf:
                    - type: string
                      format: uri
                    - type: 'null'
      responses:
        '200':
          description: Merchant updated
          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'
                    required:
                      - id
                      - name
                      - email
                      - status
                      - iconUrl
                      - createdAt
                required:
                  - merchant
              example:
                merchant:
                  id: mrch_7kBz2qR9xPvLmN4Yw
                  name: Acme Store v2
                  email: billing@acme.store
                  status: active
                  iconUrl: https://imagedelivery.net/example/acme-icon.png
                  createdAt: '2025-06-15T10:30:00.000Z'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Human-readable error message
                  code:
                    type: string
                    const: params_validation
                    description: Machine-readable error code
                  details:
                    description: Additional structured error details
                    type: object
                    propertyNames:
                      type: string
                    additionalProperties: {}
                  issues:
                    type: array
                    description: >-
                      Field-level validation issues (present on validation
                      errors)
                    items:
                      type: object
                      required:
                        - field
                        - message
                      properties:
                        field:
                          type: string
                        message:
                          type: string
                required:
                  - message
                  - code
              examples:
                params_validation:
                  summary: Validation failed
                  value:
                    code: params_validation
                    message: Validation failed
        '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.

````