Dos endpoints de estado te permiten monitorear en tiempo real tanto la configuración de tu comercio como la salud de la plataforma de Kushki.
Consultar el estado del gateway#
Devuelve qué métodos de pago están habilitados para tu comercio en este momento. Úsalo al cargar el checkout para mostrar dinámicamente solo las opciones que están activas.GET /rules/v1/gatewayStatus
Public-Merchant-Id: <your-public-key>
| Campo | Tipo | Descripción |
|---|
card | boolean | true si los pagos con tarjeta (crédito/débito) están habilitados |
transfer | boolean | true si la transferencia bancaria (PSE) está habilitada |
cash | boolean | true si los pagos en efectivo están habilitados |
{
"card": true,
"transfer": true,
"cash": false
}
Llama a este endpoint al cargar el checkout y muestra solo los métodos de pago que devuelvan true. Así evitas mostrar opciones que están deshabilitadas temporalmente o que no están configuradas en tu cuenta.
Devuelve el estado operativo de todos los componentes de las plataformas Kushki y BillPocket: procesadores, APIs e infraestructura. No requiere autenticación.La respuesta contiene dos arrays de primer nivel: kushki y billpocket. Cada entrada es un componente de la plataforma con su estado actual, el porcentaje de disponibilidad y los contadores de incidentes del rango de fechas reportado.| Campo | Tipo | Descripción |
|---|
name | string | Nombre del componente (por ejemplo, "Payment Processing") |
description | string | Descripción del incidente, si hay alguno |
status | string | Estado actual — consulta los valores más abajo |
uptime_percentage | number | % de disponibilidad del rango de fechas reportado |
major_outage | integer | Cantidad de caídas mayores en el periodo |
partial_outage | integer | Cantidad de caídas parciales en el periodo |
range_start / range_end | string | Rango de fechas que cubren las estadísticas de disponibilidad |
Valores posibles de status:| Valor | Significado |
|---|
operational | El componente funciona con normalidad |
degraded_performance | El componente funciona pero con errores o latencia elevados |
partial_outage | El componente está parcialmente no disponible |
major_outage | El componente está caído |
{
"kushki": [
{
"name": "Payment Processing",
"description": null,
"status": "operational",
"uptime_percentage": 100,
"major_outage": 0,
"partial_outage": 0,
"range_start": "2026-01-01",
"range_end": "2026-03-31"
}
],
"billpocket": [
{
"name": "Home",
"description": null,
"status": "operational",
"uptime_percentage": 100,
"major_outage": 0,
"partial_outage": 0,
"range_start": "2026-01-01",
"range_end": "2026-03-31"
}
]
}
Este endpoint es de acceso público: no necesita el header Merchant-Id. Úsalo para armar dashboards internos o disparar alertas cuando el status de un componente no sea "operational".
Autenticación#
| Endpoint | Autenticación |
|---|
| Get Gateway Status | Requiere el header Public-Merchant-Id |
| Get Platform Status | No requiere autenticación — es de acceso público |
Usar la API#
https://api.kushkipagos.com/
Endpoints disponibles#
Estado del gateway
Devuelve un booleano por método de pago — card, transfer y cash — que indica si cada uno está activo para tu comercio.
Estado de la plataforma
Devuelve el estado operativo, la disponibilidad y los contadores de incidentes de todos los componentes de las plataformas Kushki y BillPocket. No requiere autenticación.
¿Tienes una sugerencia sobre esta documentación? Contáctanos.
