Flujo de una estancia

Esta guía muestra el flujo completo para procesar una estancia utilizando la DriveSpot Machine API.

En Sandbox es posible simular la entrada y salida de un vehículo sin necesidad de una cámara física. En producción, estos eventos son generados automáticamente por los dispositivos configurados en el estacionamiento.

1. Simular la entrada

Comienza simulando la lectura de una placa mediante el endpoint ANPR Event.

Si la entrada es aprobada, DriveSpot crea una nueva sesión de estacionamiento.

Si el vehículo ya se encuentra dentro del estacionamiento, la solicitud será rechazada.

➡️ Endpoint: POST /api/parking-flow/anpr-event

2. Consultar la tarifa

Con una sesión abierta, consulta la tarifa de la estancia utilizando la placa del vehículo.

La respuesta devolverá un quote_id, el cual identifica la cotización que deberá utilizarse para registrar el pago.

➡️ Endpoint: POST /api/tickets/tariff-quote

3. Procesar el pago

El partner procesa el pago utilizando su propio procesador o pasarela.

Una vez autorizado el pago, deberá registrarlo en DriveSpot.

Al registrar el pago considera lo siguiente:

authorization debe ser único por sesión.
reference_id debe ser único por sesión.
provider debe contener el nombre del partner o procesador.
raw_response es opcional y puede enviarse como null.

Si la cotización ya fue utilizada o expiró, el pago será rechazado.

➡️ Endpoint: POST /api/payments/notification

4. Simular la salida

Una vez registrado correctamente el pago, vuelve a enviar la placa mediante ANPR Event.

Si la estancia ya se encuentra cubierta, DriveSpot autorizará la salida del vehículo.

➡️ Endpoint: POST /api/parking-flow/anpr-event

Resumen del flujo

ANPR Event (Entrada)
        │
        ▼
Consultar tarifa
        │
        ▼
Procesar pago
        │
        ▼
Notificar pago
        │
        ▼
ANPR Event (Salida)

Nota: El endpoint ANPR Event está disponible únicamente en Sandbox para facilitar las pruebas de integración. En un ambiente productivo, los eventos de entrada y salida son enviados automáticamente por las cámaras o dispositivos instalados en el estacionamiento.