Getting Started with Notifications

This guide will walk you through setting up Xellar's wallet activity notification service.

Dashboard Configuration

Step 1: Enable Notification Service

1. Navigate to the "Services" section in your Xellar dashboard
2. Find the "Notification Service" card
3. Toggle the "Service Status" switch to "Enabled"

Step 2: Configure Webhook URL

1. Go to the "Developer" section in the dashboard
2. Select "Webhook" from the menu
3. Enter your webhook URL in the "Notification Webhook URL" field
4. Click "Save" to store your webhook configuration

Adding Wallets to Notification Service

Wallets can be added to the notification service only during wallet creation through the Embedded Wallet / TSS wallet service API. Manual addition of wallets through the dashboard is not supported.

Creating a Wallet with Notifications

When creating a new wallet using the Embedded Wallet / TSS create account operation, include the isEnableNotif parameter in your request. For more detailed information about creating accounts with notifications enabled, see the Embedded Wallet Create Account Operation / TSS Create Account Operation documentation.

Managing Wallet Notifications

Once wallets are created, you can:

1. View all registered wallets in the Notification Service dashboard
2. Enable/disable notifications per wallet using the toggle switch in the "Notification Status" column
3. Filter wallets by network using the "Select Network" dropdown
4. Search for specific wallet addresses using the search bar

Notification Status

The dashboard shows the following information for each wallet:

• Wallet Address
• Service Type (TSS/EW/AA)
• Network Type
• Creation Date
• Notification Status (Enabled/Disabled)

Coming Soon

Support for enabling notifications will be available for:

• Account Abstraction Wallets

Best Practices

1. Service Setup

   • Enable the notification service before creating new wallets
   • Configure your webhook URL
   • Keep your webhook endpoint secure and highly available
   
   

2. Wallet Management

   • Plan which wallets need notifications before creation
   • Use the dashboard to monitor notification status
   • Keep track of which wallets have notifications enabled
   
   

3. Webhook Handling

   • Implement proper error handling in your webhook endpoint
   • Process webhook events asynchronously
   • Verify webhook signatures for security

Next Steps

• Review the Webhook Integration Guide for detailed webhook setup
• Check Supported Networks for network coverage

Troubleshooting

Common Issues

1. Notifications Not Received

   • Verify the notification service is enabled in dashboard
   • Check if the specific wallet has notifications enabled
   • Verify your webhook URL is correctly configured
   • Check your webhook endpoint logs
   
   

2. Wallet Not Listed

   • Confirm the wallet was created with isEnableNotif: true
   • Verify the wallet was created using the Embedded Wallet / TSS service
   • Check if the network is supported

Need help? Contact our support team or check our documentation for more information.