Los webhooks de Chaingateway son notificaciones HTTPS que informan a su servidor de eventos de blockchain, como depósitos y transferencias de tokens. Usted registra una dirección y una URL, Chaingateway vigila la cadena y cada entrega lleva una firma HMAC. Las notificaciones fallidas se listan y se pueden reenviar por la API.

Eventos de blockchain en tiempo real entregados a su backend

Compatible con las principales blockchains

Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon, Arbitrum.

Configuración sencilla

Configuración rápida y sencilla para cualquier caso de uso.

Segura y escalable

Diseñada para manejar grandes volúmenes con la seguridad en mente.

Pensada para desarrolladores

Documentación completa y soporte para una integración sin fricciones.

Lance con confianza

¿Cómo funcionan las notificaciones de pago instantáneas?

Chaingateway envía un HTTP POST a su endpoint cuando una transacción coincide con un webhook que usted registró. El payload incluye el remitente, el receptor, el importe, el contrato del token y el ID de la transacción, así que puede conciliar el pago sin hacer polling de la cadena.

Puede rastrear transacciones entrantes y salientes y filtrar por dirección, contrato del token, ID del token o tipo. Un webhook necesita una url y al menos uno de los campos from o to.

1. Cree un receiver de webhook

Cree un endpoint seguro en su servidor para recibir y procesar notificaciones de webhook.

Ver tutorial de Receiver

Añada un webhook

Añada un webhook a su aplicación para recibir notificaciones en tiempo real de eventos de blockchain.

Ver documentación de la API

Reciba notificaciones

Reciba notificaciones en tiempo real de eventos de blockchain, para estar siempre al tanto de las actualizaciones importantes.

Ver demo

Añada seguridad

Proteja sus webhooks con firmas y autenticación para evitar accesos no autorizados.

Guía de seguridad
Evento on-chain una transferencia llega a la dirección POST a su URL payload JSON + cabecera X-Signature Su servidor verifica el HMAC y acredita el pago ¿Entrega no aceptada? No se reenvía automáticamente. Se lista como fallida y se reenvía con retry.
  1. Chaingateway vigila la dirección que usted registró y reacciona a las transferencias que coinciden.
  2. Cada notificación es un HTTP POST. La cabecera X-Signature es un HMAC SHA-256 en Base64 sobre el ID de la transacción y su secreto.
  3. Verifique la firma y acredite el pago una sola vez por ID de transacción, porque un reintento entrega de nuevo el mismo evento.
Del evento on-chain a su base de datos, incluida la vía de reintento manual.

¿Qué funciones de webhook incluye Chaingateway?

Los webhooks cubren Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon y Arbitrum. Puede filtrar por dirección y token, revisar cada notificación en el dashboard y verificar cada entrega con su firma HMAC.

Ver documentación

Entrega non-custodial

Los webhooks se disparan en Ethereum, Bitcoin, TRON, BSC, Polygon y Arbitrum sin que nuestro sistema custodie nunca sus claves ni sus fondos.

Reintento manual

Las notificaciones fallidas se pueden reintentar bajo demanda a través de la API.

Filtrado avanzado

Filtre fácilmente los webhooks para recibir solo los datos que necesita.

Compatibilidad con las principales blockchains

Somos compatibles con la mayoría de las blockchains principales.

Registro

Nuestro sistema registra todos los eventos de webhook y los muestra en una interfaz.

Reintentos

Las entregas fallidas aparecen en su lista de notificaciones, listas para reintentarse por API cuando usted quiera.

Rendimiento rápido

Nuestros webhooks están diseñados para la velocidad y la fiabilidad.

Firma segura

Todos los webhooks se firman de forma segura para verificar su autenticidad.

Soporte receptivo

Todos los planes incluyen soporte por correo electrónico y chat para su integración de webhooks.

Fácil de usar

Nuestra API intuitiva hace que gestionar sus webhooks sea muy sencillo.

¿Qué puede construir con notificaciones de eventos?

