Skip to main content

​
Account Activated

Event Name: account_activated
This event signifies that the account is now ready for operational use and transactions can be processed.

​
Event Payload

The webhook payload contains the following structure: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "event": "account_activated",
  "timestamp": "2025-06-19T16:04:13.123Z",
  "data": {
    "accountId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

​
Payload Fields

​
id
string
required
Unique identifier for this webhook event
​
event
string
required
Event type - always account_activated for this webhook
​
timestamp
string
required
ISO 8601 timestamp indicating when the event occurred
​
data.accountId
string
required
Unique identifier of the account that was activated

​
Expected Responses

Success Response

HTTP 200 OKThe webhook was processed successfully.

Client Error

HTTP 4xx StatusClient-side error. Will not be retried.

Server Error

HTTP 5xx StatusServer-side error. Will be retried with exponential backoff.

​
Implementation Example

app.post('/webhooks/ralio', (req, res) => {
  const { event, data } = req.body;
  
  if (event === 'account_activated') {
    const { accountId } = data;
    
    // Process account activation
    console.log(`Account ${accountId} has been activated`);
    
    // Update your internal systems
    await updateAccountStatus(accountId, 'ACTIVE');
    
    // Respond with success
    res.status(200).json({ received: true });
  }
});