Skip to main content
PUT
/
v2
/
giftcards
/
merchants
/
theme
Savemerchanttheme
curl --request PUT \
  --url https://api.loyalty.dog/v2/giftcards/merchants/theme \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "presetId": "eposn-default",
  "primary": "#15803d",
  "primaryFg": "#ffffff",
  "sidebarBg": "#ffffff",
  "sidebarText": "#4b5563",
  "sidebarActiveBg": "#f0fdf4",
  "sidebarActiveText": "#15803d",
  "sidebarBadge": "#15803d",
  "background": "#f9fafb",
  "foreground": "#111827",
  "surface": "#ffffff",
  "border": "#e5e7eb",
  "muted": "#6b7280",
  "logoUrl": "<string>",
  "logoAlt": "<string>",
  "fontFamily": "<string>",
  "borderRadius": "lg"
}
'
{
  "theme": {
    "presetId": "eposn-default",
    "primary": "#15803d",
    "primaryFg": "#ffffff",
    "sidebarBg": "#ffffff",
    "sidebarText": "#4b5563",
    "sidebarActiveBg": "#f0fdf4",
    "sidebarActiveText": "#15803d",
    "sidebarBadge": "#15803d",
    "background": "#f9fafb",
    "foreground": "#111827",
    "surface": "#ffffff",
    "border": "#e5e7eb",
    "muted": "#6b7280",
    "logoUrl": "<string>",
    "logoAlt": "<string>",
    "fontFamily": "<string>",
    "borderRadius": "lg"
  },
  "validation": {},
  "performance": {
    "cssVarChanges": 123,
    "hasCustomFont": true,
    "hasLargeLogo": true,
    "issues": [
      {
        "severity": "<string>",
        "code": "<string>",
        "message": "<string>",
        "estimatedMs": 123
      }
    ],
    "score": 123
  }
}

Authorizations

Authorization
string
header
required

JWT access token obtained from POST /v2/token.

Headers

X-Eposn-Merchant-Token
string | null

Body

application/json

Persisted merchant-facing theme configuration for the EPOSN portal.

presetId
string
default:eposn-default
Required string length: 1 - 100
primary
string
default:#15803d
Maximum string length: 7
primaryFg
string
default:#ffffff
Maximum string length: 7
sidebarBg
string
default:#ffffff
Maximum string length: 7
sidebarText
string
default:#4b5563
Maximum string length: 7
sidebarActiveBg
string
default:#f0fdf4
Maximum string length: 7
sidebarActiveText
string
default:#15803d
Maximum string length: 7
sidebarBadge
string
default:#15803d
Maximum string length: 7
background
string
default:#f9fafb
Maximum string length: 7
foreground
string
default:#111827
Maximum string length: 7
surface
string
default:#ffffff
Maximum string length: 7
border
string
default:#e5e7eb
Maximum string length: 7
muted
string
default:#6b7280
Maximum string length: 7
logoUrl
string | null
Maximum string length: 2048
logoAlt
string | null
Maximum string length: 255
fontFamily
string | null
Maximum string length: 255
Pattern: ^[A-Za-z0-9 ,'\"._\-]+$
borderRadius
enum<string>
default:lg
Available options:
none,
sm,
md,
lg,
full

Response

Successful Response

theme
GiftCardMerchantTheme · object
required

Persisted merchant-facing theme configuration for the EPOSN portal.

validation
Validation · object
required
performance
ThemePerformanceReport · object
required