Skip to main content
PUT
Update counter

Authorizations

Authorization
string
header
required

Keycloak JWT. Roles: admin (platform admin — can register merchants, act on behalf of any merchant), merchant (dashboard user — scoped to their own merchant_id via user attribute mapper), POS terminals use client credentials flow with merchant_id injected via protocol mapper.

Path Parameters

counterID
string<uuid>
required

Counter ID

Body

application/json

All fields are optional — only provided fields are updated

name
string
Example:

"Counter 1 (updated)"

location
string
Example:

"Ground Floor, Register 1"

webhook_url
string<uri>
Example:

"https://pos.example.com/webhooks/v2/payments"

Response

Counter updated

success
boolean
Example:

true

counter
object

A POS terminal belonging to a merchant