Cuatro patrones cubren la mayoría de los usos: monitorización de pagos salientes, liquidaciones entrantes, actualizaciones de titularidad de NFT y alertas entre cadenas.

Seguimiento de pagos de alto valor

Caso de uso

Supervise las transferencias salientes filtrando por su hot wallet mediante from + type (ETH/ERC20), para que finanzas reciba una alerta antes de que lleguen los fondos.

Liquidaciones entrantes

Caso de uso

Supervise su dirección de recepción usando to más el contractaddress opcional para confirmar depósitos en segundos, en lugar de esperar al polling.

Monitorización de actividad NFT

Caso de uso

Suscríbase a token_id + contractaddress (opcionalmente filtrado por from) para actualizar las tablas de propiedad justo después de mints o transferencias.

Alertas de riesgo entre cadenas

Caso de uso

Combine type con webhooks específicos de cada cadena para enviar resultados de Bitcoin, Tron, Arbitrum o Polygon a su stack de cumplimiento.

FAQ

Preguntas y respuestas frecuentes

Descubra todos los detalles esenciales sobre nuestra plataforma y cómo puede cubrir sus necesidades.

Chaingateway Webhooks es un servicio que le permite recibir notificaciones en tiempo real de eventos de blockchain, como transacciones entrantes y salientes, mediante solicitudes POST enviadas al endpoint que usted indique cada vez que ocurre un evento relevante.

Una Instant Payment Notification (IPN) es un mensaje que Chaingateway envía al endpoint que usted indique cada vez que ocurre un evento de blockchain relevante, como una transacción entrante o saliente. Esto le permite recibir actualizaciones en tiempo real y actuar de inmediato según los datos del evento.

Para configurar un webhook, necesita crear un endpoint seguro en su servidor capaz de recibir solicitudes POST. Después, puede usar el dashboard o la API de Chaingateway para crear un webhook e indicar la URL de su endpoint junto con los filtros que desee para los eventos sobre los que quiere recibir notificaciones.

Debe indicar url (endpoint público) y al menos uno de from o to. Los parámetros de filtro opcionales adicionales son contractaddress, token_id y type (ETH/ERC20/ERC721 para Ethereum, y de forma equivalente para otras cadenas).

Cada solicitud POST incluye id, webhook_id, from, to, blocknumber, datetime, tokenid, type, contractaddress, txid, amount, y otros campos contables para que tenga todo lo necesario para conciliar pagos.

Cada entrega se firma con X-Signature (HMAC SHA-256 sobre txid + su secret, en Base64). Una notificación que su servidor no acepta no se reenvía automáticamente: la API lista las notificaciones fallidas (GET /webhooks/notifications/failed) y usted lanza una nueva entrega de cada una con POST /webhooks/notifications/{id}/retry.

No. El servicio de webhooks llama a su endpoint público a través de internet abierto — solo asegúrese de que su firewall permita el tráfico entrante sin necesidad de lista blanca de IP.

Use el dashboard de Chaingateway para enviar eventos de prueba a su endpoint, y así verificar que su handler procesa el payload correctamente antes de pasar a producción.

Use la cabecera X-Signature para verificar que las solicitudes entrantes proceden realmente de Chaingateway. Esta firma se genera con HMAC SHA-256 y su clave secreta, garantizando que su endpoint solo procese eventos autorizados.

Nuestro equipo de soporte está aquí para ayudarle con cualquier pregunta o problema. Contáctenos a través de la página de soporte de nuestro sitio web y estaremos encantados de ayudarle.

¿Aún tiene preguntas?

Estamos aquí para aclarar dudas y ayudarle con cualquier consulta.

Mejore su pipeline de datos

¿Listo para notificaciones de eventos en tiempo real?

Deje de hacer polling y empiece a recibir actualizaciones instantáneas con Chaingateway Webhooks. Reciba avisos de eventos de blockchain en tiempo real, para reaccionar más rápido y crear aplicaciones más receptivas.