Inspiration

An ocean expedition has to raise money months before it leaves the dock. With classic crowdfunding, supporters pay up front and carry the risk if the voyage is delayed or a stop is dropped. Association Berry-Mappemonde, a French non-profit with a crew of six, is preparing a sailing expedition that links the landlocked Berry region to France's overseas territories along NAVIGUIDE's 38,747-nautical-mile route. Our virtual voyage departs on 12 Nov 2026, the submission deadline. We wanted one promise every supporter can trust: you pay only if we sail.

What it does

BI Escales turns the expedition into a map of stops anyone can back. PayPal makes the promise enforceable, an AI Captain explains it and prepares every money decision, and a human treasurer signs.

Back a stop, not a hope. Open a stop on the voyage map (for example La Rochelle), choose a berth, a night, a meal, care, miles or a cabin, and pay with the PayPal button or by card. Nothing is charged today. Charged only when it happens. Stop pledges are captured when the boat arrives and voided if the stop is cancelled. Cabins are captured at leg departure. Common-fund and project donations are captured immediately. Pledge months ahead. Authorizations open only close to the stop; for stops further away, PayPal Vault saves the payment method once and the pledge is charged on arrival, with no new checkout. Pay by card with 3-D Secure. PayPal Card Fields take the card in the page and run a 3-D Secure challenge, under the same authorize-then-capture rule. Prices the AI cannot change. The server enforces berth 30 €, night 60 €, meal 60 €, care 40 €, cabin 80 € and 1 € per sponsored mile. Only the common fund and project donations are free amounts. Prices are simulated for the demo. The AI prepares, a human decides. Before a stop is collected, the AI Captain writes a review (collect, wait or release) from NAVIGUIDE and PayPal data. Capture needs a human approval. Try the treasurer side as a judge. The Demo treasurer view lets you simulate the arrival of your own pledge, approve it, then capture, void or refund it for real in the PayPal sandbox, with no private key. Run the money in AG Studio. The treasurer follows every pledge and payment in an AG Studio dashboard built with AG Grid. Become Crew. Crew membership is the association's membership itself: 10 € per year, paid with PayPal Subscriptions (sandbox). Fund the crew's gear. A Channel3 gear wishlist lists safety equipment for a crew of six with real product offers; supporters pledge toward items, and the purchase link appears only once an item is fully funded. Plan every port. A Bryntum stopover calendar shows each stop and its dates. Every payment event is signed and recorded. Verified PayPal webhooks update the ledger and public totals. English and French. A first visit opens in English; the language control switches to French and is remembered.

How we built it

Capability Role on the published demo

Orders v2 AUTHORIZE / capture / void Stop and cabin pledges; immediate capture for the common fund and project donations

JS SDK (v6 checkout flag on) and Card Fields with 3-D Secure PayPal button and in-page card payment on the stop sheet

PayPal Server SDK (paypal-server-sdk 2.4.0, generated by APIMatic) The app's server-side PayPal client for orders, authorizations, captures and reads

APIMatic Context Plugin PayPal API context for our AI coding assistants during development

AG Studio (AG Grid) Treasurer dashboard: the ledger of pledges and payments

Payments v2 capture / void / reauthorize / refund Capture on arrival or leg departure; void if a stop is cancelled; refund after capture

Vault v3 Stops beyond the authorization window

Subscriptions Crew membership, 10 € per year

Signed webhooks Ledger and public totals

PayPal Agent Toolkit (read-only) The Captain reads orders, authorizations, disputes, transactions and invoices; it never moves money

Channel3 catalogue + wishlists 50-item public catalogue; one published wishlist

AI: NVIDIA Nemotron via NIM, with documented fallbacks, the answering model shown on screen, and per-IP rate limits. Voyage questions such as Where is the boat? are answered from code on purpose so dates are never invented.

Stack: Python / FastAPI; MongoDB with separate prod and test databases; React, TypeScript, Vite, Leaflet; Render hosting (prod at escales.naviguide.fr plus a test service); Postman collection for the payment journey. CI on PR #296 (12 Nov 2026): 1,437 backend tests passed (2 skipped) and 1,181 frontend tests passed.

Challenges we ran into

A PayPal authorization lasts a few weeks while an expedition is planned months ahead: we open authorizations only close to the stop and use Vault beyond that window, all on one voyage clock. Trusting an AI near donors' money: the Captain reads PayPal through read-only tools and advises; a person approves every capture. Server-side prices so neither the model nor the browser can change a catalogue amount. Adding card payments with 3-D Secure without breaking the authorize-then-capture rule.

Accomplishments that we're proud of

The full promise runs on the public sandbox demo: authorize today by card or PayPal, simulate the arrival, human approval, capture, or void if the stop is cancelled. Judges can run the treasurer side themselves on their own pledge, with no private key. Crew membership at 10 € per year runs as a PayPal Subscription. An AI Captain on NVIDIA Nemotron that answers in English and French, shows which model answered, and cannot move money. CI on the released commit: 1,437 backend and 1,181 frontend tests passing.

What we learned

PayPal's authorization window shapes the product: pay only if we sail needs both Orders v2 authorizations and Vault. Showing the model behind each AI answer builds more trust than hiding fallbacks. Server-side prices plus a human treasurer make AI-assisted payments acceptable for a small association.

What's next

Complete end-to-end testing of Apple Pay and Google Pay (buttons already shown in the sandbox). Project onboarding after a donation, marina payouts and platform splits once PayPal grants permission. Live (non-sandbox) payments only on the association's decision. Open BI Escales to other expedition leaders and associations.

Prior work

Blue Intelligence, the NAVIGUIDE simulator and the Berry-Mappemonde website existed before 1 Oct 2026 and contained no PayPal code. The BI Escales repository, backend, frontend, AI Captain and all PayPal integration were built during the submission period.

PayPal sandbox only. Amounts in EUR, prices simulated. The demo voyage clock is pinned to 12 Nov 2026 08:00 UTC. Not for navigation.

Built With

  • ag-grid
  • apimatic
  • bryntum
  • channel3
  • fastapi
  • leaflet.js
  • mongodb
  • naviguide
  • nvidia-nemotron
  • nvidia-nim
  • openrouter
  • paypal-agent-toolkit
  • paypal-card-fields
  • paypal-js-sdk-v6
  • paypal-orders-v2
  • paypal-server-sdk
  • paypal-subscriptions
  • paypal-vault
  • paypal-webhooks
  • postman
  • python
  • react
  • render
  • typescript
  • vite
Share this project:

Updates

Submission history