Chaingateway V2.1 beta: testnets y webhooks
Chaingateway V2.1 beta, publicada el 16 de septiembre de 2024: testnets, sistema de webhooks rehecho, nuevo panel y pasos para migrar desde V2.
Revisado por Maurice Sobiera
Chaingateway V2.1 es la reescritura de 2024 de la API y del panel de Chaingateway. Añadió soporte de testnets mediante la cabecera X-Network, un sistema de webhooks rehecho y una interfaz de usuario rediseñada. La URL base de la API pasó de api.chaingateway.io/v2 a app.chaingateway.io/api/v2. Esta nota enumera los cambios y los pasos de migración del anuncio beta del 16 de septiembre de 2024.
Actualización, 5 de noviembre de 2026: V2.1 es la API vigente. Desde esta versión se han añadido Solana y Arbitrum (Solana no tiene webhooks), Tron Paymaster, descrito más abajo, está obsoleto, y los pagos cripto de los planes cambiaron en abril de 2025 (véase Nuevo flujo de pagos). La lista de endpoints está en el archivo OpenAPI.
¿Cómo accedo a V2.1?
V2.1 está disponible para todos los clientes y usuarios de prueba en app.chaingateway.io. Se diseñó para ser compatible con V2, así que la mayoría de las integraciones solo necesitan una URL base nueva. Los pasos de migración están al final de esta nota.
Si su prueba ha caducado, cree una cuenta o contacte con nosotros para ampliarla. La beta también tenía una comunidad de Telegram.
¿Qué hay de nuevo en V2.1?
La versión incluía estos cambios:
- Soporte de testnets en todas las cadenas.
- Tron Paymaster, un servicio de comisiones para transferencias TRC-20. Ahora está obsoleto.
- Documentación de la API con ejemplos de peticiones y respuestas.
- Un portal para desarrolladores rehecho.
- Un panel rediseñado.
- Cambios de plan inmediatos para pagos con tarjeta.
- Un sistema de webhooks rehecho y un nuevo manejo de comisiones.
¿Qué testnets están soportadas?
Añada la cabecera X-Network: testnet a una petición para usar la red de pruebas de una cadena. Para la mainnet, envíe X-Network: mainnet o omita la cabecera. Todo lo que puede hacer en la mainnet funciona también en la testnet. También puede cambiar de red en la cabecera del panel.
| Cadena | Testnet en V2.1 | Referencia |
|---|---|---|
| Ethereum | Sepolia | ethereum.org: redes |
| Tron | Nile | portal para desarrolladores de TRON: redes |
| BNB Smart Chain | BSC testnet | documentación de BNB Chain |
| Polygon | Amoy | documentación de Polygon |
| Bitcoin | Testnet3 | ejemplos para desarrolladores de Bitcoin: pruebas |
La lista actual, que también incluye Arbitrum Sepolia y la devnet de Solana, está en la documentación de redes soportadas.

¿Qué fue Tron Paymaster?
Paymaster era un servicio que pagaba las comisiones de Energy y Bandwidth de las transferencias TRC-20, para que una wallet no necesitara tener TRX. Se facturaba aparte de la suscripción, y no costaba nada en la testnet. Paymaster está obsoleto. Use TronFuel en su lugar. El tutorial antiguo de Paymaster se mantiene como referencia.
¿Qué cambió en la documentación y en el panel?
La documentación de la API ganó más ejemplos de peticiones y respuestas, y el portal para desarrolladores recibió una nueva guía de inicio y tutoriales de las funciones principales. El panel se rediseñó, y el monitor de webhooks le permite inspeccionar las cargas útiles enviadas y filtrar por valor.

¿Qué cambió en la facturación?
Los clientes que pagan con tarjeta a través de Stripe pueden pasar a un plan superior de inmediato, en lugar de esperar al siguiente ciclo de facturación. Si alcanza los límites de su API, pulse «Change Plan» en la página de facturación, y los límites suben de inmediato. La factura muestra solo la diferencia de precio entre el plan antiguo y el nuevo. El anuncio indicaba que lo mismo llegaría a los pagos cripto, que se lanzaron con el flujo de pagos de abril de 2025.
¿Qué cambió técnicamente?
La API funciona sobre una nueva pila tecnológica. El anuncio advertía de que algunas respuestas podían diferir ligeramente de V2 y pedía a los usuarios que comunicaran las diferencias a soporte.
El manejo de comisiones se rehizo. Si sus peticiones fijan gasPrice, maxFeePerGas o maxPriorityFeePerGas, ya no necesita enviarlos en V2.1. Los campos de gas siguen siendo opcionales en la definición OpenAPI vigente.
El sistema de webhooks se rehizo tras las caídas del servicio de webhooks en las semanas previas a la versión, durante las cuales no se procesaron algunos bloques. El monitor de webhooks del panel muestra las cargas útiles que se enviaron. Los webhooks no se reintentan automáticamente. Las notificaciones fallidas se listan por cadena, por ejemplo en GET /api/v2/tron/webhooks/notifications/failed, y usted las reenvía con el endpoint de reintento.
¿Qué se planeó después de V2.1?
El anuncio nombraba tres continuaciones: soporte de Solana, Paymaster para más cadenas y correcciones en las respuestas de la API. El soporte de Solana ya está disponible. Paymaster se dio por obsoleto en lugar de ampliarse.
¿Cómo migro de V2 a V2.1?
- Cambie la URL base de
api.chaingateway.io/v2aapp.chaingateway.io/api/v2. - Opcional, pero recomendado: añada el prefijo
Bearera su clave de API, de modo que la cabecera quede comoAuthorization: Bearer <token>. - Pruebe su integración con la nueva URL.
- Hasta que la migración esté completa, gestione su suscripción en el panel antiguo.
Los datos de usuario, las direcciones y las claves de API se copiaron de V2 a V2.1 cada minuto durante la transición. Las direcciones creadas en V2.1 no se pueden usar en V2. Los webhooks se copiaron cada 10 minutos y no dispararon notificaciones durante la copia. Si necesita ayuda para migrar los webhooks, contacte con soporte.
Cómo escribimos estos artículos
¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API Blockchain para la referencia completa de los endpoints.