En resumen
Cada depósito, retiro, intercambio o barrido que fluye a través de Blockradar crea un registro de transacción. La API de Transacciones es tu registro de actividad — úsala para consultar historial, investigar pagos específicos, reenviar webhooks perdidos, cancelar transacciones pendientes o reintentar las fallidas.
Cada depósito, retiro, intercambio o barrido que fluye a través de Blockradar crea un registro de transacción. La API de Transacciones es tu registro de actividad — úsala para consultar historial, investigar pagos específicos, reenviar webhooks perdidos, cancelar transacciones pendientes o reintentar las fallidas.
Requisitos Previos
Clave API
Obtén tu clave API desde el Dashboard de Blockradar. Ve a Desarrolladores para generar una.
Cómo Funciona
Cuando ocurre cualquier evento on-chain en una billetera Blockradar — un depósito entrante, un retiro enviado, un barrido activado — Blockradar crea un registro de transacción y dispara un webhook. La API de Transacciones te da acceso programático a todos estos registros.Consultar Historial
Recupera todas las transacciones de una billetera o filtra por dirección, activo, estado o rango de fechas.
Investigar Pagos
Busca una transacción específica por ID para verificar su estado, hash y metadatos.
Reenviar Webhooks
Reenvía un webhook para una transacción que tu sistema pudo haber perdido o fallado en procesar.
Cancelar o Reintentar
Cancela una transacción pendiente atascada o reintenta una fallida sin reenviar desde cero.
Estados de Transacción
| Estado | Descripción |
|---|---|
PENDING | Transacción enviada a la blockchain, esperando confirmación |
SUCCESS | Transacción confirmada y liquidada |
FAILED | Transacción fallida on-chain o rechazada |
CANCELLED | Transacción cancelada antes de ser transmitida |
Consultar Transacciones
Reenviar un Webhook Perdido
Cancelar una Transacción Pendiente
Reintentar una Transacción Fallida
Mejores Prácticas
- Usa webhooks como señal principal — no consultes la API de Transacciones para actualizaciones en tiempo real. Úsala para reconciliación e investigaciones.
- Almacena los IDs de transacción — guarda el ID de transacción de Blockradar junto a tus registros internos.
- Reenvía webhooks después de tiempo de inactividad — si tu endpoint de webhook no estaba disponible, usa el endpoint de reenvío para recuperar eventos perdidos.
Referencia de API
| Endpoint | Descripción |
|---|---|
| Obtener Transacciones | Consultar todas las transacciones de una billetera |
| Obtener Transacción | Consultar una transacción por ID |
| Reenviar Webhook | Reenviar un webhook |
| Cancelar Transacción | Cancelar una transacción pendiente |
| Reintentar Transacción | Reintentar una transacción fallida |

