-
-
World map on production: every project the voyage can fund (white dots) and the blue round-the-world route with its stopovers.
-
The full app: 4,463 projects on the world map, AI Captain, stopover calendar, Crew at 10 € per year, and stop pledges paid on arrival.
-
Voyage map on production: the boat's route, stopovers and projects, with the AI Captain and the stopover calendar.
-
Card pledge with the 3-D Secure challenge: the bank asks for an extra verification before the pledge is authorized.
-
Pledge authorized: nothing is charged until the boat reaches the stop and the treasurer approves the capture.
-
PayPal Checkout: pledge in euros with a PayPal account or a card.
-
Demo treasurer: judges simulate arrival, then approve, capture, void or refund their own pledge, no key needed.
-
Stopover calendar (Bryntum): one bar per stop, from arrival to departure, following the voyage clock.
-
AG Studio treasurer dashboard (AG Grid): captured, authorized, voided and refunded totals per funding target.
-
Common-fund donation by card: charged immediately after approval, unlike stop pledges held until arrival.
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