Webhooks &
Events

Receive real-time notifications about events in your account. Implement webhooks to automate workflows and keep your application synchronized.

6

Steps

50min

Total time

15+

Event types

99.9%

Delivery rate

Webhook Configuration

Follow these 6 steps to implement webhooks

Paso 1: Webhook Configuration

Create and configure your first webhook

5 min
Easy

Overview

Webhooks allow you to receive real-time notifications about events occurring in your DXBNK account. Set up your first webhook to start receiving automatic updates.

Instructions

  1. 1Access the Webhooks section in your dashboard
  2. 2Click on 'Create New Webhook'
  3. 3Enter your endpoint URL
  4. 4Select the events you want to listen to
  5. 5Configure the secret for validation

Tips

  • Use HTTPS for your webhook endpoint
  • The endpoint must respond with 200 OK
  • Store the secret in a secure location
  • Test your endpoint before activating the webhook

Example

// Crear webhook via API
const webhook = await dxbnk.webhooks.create({
  url: 'https://tu-app.com/webhook',
  events: [
    'transaction.completed',
    'wallet.created',
    'user.verified'
  ],
  secret: 'tu_secreto_super_seguro',
  active: true
});

console.log('Webhook creado:', webhook.id);

Paso 2: Webhook Validation

Implement signature validation for security

10 min
Intermediate

Paso 3: Event Handling

Process different event types

15 min
Intermediate

Paso 4: Retries and Errors

Implement retry logic

12 min
Intermediate

Paso 5: Webhook Testing

Test webhooks locally

10 min
Easy

Paso 6: Monitoring and Debugging

Monitor webhooks in production

Continuo
Intermediate

Event Types

Available events for your webhooks

transaction.completed

Transaction completed successfully

transaction.failed

Transaction failed or was rejected

wallet.created

New wallet created by user

wallet.updated

Wallet information updated

user.verified

User completed KYC verification

user.updated

User information updated

Best Practices

Recommendations for robust webhooks

Always validate webhook signature
Respond quickly (< 5 seconds)
Implement asynchronous processing
Use idempotency to avoid duplicates
Implement retries with exponential backoff
Monitor and alert on failures
Use HTTPS for all endpoints
Maintain detailed event logs

Need help with webhooks?

Check our complete webhook documentation or contact our support team for technical assistance.

View Documentation