Cupones

Los cupones de descuento se enganchan en /fleet/show (vista previa del precio) y en /bookings (se aplican a la venta). La lógica de validación es compartida; los motivos de error son estables.

POST /coupons/validate

Pre-flight antes de mostrar un descuento en la UI. Idempotente — auditado en cada intento pero no consume un slot de uso.

bash

curl -X POST https://greenflow.live/api/v1/coupons/validate \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SUMMER25",
    "brand": 11,
    "rate": "011880",
    "country_id": 31,
    "days": 3
  }'

json

{
  "data": {
    "code": "SUMMER25",
    "discount_type": "percentage",
    "discount_value": 25.0,
    "currency": null,
    "discount_code": "S25BR",
    "stackable": false
  }
}

Flujo de tres pasos

Llamá a POST /coupons/validate desde la UI, después pasá coupon_code en POST /fleet/show para ver el precio con descuento, y de nuevo en POST /bookings para fijarlo. El último paso es el que consume un slot de uso.

Errores

HTTP	Body	Causa
404	{"error": "coupon_not_found"}	Code doesn't exist.
422	{"error": "coupon_not_valid"}	Expired, outside window, no uses left.
422	{"error": "coupon_brand_or_rate_mismatch"}	Brand or rate does not apply.
422	{"error": "coupon_country_mismatch"}	Country does not apply.
422	{"error": "coupon_days_out_of_range"}	Days outside min/max.