Aller au contenu

Special Purpose Vehicule

Contrôleur HTTP des SPV (Special Purpose Vehicules) : consultation, édition, création de comptes techniques Lemonway, et exposition des soldes / mandats SDD / IBANs de retrait associés. Source : special-purpose-vehicule.controller.ts.

Tous les endpoints requièrent une session admin BetterAuth valide (AdminAuthGuard).

Préfixe de routes : /administration/spv.

GET /

Liste tous les SPV avec leurs projets associés.

Response

Tableau de SPV via SpecialPurposeVehiculeRepository.getManyWithProjects.

GET /:id

Récupère un SPV par son identifiant.

Path param

  • id — UUIDv4 du SPV (validé via ParseUUIDPipe)

Response

SpecialPurposeVehicule.T (source).

Erreurs

Code Statut Cause
(not found) 404 SPV introuvable

PUT /

Met à jour un SPV existant. Trace une AdminAction SPV_EDIT via interceptor (seul id du body est persisté dans le payload d'audit).

Request body

{
  "id": "uuid",
  "json": { "...": "SpecialPurposeVehicule.validator (entité complète)" }
}

json validé via SpecialPurposeVehicule.validator (source).

Response

200 OK avec un corps vide (le handler ne renvoie rien et n'a pas de @HttpCode).

Erreurs

Code Statut Cause
(not found) 404 SPV introuvable

GET /countries

Liste les pays autorisés pour un SPV.

Response

Tableau des valeurs de SpecialPurposeVehicule.Country (source) : France, Portugal, Angleterre, France outre-mer, Andorre, Espagne, Italie, Belgique, Suisse, Luxembourg, Réunion (île), île Maurice, Allemagne, Pays-Bas, Dubai, Maroc, Grèce.

GET /:id/lemonway-balance-available

Retourne le solde Lemonway disponible du wallet d'un SPV.

Path param

  • id — UUID du SPV ou lemonwayExternalId

Response

{
  "lwInternalId": 123,
  "lwExternalId": "ext-id",
  "availableBalance": 50000
}

Erreurs

Code Statut Cause
(not found) 404 SPV introuvable
spv.lemonway.wallet.not-found 404 SPV sans wallet Lemonway configuré
(internal) 500 Échec de l'appel Lemonway

GET /:id/withdraw-bank-accounts

Liste les IBANs de retrait associés au wallet Lemonway d'un SPV.

Path param

  • id — UUID du SPV ou lemonwayExternalId

Response

Tableau d'IBANs / bank accounts associés au wallet.

Erreurs

Code Statut Cause
(not found) 404 SPV introuvable
(not found) 404 SPV sans wallet Lemonway
(internal) 500 Échec de l'appel Lemonway

GET /:id/sdd-mandates

Liste les mandats SDD (prélèvement bancaire) liés au wallet Lemonway d'un SPV.

Path param

  • id — UUID du SPV ou lemonwayExternalId

Response

Tableau de mandats SDD retourné par lemonwayApi.getSddMandates.

Erreurs

Code Statut Cause
(not found) 404 SPV introuvable
spv.lemonway.wallet.not-found 404 SPV sans wallet Lemonway
(internal) 500 Échec de l'appel Lemonway

Liens