API Reference

Transaction Notification

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

Endpoint Configuration

Transaction Config

Endpoint Setup

This screen is used to configure transaction push endpoints and delivery behavior for soundbox notifications.

Save Result

After saving, the next visible state is the configured transaction profile where endpoint values can be reviewed or edited later.

Throttling & Denominations

Throttling Rules

These controls define request pacing, denomination handling, and operational restrictions before messages are accepted for delivery.

Next Effect

Once updated, the transaction engine applies the saved limits when processing incoming notification payloads.

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.