Dos endpoints livianos para revisar en tiempo real el estado de la configuración de tu comercio y de la plataforma Kushki.
Estado del gateway
Devuelve qué métodos de pago (tarjeta, transferencia, efectivo) están habilitados actualmente en la cuenta de tu comercio.
Estado de la plataforma
Devuelve el estado operativo en tiempo real de todos los componentes de Kushki, con métricas de uptime.
Estado del gateway#
GET /rules/v1/gatewayStatusUsa este endpoint para verificar qué métodos de pago están activos para un comercio específico antes de renderizar tu checkout. La respuesta devuelve un booleano por método.Autenticación#
Requiere tu Public Merchant ID como cabecera:Respuesta#
{
"card": true,
"transfer": true,
"cash": false
}
| Campo | Tipo | Descripción |
|---|
card | boolean | Indica si los pagos con tarjeta están habilitados para este comercio |
transfer | boolean | Indica si los pagos por transferencia bancaria están habilitados |
cash | boolean | Indica si los pagos en efectivo están habilitados |
Usa este endpoint al inicializar el checkout para mostrar solo los métodos de pago disponibles para tu comercio; no requiere parámetros de query.
Usa este endpoint para monitorear en tiempo real el estado operativo de Kushki. Devuelve un array en el que cada elemento representa un componente y su estado actual.Autenticación#
Este endpoint es público y no requiere autenticación. No necesitas enviar body ni parámetros de query.
Valores de estado#
| Estado | Descripción |
|---|
operational | Funciona con normalidad, sin incidencias conocidas |
degraded_performance | Rendimiento reducido, pero sigue operativo |
partial_outage | Parte de la funcionalidad no está disponible para un subconjunto de usuarios |
major_outage | El componente está totalmente caído o severamente afectado |
Estructura de la respuesta#
La respuesta contiene un único array| Campo | Descripción |
|---|
kushki[] | Componentes de la plataforma Kushki y su estado |
Cada objeto de componente incluye:| Campo | Tipo | Descripción |
|---|
name | string | Nombre visible del componente |
status | string | Estado actual (ver los valores de arriba) |
description | string | null | Descripción del incidente, si hay alguno |
uptime_percentage | number | % de uptime del periodo reportado (0–100) |
major_outage | number | Incidentes de caída total en el periodo reportado |
partial_outage | number | Incidentes de caída parcial en el periodo reportado |
range_start | date | Inicio del periodo reportado (YYYY-MM-DD) |
range_end | date | Fin del periodo reportado (YYYY-MM-DD) |
updated_at | datetime | Última actualización del registro de este componente (ISO 8601) |
only_show_if_degraded | boolean | true si este componente solo aparece cuando hay un incidente activo |
Uso de la API#
https://api.kushkipagos.com/
Endpoints disponibles#
Estado del gateway
Devuelve los métodos de pago activos de un comercio. Requiere Public Merchant ID.
Estado de la plataforma
Devuelve el estado en tiempo real de todos los componentes de Kushki. No requiere autenticación.
¿Tienes una sugerencia sobre esta documentación? Escríbenos.
