Documentación de Webhooks

Recibe notificaciones en tiempo real para conversiones, pagos y eventos de campañas. Integra webhooks de BankRolls para construir aplicaciones de afiliados responsivas y automatizar tu flujo de trabajo.

Coming Soon

Documentación de Webhooks en Desarrollo

Nuestro sistema de webhooks está siendo mejorado con características avanzadas y documentación completa. Estamos construyendo la infraestructura de webhooks más confiable y segura para notificaciones de afiliados.

Lanzamiento Esperado: Q2 2024 | Características: Eventos en tiempo real, lógica de reintento, verificación de firma | Estado: Pruebas Beta

¿Qué son los Webhooks?

Los webhooks son callbacks HTTP que BankRolls envía a tu aplicación cuando ocurren eventos específicos. En lugar de sondear nuestra API por cambios, los webhooks empujan notificaciones en tiempo real directamente a tu servidor, permitiéndote:

Obtener notificaciones instantáneas de conversión

Recibir confirmaciones de pago

Rastrear cambios de estado de campaña

Automatizar flujos de trabajo de afiliados

Construir dashboards en tiempo real

Sincronizar datos con sistemas externos

Características Clave

Entrega en Tiempo Real

Eventos entregados en milisegundos desde que ocurren

Verificación Segura

Verificación de firma HMAC para solicitudes auténticas

Reintentos Automáticos

Lógica inteligente de reintentos con backoff exponencial

Eventos Configurables

Elige qué eventos recibir para tu caso de uso

Eventos de Webhook Disponibles

Aquí están los eventos de webhook que estarán disponibles en nuestro sistema completo:

conversion.createdAlto Volumen

Tiempo real

Activado cuando se rastrea una nueva conversión de jugador

payment.processedCrítico

Mensual

Enviado cuando el pago de afiliado ha sido procesado exitosamente

campaign.activatedCampaña

Según necesidad

Notificación cuando una nueva campaña se activa

deal.updatedAcuerdos

Según necesidad

Enviado cuando los términos de un acuerdo de casino son modificados

account.suspendedCuenta

Según necesidad

Notificación importante cuando el estado de la cuenta cambia

bonus.expiredBono

Diario

Notificación cuando los términos de bonos del jugador expiran

Muestra de Payload de Webhook

Evento conversion.created

{
  "event": "conversion.created",
  "timestamp": "2024-03-15T10:30:00Z",
  "data": {
    "conversion_id": "conv_abc123",
    "affiliate_id": "aff_xyz789",
    "campaign_id": "camp_def456",
    "casino": {
      "id": "casino_123",
      "name": "Premium Casino",
      "brand": "premium-casino"
    },
    "player": {
      "id": "player_789",
      "registration_date": "2024-03-15T10:29:45Z",
      "country": "ES",
      "currency": "EUR"
    },
    "commission": {
      "amount": 125.50,
      "currency": "EUR",
      "rate": 0.35,
      "type": "revenue_share"
    },
    "tracking": {
      "click_id": "click_ghi012",
      "source": "google",
      "medium": "cpc",
      "campaign": "promo_verano"
    }
  }
}

Seguridad y Mejores Prácticas

Verificación de Firma

Cada solicitud de webhook incluye una firma HMAC SHA-256 en el encabezado X-BankRolls-Signature. Siempre verifica esta firma para asegurar que la solicitud es auténtica.

Verificar firma HMAC
Usar secretos de webhook seguros
Validar frescura de timestamp

Manejo de Fallos

Diseña tus endpoints de webhook para manejar fallos graciosamente. Reintentaremos automáticamente entregas fallidas con backoff exponencial.

Retornar HTTP 200 para éxito
Implementar idempotencia
Manejar eventos duplicados

¿Listo para Integrar Webhooks?

Únete a nuestro programa beta para obtener acceso temprano a nuestro sistema de webhooks. Ayúdanos a construir el sistema de notificaciones de afiliados más confiable de la industria.

Preguntas Frecuentes

¿Qué pasa si mi endpoint de webhook está caído?

Reintentaremos automáticamente las entregas de webhook usando backoff exponencial por hasta 72 horas. También puedes reproducir manualmente eventos perdidos a través de tu dashboard.

¿Puedo probar webhooks antes de ponerlos en vivo?

¡Sí! Nuestro ambiente sandbox te permite probar todos los eventos de webhook con datos de muestra antes de procesar tráfico de afiliados en vivo.

¿Cómo manejo tráfico de webhook de alto volumen?

Recomendamos usar un sistema de cola de mensajes para procesar webhooks de forma asíncrona. Nuestra documentación incluirá patrones de arquitectura para escenarios de alto volumen.

Recibe notificaciones cuando la documentación de webhooks esté lista

Sé de los primeros en acceder a nuestro sistema completo de webhooks y documentación.