Skip to main content
GET
/
v1
/
sdk
/
merchant
Get merchant identity for the authenticated provider
curl --request GET \
  --url https://api.example.com/v1/sdk/merchant
{
  "displayName": "Acme",
  "legalName": "Acme Inc.",
  "country": "US",
  "defaultCurrency": "usd",
  "iconUrl": "https://cdn.acme.com/icon.png",
  "logoUrl": "https://cdn.acme.com/logo.png",
  "privacyUrl": "https://acme.com/privacy",
  "statementDescriptor": "ACME INC",
  "supportEmail": "support@acme.com",
  "supportUrl": "https://acme.com/support",
  "termsUrl": "https://acme.com/terms"
}

Response

Merchant identity

​
displayName
string
required

Brand name shown in UI

Example:

"Acme"

​
legalName
string
required

Legal entity name used in SCA mandate copy

Example:

"Acme Inc."

​
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"

​
supportEmail
string
Example:

"support@acme.com"

​
supportUrl
string
Example:

"https://acme.com/support"

​
termsUrl
string
Example:

"https://acme.com/terms"