Webhooks

Webhooks let mySubwallet notify your system about real-time events — primarily transaction status updates — so you don’t have to poll the API.

Setup

Add your callback URL

In your dashboard, set your callback URL — a public HTTPS endpoint on your server.

Receive events

mySubwallet sends a POST request with a JSON body to that URL whenever a transaction’s status changes.

Acknowledge

Respond with 200 OK quickly. Do your processing asynchronously where possible.

Your callback URL must be configured in the dashboard for webhooks to fire.

{
  "status": "success",
  "request-id": "Data_12345678900",
  "response": "You have gifted 500MB to 2347013397088."
}

Match on request-id

Always reconcile events using your unique request-id, not the message text.

Be idempotent

The same event may be delivered more than once. Make sure processing the same request-id twice is safe.

Respond fast

Return 200 immediately; queue heavier work so the request doesn’t time out.