Notifications

Webhooks allow your system to receive real-time HTTP POST notifications when the status of your transaction changes. Instead of continuously polling our API to check the order status, our server will automatically send the final transaction details to your application the moment an order becomes Success or Failed.

Important Requirement: To start receiving these notifications, you must configure your active Callback URL in the Settings menu on our dashboard.

System Flow

Payload Dictionary

Field	Type	Description
`event`	String	The identifier for the webhook event type. This value will be "transaction.success" for successfully completed orders, and "transaction.failed" for orders that failed to process.
`ref_id`	String	The unique reference ID provided by your system when the order was initially created.
`order_id`	String	The unique transaction ID generated by our server.
`service_code`	String	The specific code of the purchased product or service.
`service_name`	String	The human-readable name of the purchased product or service (e.g., "Weekly Diamond Pass").
`status`	String	The final status of the transaction. The value will be "Success" or "Failed".
`price`	Integer	The exact amount deducted from your balance for this transaction.
`purchase_time`	String	The exact date and time when the transaction reached its final status, formatted in ISO 8601 (e.g., `"2026-03-01T02:40:15+07:00"`).
`notes`	String	Additional information or remarks regarding the transaction. Typically contains `"-"` if there are no specific notes.
`signature`	String	The security hash used to verify the authenticity of the webhook payload. Generated using: `HMAC_SHA256(secret_key, ref_id + status)`

Example Payload

{
    "event": "transaction.success",
    "ref_id": "TRX20260301070",
    "order_id": "BSD21BDE12D5",
    "service_code": "BSML301E881",
    "service_name": "Weekly Diamond Pass",
    "status": "Success",
    "price": 28616,
    "purchase_time": "2026-03-01T02:40:15+07:00",
    "notes": "-",
    "signature": "a1b2c3d4e5f6g7h8i9j0k1xxxxxx"
}

System Flow#

Payload Dictionary#

Example Payload#

Handling the Webhook (Example)#

System Flow

Payload Dictionary

Example Payload

Handling the Webhook (Example)