# BRIJ Travel

Agent-native flight merchant on Solana. Live airline inventory, paywalled
per-request with x402, settled in USDC on Solana.

Base URL: https://travel.brij.fi

## Paid endpoints (x402)

POST /air/search    $0.10 ×1..50
  Search live flight offers.
  JSON: origin, destination, departure_date (and optional return_date, passengers, cabin_class).

POST /air/intents    $0.10
  Create an escrow-backed booking intent from a selected offer.
  JSON: offer_id, funding_wallet, passenger (given_name, family_name, born_on, gender, email, phone_number).

POST /air/intents/{intent_id}/book    escrow amount (per-intent)
  Fund the escrow via x402 and execute the airline booking.
  No body. Pays the intent's ExpectedEscrowAmount. Response includes airline confirmation code on success.

POST /air/intents/{intent_id}/refund-requests    $0.10
  File a manual refund request for an intent.
  Headers: X-Customer-Support-Code (from intent creation), X-Passenger-Family-Name.

## Free endpoints

GET /air/intents/{intent_id}
  Fetch an intent's current state (treat intent_id as a capability token).
GET /air/orders/{order_id}
  Fetch an airline order's status by order_id.
GET /health
  Process liveness.
GET /ready
  Database readiness.

## Booking flow

  1. POST /air/search                              find live flight offers
  2. POST /air/intents                             lock an offer, derive escrow PDA
  3. POST /air/intents/{id}/book                   fund escrow + execute booking
  4. (optional) POST /air/intents/{id}/refund-requests   request manual refund

If the upstream price changed between steps 2 and 3, booking is rejected
automatically and the escrow is refunded to intent.RefundWallet.

## Payment flow (x402)

  1. Call the paid endpoint.
  2. Server replies 402 with `PAYMENT-REQUIRED: <base64 requirements>`.
  3. Sign the USDC transaction on Solana per the x402 spec.
  4. Retry the same request with `PAYMENT-SIGNATURE: <signature>`.
  5. Server replies 200 with `PAYMENT-RESPONSE: <settled>` and a JSON body.

Any x402-compatible client handles this loop automatically.

## Discovery

  GET /openapi.json               OpenAPI 3.1 schema
  GET /.well-known/x402           Resource manifest for x402scan / Bazaar
  GET /.well-known/ai-plugin.json Agent plugin manifest