Dos endpoints de estado te ayudan a monitorear la salud de tu integración en México 🇲🇽:| Endpoint | Qué revisa | Auth |
|---|
| Gateway Status | Qué métodos de pago están activos para tu comercio | Public-Merchant-Id |
| Platform Status | Estado operativo de todos los componentes de la plataforma de Kushki | Ninguna (público) |
Estado del gateway#
GET /rules/v1/gatewayStatus devuelve un booleano por cada método de pago configurado en tu cuenta de comercio — útil para mostrar u ocultar dinámicamente las opciones de pago en tu checkout antes de que el cliente inicie una transacción.Solicitud#
Respuesta#
{
"card": true,
"transfer": true,
"cash": true
}
| Campo | Tipo | Descripción |
|---|
card | boolean | Los pagos con tarjeta (crédito/débito) están habilitados |
transfer | boolean | La transferencia bancaria (SPEI) está habilitada |
cash | boolean | Los pagos en efectivo están habilitados |
⚠️ Public Key: Gateway Status usa tu cabecera Public-Merchant-Id, no la private key. Es seguro llamarlo desde código del lado del cliente.
GET /data/status devuelve en tiempo real el estado operativo de todos los componentes de las plataformas Kushki y BillPocket. No requiere autenticación — este endpoint es de acceso público.Mostrar un banner de estado si Kushki tiene un incidente
Monitorear uptime e incidentes de forma programática
Revisar si hay indisponibilidad parcial o rendimiento degradado antes de enrutar transacciones
Solicitud#
No requiere cabeceras ni parámetros.Respuesta#
{
"kushki": [
{
"name": "Payment Processing",
"status": "operational",
"uptime_percentage": 100,
"major_outage": 0,
"partial_outage": 0,
"range_start": "2026-01-01",
"range_end": "2026-03-31"
}
],
"billpocket": [
{
"name": "Home",
"status": "operational",
"uptime_percentage": 100,
"major_outage": 0,
"partial_outage": 0,
"range_start": "2026-01-01",
"range_end": "2026-03-31"
}
]
}
Valores de estado del componente#
| Estado | Descripción |
|---|
operational | El componente funciona con normalidad |
degraded_performance | El componente está más lento o con una tasa de errores elevada |
partial_outage | El componente está parcialmente no disponible |
major_outage | El componente está caído |
under_maintenance | Mantenimiento programado en curso |
Campos de la respuesta#
| Campo | Descripción |
|---|
name | Nombre del componente |
description | Descripción del incidente, si hay alguno (null cuando está operativo) |
status | Estado operativo actual — revisa la tabla de arriba |
uptime_percentage | % de uptime del rango de fechas reportado |
major_outage | Cantidad de incidentes de indisponibilidad mayor en el rango |
partial_outage | Cantidad de incidentes de indisponibilidad parcial en el rango |
range_start / range_end | Rango de fechas de los contadores de uptime e incidentes |
Uso de la API#
https://api.kushkipagos.com/
Endpoints disponibles#
Estado del gateway
Devuelve qué métodos de pago (card, transfer, cash) están habilitados en tu cuenta de comercio. Usa tu public key.
Estado de la plataforma
Estado operativo en tiempo real de todos los componentes de la plataforma de Kushki. No requiere autenticación.
¿Tienes una sugerencia sobre esta documentación? Contáctanos.
Modified at 2026-09-11 14:42:39
