Skip to main content
GET
Get merchant identity for the authenticated provider

Authorizations

Authorization
string
header
required

Provider secret API key (sk_live_… / sk_test_…) supplied as a Bearer token.

Response

Merchant identity

displayName
string
required

Brand name shown in UI

Example:

"Acme"

Legal entity name used in SCA mandate copy

Example:

"Acme Inc."

companyNumber
string

Company registration number (EIN, Companies House No, Org No)

Example:

"HRB12345"

country
string

ISO-3166 alpha-2 country code of the merchant

Example:

"US"

defaultCurrency
string

ISO-4217 default settlement currency

Example:

"usd"

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.

Example:

"https://cdn.acme.com/icon.png"

logoUrl
string

Absolute URL to the merchant logo

Example:

"https://cdn.acme.com/logo.png"

privacyUrl
string
Example:

"https://acme.com/privacy"

statementDescriptor
string

Descriptor appearing on the customer card statement

Example:

"ACME INC"

supportedTopupCurrencies
string[]

Full set of currencies a customer may pay credit topups in, including the default currency. Omitted/single-entry means single-currency behavior.

Example:
supportEmail
string
Example:

"support@acme.com"

supportUrl
string
Example:

"https://acme.com/support"

taxId
string

Tax identification number (US: EIN)

Example:

"12-3456789"

termsUrl
string
Example:

"https://acme.com/terms"

vatNumber
string

VAT identification number (UK/EU)

Example:

"DE123456789"