Skip to main content
PUT
/
v2
/
giftcards
/
merchants
/
settings
Savemerchantsettings
curl --request PUT \
  --url https://api.loyalty.dog/v2/giftcards/merchants/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "programId": "<string>",
  "locationId": "<string>",
  "merchantId": "<string>"
}
'
{
  "id": "<string>",
  "merchantId": "5eb7cf5a86d9755df3a6c593",
  "name": "<string>",
  "platform": "<string>",
  "programId": "<string>",
  "active": true,
  "locationId": "<string>",
  "locationName": "<string>",
  "locations": [
    {
      "locationId": "<string>",
      "locationName": "<string>",
      "lastSeenAt": "<string>",
      "programId": "<string>"
    }
  ],
  "cashierId": "<string>",
  "terminalId": "<string>",
  "role": "<string>",
  "sessionToken": "<string>"
}

Authorizations

Authorization
string
header
required

JWT access token obtained from POST /v2/token.

Headers

X-Eposn-Merchant-Token
string | null

Body

application/json

Payload for saving per-location merchant settings.

programId
string | null

LoyaltyDog programme ID to link to the active location

Maximum string length: 100
locationId
string | null

Location to update; defaults to the first location if omitted

Maximum string length: 100
merchantId
string | null

User ID of the merchant

Maximum string length: 100

Response

Successful Response

Returned after a successful merchant session init or validation.

Contains everything needed to populate the eposn-giftcards session without an additional core_api round-trip.

id
string
required
merchantId
string | null
required
Required string length: 24
Pattern: ^[0-9a-f]{24}$
Example:

"5eb7cf5a86d9755df3a6c593"

name
string | null
required
platform
string
required
programId
string | null
required
active
boolean
required
locationId
string | null
required
locationName
string | null
required
locations
MerchantLocationResponse · object[]
required
cashierId
string | null
terminalId
string | null
role
string | null
sessionToken
string | null