API Reference

Transaction Notification

Push real-time payment events from your CBS to Soundbox devices.

Endpoint Configuration

Transaction Config
Throttling & Denominations

Parameter Explanations

txnId
Mandatory. Unique Transaction Identifier. Used for idempotency to prevent duplicate announcements.
deviceSn
Mandatory. The 14-digit Serial Number of the Soundbox device.
amount
Mandatory. Numeric value to be displayed/broadcasted. Supports up to 2 decimal places.
authCode
Mandatory. The Authorization Code used to classify this transaction segment.
timestamp
Mandatory. 16-digit Epoch timestamp of the transaction event.

Broadcast Flow

Step 1: CBS sends payload to /message/send.

Step 2: Payvala validates HMAC and verifies device status.

Step 3: Message is queued in MQTT Broker for immediate delivery.

Step 4: Soundbox receives data and performs localized audio playback.