Alder

API

Alder API

Reference for the loyalty API. These examples describe the contract. This workspace answers them from local state and does not call a server.

Auth

Open a role session

POST /v1/sessions

None. The workspace issues a bearer token after a role is chosen.

Request

{
  "role": "merchant",
  "merchant_id": "m_harbor"
}

Response

{
  "token": "ald_live_7f3a",
  "role": "merchant",
  "merchant_id": "m_harbor",
  "expires_in": 86400
}

Errors

  • 401 — missing or expired session.
  • 403 — role cannot touch this merchant.
  • 422 — balance too low, guest paused, or invalid dates.

curl

curl https://api.alder.so/v1/sessions \
  -H "Authorization: Bearer ald_live_7f3a" \
  -H "Content-Type: application/json"