Recupera el estado de los dispositivos pinpad. Puede consultar todos los dispositivos del comercio o filtrar por un dispositivo específico.
La API permite obtener el estado actual de los Lectores Clip PinPad asociados a un comercio. Esta información es útil para monitorear la disponibilidad de los Lectores Clip y detectar problemas de conectividad.
Autenticación
El endpoint requiere el siguiente header obligatorio:
{
"Authorization": "Basic [token]"
}Objeto Completo
La respuesta es un arreglo JSON con la siguiente estructura para cada dispositivo:
|
Elemento |
Descripción |
Tipo |
|||||||
|
merchant_id |
Identificador único del comercio, en formato: UUID |
String |
|||||||
|
serial_number |
Número de serie único asignado al dispositivo. |
String |
|||||||
|
status |
Estado actual del dispositivo (active, inactive, unknown). |
String |
|||||||
|
expired_at |
Fecha y hora en que expira el registro del dispositivo. |
String |
|||||||
|
created_at |
Fecha y hora en que se creón el registro del dispositivo. |
String |
|||||||
|
updated_at |
Fecha y hora de la última actualización del registro. |
String |
|||||||
|
version |
Versión interna del registro (para control y seguimiento). |
Number |
|||||||
Consideraciones Clave
- Los Lectores Clip pueden tener los siguientes estados:
- active: el Lector Clip está operativo y puede procesar transacciones.
- inactive: el Lector Clip está desconectado o no disponible.
- expired: el Lector Clip no ha reportado un estado active en los últimos 20 segundos.
- unknown: el merchant tiene el feature desactivado.
- Los Lectores Clip deben reportar su estado regularmente. Si un Lector Clip activo no actualiza su estado en 20 segundos, automáticamente se marca como
"expired". - Un arreglo vacío [] es una respuesta válida e indica que no hay Lectores Clip registrados o que ningún Lector Clip cumple con los criterios de búsqueda, ejemplo
Response (200 OK):
[]- Todas las fechas están en formato ISO 8601 con zona horaria UTC.
¿Necesitas Ayuda?Si lo que buscas no está documentado, contáctanos por el siguiente medio:
- Envía un correo electrónico a la dirección [email protected].