INTÉGRATION B2B

API Partenaires

Permet aux boîtes de nuit, hôtels 5 étoiles, wedding planners et autres partenaires d'offrir les services AUREARGENT à leur clientèle directement depuis leur propre interface de réservation.

Authentification

Chaque partenaire reçoit une clé API pk_live_xxx générée depuis l'admin AUREARGENT. La clé est transmise via le header HTTP :

Authorization: Bearer pk_live_xxx

Toutes les requêtes sont auditées (IP, body, status, durée) côté AUREARGENT.

Types de partenaires supportés

  • nightclub — boîtes de nuit (Twiga, Jimmy'z, etc.)
  • hotel — hôtels 5* (concierge desk)
  • wedding_planner — wedding planners / agences mariage
  • yacht_charter — compagnies yacht charter
  • jet_broker — brokers jet privé
  • event_agency — agences événementielles
  • real_estate — agences immobilier luxe
  • spa_beauty — spas / instituts de beauté
  • restaurant — restaurants gastronomiques
  • travel_agency — agences voyage haut de gamme

Services demandables

  • chauffeur — transfert chauffeur privé (prix instantané)
  • vehicle_rental — location véhicule avec chauffeur longue durée (prix instantané)
  • photographer — shooting photo (devis sur demande)
  • villa_inquiry — réservation villa (devis sur demande)
  • yacht_inquiry — affrètement yacht (devis sur demande)
  • jet_inquiry — vol jet privé (devis sur demande)
  • event_package — package événement complet (devis)
  • concierge_request — demande conciergerie générique

Endpoints

1. POST /api/partners/v1/chauffeur-quote

Demande un devis. Pour chauffeur et vehicle_rental le prix est retourné instantanément. Pour les autres services, le devis est marqué on_demand et AUREARGENT répond sous 2h ouvrées.

{
  "service_type": "chauffeur",
  "client_name": "John Doe",
  "client_phone": "+33600000000",
  "client_email": "[email protected]",
  "passengers": 2,
  "pickup_time": "2026-06-15T01:30:00Z",
  "pickup_location": "Twiga Monte-Carlo",
  "dropoff_location": "Hotel de Paris",
  "vehicle_class": "luxury",
  "external_ref": "TWG-12345",
  "notes": "VIP table — sortie carre or"
}

Réponse (chauffeur, prix instantané) :

{
  "success": true,
  "quote_id": "uuid",
  "service_type": "chauffeur",
  "price": 120,
  "currency": "EUR",
  "on_demand": false,
  "expires_at": "2026-06-14T23:45:00Z"
}

Réponse (autres services, sur devis) :

{
  "success": true,
  "quote_id": "uuid",
  "service_type": "villa_inquiry",
  "price": null,
  "on_demand": true,
  "message": "Devis sur demande — AUREARGENT vous repond sous 2h ouvrees..."
}

2. POST /api/partners/v1/chauffeur-confirm

Confirme un devis. La mission est créée et dispatchée chez AUREARGENT.

{ "quote_id": "uuid" }

Le devis expire au bout de 15 min pour les prix instantanés (24h pour on-demand).

3. GET /api/partners/v1/bookings/:id

Polling pour suivre le statut : quoted → confirmed → dispatched → in_progress → completed.

4. POST /api/partners/v1/bookings/:id/cancel

{ "reason": "client annule" }

Sécurité

  • Clé API hashée bcrypt cost 12, comparaison constante (anti-timing)
  • Rate limit 60 requêtes / minute par clé
  • Audit log complet (IP, user-agent, request body, durée) dans partner_api_logs
  • HTTPS strict (TLS 1.3, HSTS preload)
  • Toutes les données partenaires en RLS Postgres (service_role uniquement)
  • Rotation de clé en 1 clic depuis l'admin AUREARGENT (révoque immédiatement l'ancienne)

Sandbox / Tests

Contacter [email protected] pour obtenir une clé sandbox.