Activation And Health

Activation links a physical POS terminal to its OpenApp integration profile. The merchant generates a short-lived PIN in the merchant panel and the POS operator enters the merchant tax identifier and PIN into the POS. After OpenApp validates the PIN, the POS receives credentials for subsequent POS-to-OpenApp calls and, if queue delivery is configured, queue credentials for receiving OpenApp-initiated commands.

The activation call itself is a bootstrap operation and does not use HMAC signing because POS credentials do not yet exist. See Authorization.

After activation, the POS reports health to OpenApp on activation and at regular heartbeat intervals.

Message types:

Message type	Direction	Purpose
ActivatePos	POS -> OpenApp	Submit merchant tax identifier and PIN to activate the POS.
PosActivationResponse	OpenApp -> POS	Return activation result and, on success, credentials and delivery config.
ReportPosHealth	POS -> OpenApp	Report POS health on activation and at regular intervals.