Logistics & Auto Blueprint

Fleet Management

Deploy customized fleet card programs for commercial transportation, delivery fleets, and field service contractors. Enforce automated fuel dispenser MCC locks, mandate driver ID and odometer prompts at the pump, apply GPS geofence checks, and ingest Level 3 fuel telematics.

System Architecture & Flow

FLEET FUEL AUTHORIZATION & TELEMATICS PIPELINEFuel Pump Lock

Driver Prompts

Driver inserts card at fuel dispenser and inputs Driver ID + current Odometer reading.

MCC & Odometer

Rook validates MCC 5542/5541 and checks odometer sanity against vehicle history.

GPS Validation

Webhook correlates pump location with live vehicle GPS telematics feed.

Level 3 Fuel Data

Clearing feed captures exact fuel grade, gallons pumped, and price per gallon.

1Issue Fleet Card with Prompting Controls

Issue a physical or virtual fleet card bound to a specific vehicle VIN, enabling mandatory Driver ID and Odometer entry at the point of sale.

POST /v1/fleet/cardsIssue Fleet Card

curl -X POST "https://api.sandbox.rookpayments.com/v1/fleet/cards" \
  -H "Authorization: Bearer rk_test_..." \
  -H "X-Program-ID: 7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_semi_902",
    "assigned_vin": "1FDXE4FN8KD123456",
    "prompting_requirements": [
      "driver_id",
      "odometer"
    ],
    "restrictions": {
      "allowed_mccs": ["5541", "5542", "7538"],
      "max_gallons_per_fill": 150,
      "fuel_types_allowed": ["diesel", "def"]
    }
  }'

2Validate Pump Authorization & Driver Telematics

The authorization webhook includes prompt inputs (driver ID, odometer) and pump location data. Confirm the driver is on active duty before returning an authorization response.

EVENT fleet.authorization.requestWebhook

{
  "event_id": "evt_fleet_9921",
  "type": "fleet.authorization.request",
  "data": {
    "card_id": "crd_fleet_441",
    "driver_id_entered": "DRV-882",
    "odometer_entered": 142850,
    "last_known_odometer": 142410,
    "merchant": {
      "name": "LOVE S TRAVEL STOP",
      "mcc": "5542",
      "lat": 35.4676,
      "lon": -97.5164
    },
    "pre_auth_amount": 35000
  }
}

3Reconcile Level 3 Fuel Clearing Statements

When the pump transaction clears, access granular fleet details including fuel product codes, net unit pricing, and local fuel taxes.

EVENT fleet.transaction.settledPayload

{
  "transaction_id": "txn_flt_77819",
  "cleared_amount": 28410,
  "currency": "USD",
  "fuel_details": {
    "product_code": "DIESEL_ULTRA_LOW",
    "gallons": 75.25,
    "price_per_gallon": 3.775,
    "state_fuel_tax": 2182
  }
}

Explore All Use Cases