> ## Documentation Index > Fetch the complete documentation index at: https://docs.cbpayapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Estado del servicio y disponibilidad de corredores > Conoce en tiempo real si cada corredor de pago está operativo: availability en los catálogos de métodos, el webhook corridor_status_changed y la página de status pública export const EnvUrls = ({lang = "en"}) => { const T = { en: { test: "Test", live: "Live", hint: "Same API on both environments — build against test first, then go live by swapping the base URL and the key.", guide: "Environments and testing", href: "/en/environment-testing" }, es: { test: "Test", live: "Live", hint: "La misma API en ambos ambientes — construye primero contra test y pasa a live cambiando la URL base y la key.", guide: "Entorno y pruebas", href: "/es/entorno-y-pruebas" }, zh: { test: "Test", live: "Live", hint: "两个环境的 API 完全一致——先在 test 环境构建，再通过切换基础 URL 和密钥上线。", guide: "环境与测试", href: "/zh/environment-testing" } }; const t = T[lang] || T.en; const row = (label, url, keyPattern, badgeCls) =>
{label} {url} · {keyPattern}
; return
{row(t.test, "https://cryptobank.qbank.cl/platform", "pk_test_...", "bg-amber-100 text-amber-800 dark:bg-amber-900/40 dark:text-amber-300")} {row(t.live, "https://api.qbank.cl/platform", "pk_...", "bg-emerald-100 text-emerald-800 dark:bg-emerald-900/40 dark:text-emerald-300")}

{t.hint} {t.guide} →

