Platform · Registry API

The registry handshake behind every PayFine scan.

A single authenticated RPC returns the driver, vehicle, and live policy state for a windshield code — typically in under 400 ms. This page documents the contract partner systems implement.

PayFine warden
Sunmi V3 · field scan
SurePass registry
Live registry
request
312 ms
Response payload
{
  "code":    "BB-7HK-2RJ",
  "status":  "valid",
  "driver":  "Andrea M. Phillips",
  "vehicle": "2022 Toyota Yaris",
  "plate":   "B-44291",
  "policy":  "Comprehensive Insurance",
  "expires": "2026-08-14"
}
Response states

Five outcomes. Every scan, accounted for.

valid

Active policy, within grace window. Authenticated callers receive full owner details.

expired_grace

Expired within the last 7 days. Renewal still possible — warden discretion.

expired

Policy has lapsed beyond grace. Owner contact returned for follow-up.

revoked

Code revoked by issuer or insurer flagged as suspended. Treat as uninsured.

not_found

No matching record. Returned with empty owner/vehicle payload.

unauthenticated

Public callers receive vehicle + status only. Owner PII gated behind warden sign-in.

RPC contract

One RPC. Two authentication tiers.

Public · unauthenticated
verify_windshield_code_public(_code)
Returns
  • ·result
  • ·insurer_name
  • ·jurisdiction
  • ·license_plate
  • ·make / model / year / color
  • ·end_date
  • ·days_until_expiry
Warden · authenticated
verify_windshield_code(_code)
Returns
  • ·everything above
  • ·policy_number, coverage_type, start_date
  • ·owner_name, owner_nrn
  • ·owner_phone, owner_email, owner_address
  • ·owner_license
  • ·scan_count_last_hour (abuse signal)

Both RPCs are SECURITY DEFINER on the Postgres registry. Owner PII is only released to authenticated callers carrying a valid bearer token for a warden, insurer staff, or platform admin account.

Operational SLA

Built for roadside conditions.

The registry runs in-region with replicated reads, and the PayFine warden client holds an offline cache for the last 24 hours of issued codes.

See it live in PayFine Verify a sample code
< 400 ms
p95 verify latency
99.95%
Registry availability
24 h
Offline warden cache
In-region
Data residency