Intégrations externes¶

Services tiers consommés par l'API et les workers. Code providers : projects/api/src/__new/lib/providers/.

Vue synthétique¶

flowchart LR
  api["API / Workers"]

  api --> lw["Lemonway<br/>KYC · wallets · P2P"]
  api --> checkout["Checkout.com<br/>CB"]
  api --> cio["Customer.io<br/>Emails · OTP"]
  api --> s3["AWS S3<br/>Fichiers"]
  api --> pappers["Pappers<br/>Entreprises"]
  api --> pdf["PDF Generator"]
  api --> slack["Slack<br/>Alertes"]
  api --> neon["Neon API<br/>Scale DB"]

  lw -->|webhooks| api
  checkout -->|webhooks| api

Paiements & KYC¶

Service	Rôle	Direction	Auth	Owner	Notes
Lemonway	KYC, wallets, virements, P2P, retraits, SPV	API ↔ Lemonway	À compléter	À compléter	Egress via `lw-static-ip-proxy` (IP fixe Railway)
Checkout.com	Paiements carte (top-up, réservations)	API ↔ Checkout	À compléter	À compléter	Webhooks entrants

Communication & ops¶

Service	Rôle	Direction	Auth	Owner	Notes
Customer.io	Emails transactionnels, OTP 2FA, tracking	API → CIO	API keys	À compléter	B2C + B2B
Slack	Alertes ops (fraude, P2P, chargebacks…)	API / workers → Slack	Bot token	À compléter	Canaux : À compléter

Stockage & documents¶

Service	Rôle	Direction	Auth	Owner	Notes
AWS S3	Documents, médias biens, uploads PDP	API ↔ S3	IAM	À compléter	Région `eu-west-3`
Azure Blob	Stockage legacy / alternatif	API ↔ Azure	À compléter	À compléter
PDF Generator	Contrats, factures	Worker → service	API key	À compléter	Async

Données & enrichissement¶

Service	Rôle	Direction	Auth	Owner
Pappers	Recherche entreprises FR (PDP)	API → Pappers	API key	À compléter
Neon API	Scale compute DB autour collectes	Cron → Neon	API key	À compléter
Mapbox	Géocodage (optionnel)	API → Mapbox	Token	À compléter
Regula	Scan pièces d'identité (optionnel)	À compléter	À compléter	À compléter
Parseur	Parsing documents (optionnel)	À compléter	À compléter	À compléter

Outils métier & legacy¶

Service	Rôle	Direction	Auth	Owner	Notes
Gestion des défauts	Défauts / votes investisseurs	API ↔ service	À compléter	À compléter
Projet Analyse	Analyse projets	API ↔ service	À compléter	À compléter
Community Vote	Plateforme de vote	API ↔ service	API key	À compléter
Espace Financement (Bubble)	Bridge legacy PDP	API ↔ Bubble	API key	À compléter	Migration : À compléter

Observabilité & analytics (front)¶

Service	Rôle	Apps	Owner	Notes
Datadog	APM, logs, RUM	API + fronts	À compléter	Voir Infrastructure
PostHog	Product analytics	Fronts	À compléter
GTM	Tag management	Web	À compléter
Chromatic	Storybook visuel	CI	À compléter

Webhooks entrants (vers API)¶

Source	Route / mécanisme	Auth	Owner
Lemonway	À compléter	`x-api-key`	À compléter
Checkout.com	À compléter	À compléter	À compléter
Autres	`/internal/*` ou routes dédiées	API key	À compléter

APIs internes sortantes (M2M)¶

Consommateurs autorisés via ApiAuthService : gestion-defauts, projet-analyse, customer-ticketing, ia-whatsapp, ai-agent, site-vitrine, espace-financement.

Détail contrats : GET /internal/docs/json.

À compléter¶

Sujet	Notes
Matrice criticité (P0/P1) par intégration
Contacts support / escalation par vendor
Données PII échangées par service
Environnements sandbox vs prod par tiers
Contrats / DPA / hébergement données (RGPD)