; }; Los rieles de pago pueden degradarse o caerse — una caída de la red bancaria, una ventana de mantenimiento del canal, un incidente aguas arriba. La plataforma monitorea la salud de cada corredor (país / moneda / método) **en tiempo real**, combinando el resultado del tráfico vivo con chequeos activos de salud, y te expone ese estado por tres superficies para que tu producto reaccione antes que tus usuarios: 1. **`availability` en los catálogos de métodos** — decide al renderizar si mostrar, advertir u ocultar un corredor. 2. **Webhook `corridor_status_changed`** — recibe el push en el momento en que un corredor cambia de estado, sin polling. 3. **Página de status pública** — una página hosteada y brandeada (HTML + JSON) que puedes linkear desde tu app o tu propio tooling de status. ```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}} flowchart LR monitor["Monitor de salud
(tráfico vivo + chequeos activos)"] --> state["Estado del corredor
operational / degraded / down"] state --> catalog["availability en
GET /v1/payouts/methods
GET /v1/payins/methods"] state --> hook["Webhook
corridor_status_changed"] state --> page["Página de status pública
HTML + JSON"] ``` El monitor es **observabilidad, no un gate**: un corredor `down` NO bloquea tus requests. Tú mantienes el control — puedes seguir enviando (los requests fallarán con los códigos de error de siempre y los refunds aplican como siempre) o pausar ese corredor en tu UI hasta que se recupere. ## Estados de un corredor | Estado | Significado | Qué hacer | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `operational` | El corredor procesa con normalidad. | Nada — operación normal. | | `degraded` | Se detectó una tasa elevada de errores de infraestructura en la ventana reciente. Algunas operaciones pueden fallar o demorar más. | Considera mostrar una advertencia en tu UI; reintentar con la misma `idempotency_key` es seguro. | | `down` | Fallas de infraestructura consecutivas o chequeos de salud fallando. Es muy probable que los despachos nuevos fallen. | Prefiere ocultar o deshabilitar el corredor en tu UI hasta que se recupere; lo que igual envíes resolverá a los estados finales de siempre (las operaciones fallidas se reembolsan como siempre). | Las transiciones tienen histéresis: un timeout aislado jamás declara una caída, y la recuperación exige una ventana estable sostenida — el estado que lees es significativo, no ruido. ## 1. Availability en los catálogos de métodos `GET /v1/payouts/methods` y `GET /v1/payins/methods` ahora incluyen el campo ADITIVO `availability` por corredor. El resto del shape no cambia. ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl "https://api.qbank.cl/platform/v1/payouts/methods" \ -H "Authorization: Bearer pk_..." ``` ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "items": [ { "country": "VE", "currency": "VES", "method": "bank_transfer", "availability": "down" }, { "country": "MX", "currency": "MXN", "method": "bank_transfer", "availability": "operational" } ] } ``` Un corredor sin incidentes registrados es siempre `operational` — el monitor solo persiste lo que ha observado. ## 2. El webhook `corridor_status_changed` Suscribe tu endpoint al evento `corridor_status_changed` ([guía de webhooks](/es/webhooks)) y recibirás cada transición en el momento en que ocurre — caída **y** recuperación: ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "event_type": "corridor_status_changed", "data": { "flow": "payout", "country": "VE", "currency": "VES", "method": "bank_transfer", "status": "down", "previous_status": "operational", "since": "2026-07-24T22:10:00Z", "reason": "consecutive infrastructure failures" } } ``` | Campo | Descripción | | --------------------------------- | -------------------------------------------------------------------- | | `flow` | `payout` o `payin` — la dirección del corredor afectado. | | `country` / `currency` / `method` | La clave del corredor, igual que en los catálogos de métodos. | | `status` | Estado nuevo: `operational`, `degraded` o `down`. | | `previous_status` | Estado previo a la transición. | | `since` | Cuándo comenzó el estado nuevo (RFC 3339, UTC). | | `reason` | Causa corta legible (jamás incluye identidades de canales internos). | El evento es un **broadcast**: no está ligado a una operación tuya, así que no lleva `account_id`. El consumo idempotente aplica como en todo webhook (dedupe por id de entrega). ## 3. Página de status pública Tu organización tiene una página de status hosteada con el estado vivo de cada corredor, el uptime de los últimos 90 días y el historial de incidentes. Es pública (sin auth), brandeada con la identidad de tu organización y apta para compartir con tus propios clientes. * **HTML**: `GET /status/{orgToken}` — página self-contained que puedes linkear o embeber. * **JSON**: `GET /v1/status/{orgToken}` — la misma data para tu propio tooling de status o monitores. La página muestra el logo, los colores y el sitio web de tu organización, y para cada corredor la bandera del país, un ícono del método de pago, una barra de disponibilidad día a día de los últimos 90 días y el estado actual. Arriba hay una tarjeta de resumen (estado general, corredores operativos, degradados, con interrupción y uptime promedio) y abajo la línea de tiempo de incidentes con los motivos redactados en lenguaje claro. El HTML no carga JavaScript ni recursos externos, así que se puede embeber en un iframe sin riesgos. El `orgToken` es un token opaco que tu operador te comparte (los org admins pueden leerlo como `status_page_url` en `GET /v1/org/branding`). ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl "https://api.qbank.cl/platform/v1/status/{orgToken}" ``` ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "status": "degraded", "generated_at": "2026-07-24T22:15:00Z", "corridors": [ { "flow": "payout", "country": "VE", "currency": "VES", "method": "bank_transfer", "status": "down", "since": "2026-07-24T22:10:00Z", "uptime_90d_pct": 99.62 } ], "incidents": [ { "flow": "payout", "country": "VE", "currency": "VES", "method": "bank_transfer", "from_status": "operational", "to_status": "down", "reason": "consecutive infrastructure failures", "at": "2026-07-24T22:10:00Z" } ] } ``` | Campo | Descripción | | ------------- | ----------------------------------------------------------------------------------------------------- | | `status` | Estado global de la página: el peor estado entre todos los corredores. | | `corridors[]` | Estado actual por corredor más `uptime_90d_pct` (porcentaje de los últimos 90 días en `operational`). | | `incidents[]` | Transiciones más recientes (caídas y recuperaciones), la más nueva primero. | Un token desconocido o mal formado responde `404` — el token no revela si una organización existe. El endpoint tiene rate limit por IP. ## FAQ No. El monitor jamás bloquea despachos. Un corredor `down` significa que las operaciones nuevas muy probablemente fallarán con los códigos de error de siempre (`channel_unavailable`, rechazo del canal, estados por timeout) — las operaciones fallidas se reembolsan exactamente como siempre. Usa `availability` para decidir qué mostrar en tu UI. El monitor evalúa continuamente, combinando cada despacho real con chequeos activos de salud periódicos, así que las caídas se detectan típicamente en pocos minutos incluso en corredores con poco tráfico. La histéresis evita que un timeout aislado haga parpadear el estado. No — suscríbete a `corridor_status_changed` y recibirás cada transición por push. Los catálogos son un snapshot conveniente para el momento de renderizar; el webhook es el feed de cambios. Se resuelven solas: cada operación llega a su estado final (`completed` o `failed` con refund) por la maquinaria de webhooks y conciliación de siempre. Nunca necesitas re-enviar — reintentar con la misma `idempotency_key` es siempre seguro. Sí. La página usa el branding de tu organización (logo, colores, nombre) automáticamente — la misma configuración que usan los comprobantes y las páginas hosteadas. Pide a tu operador la URL de la página de status de tu organización, o léela desde GET /v1/org/branding si eres org admin. Por diseño la plataforma es agnóstica al proveedor: los corredores se identifican solo por país, moneda y método. Las causas de los incidentes están normalizadas y jamás incluyen identidades de canales internos.