Get merchant identity for the authenticated provider

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.

GET /v1/sdk/merchant

Get merchant identity for the authenticated provider

cURL

curl --request GET \
  --url https://api.example.com/v1/sdk/merchant

200

{
  "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": "[e-mail]",
  "supportUrl": "https://acme.com/support",
  "termsUrl": "https://acme.com/terms"
}

Response

200

application/json

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:

"[e-mail]"

supportUrl · string

Example:

"https://acme.com/support"

termsUrl · string

Example:

"https://acme.com/terms"