Skip to content
Back to Home

How It Works

From API call to SMS delivery in seconds — fully automated, fully reliable.

Step 1

API Call

Your system sends a POST request to the HANARAD SMS API with the recipient's mobile number and message content.

Supports REST API with JSON payload. Authentication via Bearer token.

Step 2

Stored as Pending

The request is immediately saved to the database with 'Pending' status and assigned a unique message ID.

Persistent storage ensures no message is lost even during network interruptions.

Step 3

Push Notification

A push notification is instantly triggered to wake the HANARAD SMS app on the registered device.

Works even when the app is closed using broadcast receivers.

Step 4

SIM Sends SMS

The app reads the pending request and sends the SMS directly via the device's SIM card.

SIM-to-SIM delivery. No third-party SMS provider needed.

Step 5

Status Sync

Delivery status is synced back to the server in real-time as the SMS is processed.

Webhook callbacks notify your system of status changes instantly.

Step 6

Completed

Status is updated from Pending → Completed. Failures are logged with error codes for retry.

Full audit trail with timestamps for compliance and debugging.

Works in Every App State

App Open (Foreground)

Full real-time processing with live dashboard updates.

App in Background

Background services keep processing via push notifications.

App Closed

Broadcast receivers auto-wake the app for new requests.