---
title: "Get merchant identity for the authenticated provider"
method: GET
path: "/v1/sdk/merchant"
tags: ["Merchant"]
---

# Get merchant identity for the authenticated provider

`GET /v1/sdk/merchant`

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.

## Response `200`

Merchant identity

- SdkMerchantResponseDto
  - `companyNumber` string — Company registration number (EIN, Companies House No, Org No)
  - `country` string — ISO-3166 alpha-2 country code of the merchant
  - `defaultCurrency` string — ISO-4217 default settlement currency
  - `displayName` string, required — Brand name shown in UI
  - `iconUrl` string — 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.
  - `legalName` string, required — Legal entity name used in SCA mandate copy
  - `logoUrl` string — Absolute URL to the merchant logo
  - `privacyUrl` string
  - `statementDescriptor` string — Descriptor appearing on the customer card statement
  - `supportedTopupCurrencies` string[] — Full set of currencies a customer may pay credit topups in, including the default currency. Omitted/single-entry means single-currency behavior.
  - `supportEmail` string
  - `supportUrl` string
  - `taxId` string — Tax identification number (US: EIN)
  - `termsUrl` string
  - `vatNumber` string — VAT identification number (UK/EU)

## Other responses

- `404` — 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.

---

[API](https://skmtc.net/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.net/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/versions/bbc2ff2bc849/schema)