Monedas
El módulo de monedas centraliza saldos, recargas y deducciones asociadas a conductores y compañías. Mantener esta información clara ayuda a transparentar la compensación y a auditar gastos operativos.
Qué puedes hacer
- Consultar saldos por conductor o empresa.
- Registrar ajustes o recargas con trazabilidad completa.
- Exportar movimientos para conciliaciones financieras.
Razones de ajuste de monedas
Cada movimiento de monedas lleva una reason que describe por qué se otorgó o descontó el saldo. La plataforma acepta tanto el valor canónico (kebab-case en inglés) como sus alias en español; se recomienda siempre usar el canónico para integraciones.
| Canónico | Alias en español | Descripción | Efecto en el balance |
|---|---|---|---|
trip | — | Monedas otorgadas por completar un viaje con buenos hábitos de conducción. | Incrementa |
daily-bonus | Bono diario | Bonificación diaria por mantener actividad y buenos hábitos a lo largo del día. | Incrementa |
welcome-bonus | Bono de bienvenida | Bonificación otorgada al conductor al unirse a la plataforma. | Incrementa |
bonus | Bono | Bonificación genérica otorgada manualmente por la empresa. | Incrementa |
referral | — | Monedas otorgadas por referir a un nuevo conductor a la plataforma. | Incrementa |
challenges | Desafíos | Monedas otorgadas al completar retos personalizados según las áreas de oportunidad del conductor. | Incrementa |
weekly-challenge | — | Monedas otorgadas al completar un reto con duración semanal. | Incrementa |
monthly-challenge | — | Monedas otorgadas al completar un reto con duración mensual. | Incrementa |
tech-issue | Problemas técnicos | Ajuste realizado para compensar al conductor por un problema técnico de la plataforma o del dispositivo. | Incrementa |
company-movement | Movimiento de empresa | Ajuste manual realizado por la empresa (por ejemplo, corrección contable o incentivo especial). | Incrementa o reduce |
prizes | Premios | Canje de monedas por premios del marketplace. | Reduce |
nota
- Los alias en español existen por compatibilidad con la interfaz web y con integraciones antiguas. Los nuevos integradores deberían utilizar siempre el valor canónico (columna "Canónico").
- Los endpoints que aceptan el parámetro
type(por ejemplo, al filtrar movimientos) esperan el valor canónico.
Autenticación
Todas las consultas y modificaciones requieren el encabezado Authorization: apikey {API_KEY}. Solicita la clave a un agente de soporte de Airbag Tech y almacénala en tu gestor de secretos antes de usarla en integraciones.
Buenas prácticas
- Alinea los registros de monedas con los cierres contables internos.
- Documenta la razón de cada ajuste para facilitar auditorías.
- Limita el acceso a este módulo a administradores con funciones financieras.