Webhooks
Pro y Business

Tus tasas, por webhook.

Recibe un POST firmado cuando cambia el BCV o el P2P, cuando una fuente se degrada o cuando tu cuota se acerca al limite. Sin polling ni crons fragiles.

Se configura en /developer/webhooks
tu-servidor
POST https://tu-app.com/webhooks/montosve
X-MontosVE-Event: rate.bcv.updated
X-MontosVE-Timestamp: 1758231012
X-MontosVE-Signature: sha256=a1b2c3...

{
  "event": "rate.bcv.updated",
  "occurred_at": "2026-09-18T17:30:12-04:00",
  "data": { "date": "2026-09-19", "usd": 100.50, "eur": 110.50 }
}
Entrega HMAC SHA-256 4 reintentos historial
Seis eventos, un solo POST.
Elige que te avisamos. Los eventos de tasas y fuentes son globales; los de cuota y llaves son solo para tu cuenta.
rate.bcv.updated

El BCV publica un valor nuevo.

data: date, usd, eur, updated_at

rate.p2p.updated

Una tasa P2P cambia por encima del umbral que definas.

data: market, trade_type, rate, best_rate, previous_rate, change_percent

source.status_changed

Una fuente pasa a degraded/down o se recupera.

data: source, previous_status, status, last_success_at

api.quota.warning

Tu consumo llega al 80% o 95% de la cuota mensual.

data: period, percentage, used, limit

api.quota.exceeded

Se supera la cuota mensual (una vez por periodo).

data: period, used, limit

api.key.expiring

Una API key esta por expirar.

data: keys: name, expires_at, days_remaining

Configurado en tres pasos.
Todo desde el panel de desarrollador, con historial de entregas y umbral por endpoint.
1
Crea tu endpoint

Registra una URL publica (https) que reciba el POST. Guarda el secreto que te generamos.

2
Elige eventos y umbral

Activa los eventos que te interesan y define el cambio minimo (%) para los avisos de P2P.

3
Valida la firma

Verifica X-MontosVE-Signature con HMAC SHA-256 y responde 2xx rapido. Nosotros reintentamos si fallas.

Verifica la firma
$timestamp = $request->header('X-MontosVE-Timestamp');
$body = $request->getContent();
$expected = 'sha256='.hash_hmac('sha256', $timestamp.'.'.$body, $secret);

abort_unless(
    hash_equals($expected, (string) $request->header('X-MontosVE-Signature')),
    401
);
Responde 2xx rapido; procesa en segundo plano.
Que puedes automatizar.
Los webhooks convierten la consulta manual en operaciones que se ejecutan solas.
Actualiza precios

Un POS o e-commerce reajusta su catalogo en bolivares apenas cambia la tasa, sin crons fragiles.

Failover automatico

Si una fuente se degrada o cae, tu sistema cambia de referencia y queda registrado.

Vigilancia de arbitraje

Reacciona cuando el P2P se mueve por encima de tu umbral o cuando el spread se abre.

Control de consumo

Recibe avisos al 80% y 95% de tu cuota y cuando se excede, para no cortar tu operacion.

Preguntas frecuentes sobre webhooks
Lo esencial antes de integrar.
Deja de hacer polling.

Crea tu API key, configura tu endpoint y recibe los cambios de tasa apenas pasan.