{"openapi":"3.1.0","info":{"title":"MOWGLY Module Pro : API","version":"1.0.0","summary":"Comparaison sourcée des garanties d'une carte bancaire face à l'offre d'un partenaire.","termsOfService":"https://mowgly.fr/cgu","license":{"name":"Conditions générales d'utilisation","url":"https://mowgly.fr/cgu"},"contact":{"name":"Support MOWGLY","email":"support@mowgly.fr","url":"https://mowgly.fr/pro"},"x-logo":{"url":"https://pro.mowgly.fr/logo-mowgly-light.svg","altText":"MOWGLY"},"description":"L'API du Module Pro compare les garanties d'une carte bancaire avec celles de vos offres d'assurance.\nChaque valeur renvoyée cite sa source (extrait et page des conditions contractuelles).\n\n**L'API ne rend aucun verdict.** Elle ne classe pas les offres et ne recommande aucun achat :\nelle restitue des faits, ligne par ligne. Le choix de l'offre présentée et la décision d'affichage\nappartiennent au partenaire.\n\nHébergement en Union européenne. Aucune donnée nominative n'est requise ni acceptée.\n\n# Démarrer\n\n1. **Créez un jeton d'intégration** dans votre portail partenaire (https://pro.mowgly.fr).\n   Le secret (`mwg_...`) n'est affiché qu'une seule fois : stockez-le côté serveur, jamais dans un navigateur.\n2. **Vérifiez l'accès** :\n   ```bash\n   curl https://pro.mowgly.fr/pro/v1/health\n   ```\n3. **Listez les cartes** pour obtenir un `card_id` :\n   ```bash\n   curl https://pro.mowgly.fr/pro/v1/cards \\\n     -H \"Authorization: Bearer $MOWGLY_TOKEN\"\n   ```\n4. **Lancez une comparaison en bac à sable** (cartes de démonstration, listées dans votre portail).\n   L'identifiant d'offre se lit dans le portail, rubrique Mes offres, ou dans `GET /pro/v1/portal/docs` (scope `portal:read`).\n   ```bash\n   curl -X POST https://pro.mowgly.fr/pro/v1/portal/sandbox \\\n     -H \"Authorization: Bearer $MOWGLY_TOKEN\" \\\n     -H \"Content-Type: application/json\" \\\n     -d '{\"card_id\":\"{card_id}\",\"offer_ids\":[\"{offer_id}\"]}'\n   ```\n5. **En production**, appelez `POST /pro/v1/compare` avec le même corps.\n\n# Authentification et modes\n\nToutes les requêtes (sauf `/health`) portent `Authorization: Bearer <jeton>`.\nLe **mode** d'intégration et le **périmètre** (vos offres actives) sont dérivés du jeton, jamais du corps de requête.\n\n| Mode | Usage | Scopes du jeton | Endpoints principaux |\n|---|---|---|---|\n| Mode 1 · Widget site | Comparatif embarqué sur votre site | `compare:run` | `/widget/session`, `/compare`, `/cards` |\n| Mode 2 · Espace conseiller | Outil d'aide pour vos conseillers | `compare:run`, `resolve:run` | `/advisor/*`, `/compare` |\n| Mode 3 · Relance e-mail | Identifie la carte par son BIN et renvoie le comparatif et un modèle d'e-mail de relance. | `compare:run` | `/compare/by-bin` |\n\nLes endpoints de captation (`/events`, `/bookings`) sont ouverts à tous les modes.\n\n**Restriction de domaine** : un jeton de canal `website` n'est accepté que si l'en-tête `Origin` (ou `Referer`)\ncorrespond à l'un de ses `allowed_domains` (domaine exact ou sous-domaine — même règle que le jeton de rendu du widget).\nCe contrôle n'authentifie pas l'appel : un client hors navigateur peut envoyer ces en-têtes.\nL'authentification reste le jeton Bearer.\n\n# Conventions\n\n- JSON UTF-8. Clés en `snake_case` anglais. Les valeurs métier restent en français (`garantie`, `exclusion`...).\n- **Succès** : le corps contient directement la ressource. **Erreur** : `{ \"error\": { \"code\", \"message\" }, \"request_id\" }`.\n- Chaque réponse porte l'en-tête `X-Request-Id` (repris dans le corps sous `request_id`).\n  Format unique : `req_` suivi de 12 caractères aléatoires. Communiquez-le au support.\n- Toute réponse `401` porte l'en-tête `WWW-Authenticate: Bearer`.\n- Dates au format ISO 8601. Devises au format ISO 4217 en majuscules (`EUR`).\n- **Valeurs comparées** : affichez les champs `*_display` (texte prêt à afficher, calculé par MOWGLY).\n  Les champs `*_value` contiennent la valeur brute, de forme variable, pour usage avancé.\n- Ignorez les champs inconnus : de nouveaux champs optionnels peuvent apparaître sans préavis.\n- Concevez votre intégration pour que votre parcours se poursuive sans le comparatif si l'API ne répond pas dans un délai de 3 secondes.\n\n# Limites de débit\n\nLes plafonds effectifs (requêtes, cartes distinctes, quota mensuel) sont fixés par votre contrat\net visibles dans votre portail.\n\n| Limite | Valeur | Code en cas de dépassement |\n|---|---|---|\n| Requêtes | selon votre contrat | `RATE_LIMITED` |\n| Cartes distinctes | selon votre contrat | `CARD_VELOCITY_LIMIT` |\n| Quota mensuel | selon votre plan | `QUOTA_EXCEEDED` |\n\nChaque réponse authentifiée porte `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset`.\nUne réponse `429` porte `Retry-After` (secondes).\n\n# Consommation\n\nLe détail est visible dans le portail, rubrique Facturation & consommation.\n\n# Idempotence\n\n`POST /bookings` exige un en-tête `Idempotency-Key` (recommandé aussi sur `POST /events`) :\nune valeur unique par opération, par exemple un UUID, conservée 24 heures.\n\n- Même clé, même corps : la réponse d'origine est renvoyée avec `Idempotent-Replayed: true`. Rien n'est créé en double.\n- Même clé, corps différent : `409 IDEMPOTENCY_CONFLICT`.\n\n# Erreurs\n\n| Code | HTTP | Cause |\n|---|---|---|\n| `VALIDATION_ERROR` | 400 | Corps JSON invalide ou champ requis manquant |\n| `OFFER_REQUIRED` | 400 | Plusieurs offres actives et aucune offre précisée ni configurée par défaut |\n| `IDEMPOTENCY_KEY_REQUIRED` | 400 | En-tête `Idempotency-Key` absent |\n| `UNAUTHORIZED` | 401 | Jeton absent, invalide ou révoqué. En-tête `WWW-Authenticate: Bearer`. |\n| `TOKEN_EXPIRED` | 401 | Jeton expiré |\n| `TOKEN_SUSPENDED` | 401 | Jeton suspendu |\n| `FORBIDDEN` | 403 | Scope insuffisant, domaine ou IP non autorisé |\n| `ACCOUNT_INACTIVE` | 403 | Compte partenaire inactif |\n| `EVALUATION_DEMO_CARDS_ONLY` | 403 | Compte en évaluation : seules les cartes de démonstration sont accessibles. |\n| `TOKEN_MODE_MISSING` | 403 | Jeton sans mode d'intégration |\n| `MODE_NOT_ALLOWED` | 403 | Endpoint réservé à un autre mode |\n| `NO_ACTIVE_OFFER` | 403 | Aucune offre active sur le compte |\n| `OFFER_NOT_OWNED` | 403 | Offre hors de votre compte ou inactive |\n| `SCOPES_REQUIRED` | 403 | Scopes demandés hors de vos droits |\n| `NOT_FOUND` | 404 | Chemin inconnu |\n| `CARD_NOT_FOUND` | 404 | Carte inconnue ou inactive |\n| `NOT_A_CARD` | 404 | L'identifiant ne désigne pas une carte |\n| `OFFER_NOT_FOUND` | 404 | Offre introuvable ou non analysée |\n| `ISSUER_NOT_FOUND` | 404 | Banque inconnue |\n| `TOKEN_NOT_FOUND` | 404 | Jeton inconnu |\n| `METHOD_NOT_ALLOWED` | 405 | Méthode HTTP non autorisée pour cette ressource |\n| `IDEMPOTENCY_CONFLICT` | 409 | Clé déjà utilisée avec un corps différent |\n| `RATE_LIMITED` | 429 | Débit dépassé |\n| `CARD_VELOCITY_LIMIT` | 429 | Trop de cartes distinctes consultées dans la fenêtre |\n| `QUOTA_EXCEEDED` | 429 | Quota mensuel atteint |\n| `INTERNAL_ERROR` | 500 | Erreur inattendue (communiquez le `request_id`) |\n\n# Widget (Mode 1)\n\n1. **Côté serveur**, émettez un jeton de rendu avec `POST /pro/v1/widget/session`.\n   Le jeton est court (180 s par défaut, 600 s maximum) et à usage limité\n   (1 usage si la carte est imposée, 5 maximum en sélection ouverte).\n2. **Côté page**, insérez le conteneur, définissez la configuration, puis chargez `https://pro.mowgly.fr/widget/mowgly.js` avec l'attribut `async` (la configuration doit précéder le chargement) :\n   ```html\n   <div id=\"mowgly-widget\"></div>\n   ```\n   ```js\n   window.MOWGLY_WIDGET = {\n     mount: \"#mowgly-widget\",\n     renderToken: \"{render_token}\"\n   };\n   ```\n3. Le widget s'affiche dans un Shadow DOM (aucun conflit de style avec votre page) et émet des événements\n   DOM sur l'élément de montage : `mowgly:ready`, `mowgly:comparison_displayed`, `mowgly:cta_clicked`, `mowgly:error`.\n\nLe jeton de rendu n'est accepté que depuis les domaines autorisés du jeton d'intégration (domaine exact ou sous-domaine).\n\n# Accès d'évaluation\n\nUn compte d'évaluation utilise la même API, limitée aux cartes de démonstration.\nDemande d'accès : https://mowgly.fr/pro\n\n# Cadre\n\nMOWGLY est courtier en assurances immatriculé à l'ORIAS n° 25 007 209.\n\n- Conditions générales d'utilisation : https://mowgly.fr/cgu\n- Politique de confidentialité : https://mowgly.fr/confidentialite\n- Sécurité et accord de traitement, fourni sur demande : https://mowgly.fr/pro/securite\n- Disponibilité constatée : https://mowgly.fr/statut\n\n# Journal des versions\n\n## 1.0.0\n\nContrat public initial : santé, référentiel des cartes, comparaison, widget, espace conseiller, relance par BIN, captation et bac à sable.\n\n# Versioning\n\nLa version `v1` est stable. Sans préavis : ajout d'endpoints et de champs optionnels.\nTout changement cassant donne lieu à une nouvelle version (`/pro/v2`), annoncée par e-mail ;\nla version précédente reste disponible au moins 6 mois après l'annonce.\n"},"servers":[{"url":"https://pro.mowgly.fr"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Santé","description":"Sonde de disponibilité."},{"name":"Référentiel","description":"Identification des cartes (aucune garantie renvoyée)."},{"name":"Comparaison","description":"Comparaison carte × offres partenaires, sourcée, sans verdict."},{"name":"Mode 1 · Widget site","description":"Émission d'un jeton de rendu pour le widget embarqué."},{"name":"Mode 2 · Espace conseiller","description":"Sélecteur banque puis carte, et export PDF à votre marque."},{"name":"Mode 3 · Relance e-mail","description":"Identifie la carte par son BIN et renvoie le comparatif et un modèle d'e-mail de relance."},{"name":"Captation","description":"Événements de parcours et souscriptions. Aucune donnée nominative."},{"name":"Portail","description":"Bac à sable et documentation de vos offres."}],"paths":{"/pro/v1/health":{"get":{"tags":["Santé"],"operationId":"getHealth","summary":"Sonde de disponibilité","description":"Indique si l'API répond. Aucune authentification.","security":[],"responses":{"200":{"description":"Service disponible.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"type":"object","required":["status","version","timestamp","request_id"],"properties":{"status":{"type":"string","const":"ok"},"version":{"type":"string","examples":["v1"]},"timestamp":{"type":"string","format":"date-time","examples":["2026-11-13T15:00:00Z"]},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"disponible":{"summary":"Service disponible","value":{"status":"ok","version":"v1","timestamp":"2026-11-13T15:00:00Z","request_id":"req_01J9X3K2ZP8A"}}}}}},"405":{"description":"Méthode HTTP non autorisée (`METHOD_NOT_ALLOWED`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"methode":{"summary":"Méthode non autorisée","value":{"error":{"code":"METHOD_NOT_ALLOWED","message":"Méthode non autorisée pour cette ressource."},"request_id":"req_01J9X3K2ZP8A"}}}}}},"503":{"description":"Service temporairement indisponible. Réessayez plus tard.","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"type":"object","required":["status","version","timestamp","request_id"],"properties":{"status":{"type":"string","const":"unavailable"},"version":{"type":"string","examples":["v1"]},"timestamp":{"type":"string","format":"date-time","examples":["2026-11-13T15:00:00Z"]},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"indisponible":{"summary":"Service indisponible","value":{"status":"unavailable","version":"v1","timestamp":"2026-11-13T15:00:00Z","request_id":"req_01J9X3K2ZP8A"}}}}}}}}},"/pro/v1/cards":{"get":{"tags":["Référentiel"],"operationId":"listCards","summary":"Lister les cartes actives","description":"Référentiel des cartes pour peupler un sélecteur et obtenir un `card_id`. Ne renvoie jamais de garanties.\nRéponse cacheable : renvoyez l'`ETag` reçu dans `If-None-Match` pour obtenir un `304`.\n\n**Scope requis :** `compare:run`\n","x-required-scope":"compare:run","x-codeSamples":[{"lang":"Node.js","label":"Node.js","source":"const response = await fetch(\"https://pro.mowgly.fr/pro/v1/cards\", {\n  headers: { Authorization: `Bearer ${process.env.MOWGLY_TOKEN}` },\n});\nconst body = await response.json();\n"},{"lang":"Python","label":"Python","source":"import os\nimport requests\n\nresponse = requests.get(\n    \"https://pro.mowgly.fr/pro/v1/cards\",\n    headers={\"Authorization\": f\"Bearer {os.environ['MOWGLY_TOKEN']}\"},\n    timeout=3,\n)\nprint(response.json())\n"},{"lang":"PHP","label":"PHP","source":"$ch = curl_init(\"https://pro.mowgly.fr/pro/v1/cards\");\ncurl_setopt_array($ch, [\n    CURLOPT_HTTPHEADER => [\"Authorization: Bearer \" . getenv(\"MOWGLY_TOKEN\")],\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_TIMEOUT => 3,\n]);\necho curl_exec($ch);\n"}],"parameters":[{"$ref":"#/components/parameters/IfNoneMatch"}],"responses":{"200":{"description":"Référentiel des cartes.","headers":{"ETag":{"schema":{"type":"string"},"description":"Empreinte du référentiel."},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","required":["cards","request_id"],"properties":{"cards":{"type":"array","items":{"$ref":"#/components/schemas/CardSummary"}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"liste":{"summary":"Carte de démonstration","value":{"cards":[{"card_id":"00000000-0000-4000-8000-000000000001","card_name":"Carte Exemple Premier","card_network":"Visa","card_image_url":"https://pro.mowgly.fr/cards/exemple-premier.png","bank_name":"Banque Exemple","bank_logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg"}],"request_id":"req_01J9X3K2ZP8A"}}}}}},"304":{"description":"Référentiel inchangé."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/compare":{"post":{"tags":["Comparaison"],"operationId":"compare","summary":"Comparer une carte à vos offres","description":"Comparaison ligne par ligne, sourcée, sans verdict. Seules les lignes de vos offres actives sont renvoyées.\nL'identifiant d'offre se lit dans le portail, rubrique Mes offres, ou dans `GET /pro/v1/portal/docs` (scope `portal:read`).\n\n**Scope requis :** `compare:run`\n","x-required-scope":"compare:run","x-codeSamples":[{"lang":"Node.js","label":"Node.js","source":"const response = await fetch(\"https://pro.mowgly.fr/pro/v1/compare\", {\n  method: \"POST\",\n  headers: {\n    Authorization: `Bearer ${process.env.MOWGLY_TOKEN}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\n    card_id: process.env.CARD_ID,\n    offer_ids: [process.env.OFFER_ID],\n  }),\n});\nconst body = await response.json();\n"},{"lang":"Python","label":"Python","source":"import os\nimport requests\n\nresponse = requests.post(\n    \"https://pro.mowgly.fr/pro/v1/compare\",\n    headers={\"Authorization\": f\"Bearer {os.environ['MOWGLY_TOKEN']}\"},\n    json={\n        \"card_id\": os.environ[\"CARD_ID\"],\n        \"offer_ids\": [os.environ[\"OFFER_ID\"]],\n    },\n    timeout=3,\n)\nprint(response.json())\n"},{"lang":"PHP","label":"PHP","source":"$payload = json_encode([\n    \"card_id\" => getenv(\"CARD_ID\"),\n    \"offer_ids\" => [getenv(\"OFFER_ID\")],\n]);\n$ch = curl_init(\"https://pro.mowgly.fr/pro/v1/compare\");\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,\n    CURLOPT_POSTFIELDS => $payload,\n    CURLOPT_HTTPHEADER => [\n        \"Authorization: Bearer \" . getenv(\"MOWGLY_TOKEN\"),\n        \"Content-Type: application/json\",\n    ],\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_TIMEOUT => 3,\n]);\necho curl_exec($ch);\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareRequest"},"examples":{"defaut":{"$ref":"#/components/examples/CompareRequestExample"}}}}},"responses":{"200":{"description":"Comparatif sourcé.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareResponse"},"examples":{"complet":{"$ref":"#/components/examples/CompareResponseExample"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/compare/by-bin":{"post":{"tags":["Mode 3 · Relance e-mail"],"operationId":"compareByBin","summary":"Résoudre la carte par BIN et comparer","description":"À partir du BIN de la carte (6 à 8 premiers chiffres), préparez un comparatif à envoyer par e-mail à votre client.\nLe BIN n'est jamais stocké en clair.\n\n**Choix de l'offre** : MOWGLY n'arbitre jamais entre vos offres. L'offre comparée est, dans l'ordre :\ncelle passée dans `offer_id` ; à défaut, l'offre par défaut configurée dans votre portail ;\nà défaut, votre unique offre active. Si vous avez plusieurs offres actives sans offre par défaut\net sans `offer_id`, l'API renvoie `400 OFFER_REQUIRED`.\n\n**Scope requis :** `compare:run` · **Mode :** 3\n","x-required-scope":"compare:run","x-codeSamples":[{"lang":"curl","label":"curl","source":"curl -X POST https://pro.mowgly.fr/pro/v1/compare/by-bin \\\n  -H \"Authorization: Bearer $MOWGLY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"bin\":\"400000\",\"offer_id\":\"'\"$OFFER_ID\"'\",\"trip\":{\"destination\":\"Japon\",\"departure_date\":\"2026-08-01\",\"return_date\":\"2026-08-15\"}}'\n"},{"lang":"Node.js","label":"Node.js","source":"const response = await fetch(\"https://pro.mowgly.fr/pro/v1/compare/by-bin\", {\n  method: \"POST\",\n  headers: {\n    Authorization: `Bearer ${process.env.MOWGLY_TOKEN}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\n    bin: \"400000\",\n    offer_id: process.env.OFFER_ID,\n    trip: {\n      destination: \"Japon\",\n      departure_date: \"2026-08-01\",\n      return_date: \"2026-08-15\",\n    },\n  }),\n});\nconst body = await response.json();\n"},{"lang":"Python","label":"Python","source":"import os\nimport requests\n\nresponse = requests.post(\n    \"https://pro.mowgly.fr/pro/v1/compare/by-bin\",\n    headers={\"Authorization\": f\"Bearer {os.environ['MOWGLY_TOKEN']}\"},\n    json={\n        \"bin\": \"400000\",\n        \"offer_id\": os.environ[\"OFFER_ID\"],\n        \"trip\": {\n            \"destination\": \"Japon\",\n            \"departure_date\": \"2026-08-01\",\n            \"return_date\": \"2026-08-15\",\n        },\n    },\n    timeout=3,\n)\nprint(response.json())\n"},{"lang":"PHP","label":"PHP","source":"$payload = json_encode([\n    \"bin\" => \"400000\",\n    \"offer_id\" => getenv(\"OFFER_ID\"),\n    \"trip\" => [\n        \"destination\" => \"Japon\",\n        \"departure_date\" => \"2026-08-01\",\n        \"return_date\" => \"2026-08-15\",\n    ],\n]);\n$ch = curl_init(\"https://pro.mowgly.fr/pro/v1/compare/by-bin\");\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,\n    CURLOPT_POSTFIELDS => $payload,\n    CURLOPT_HTTPHEADER => [\n        \"Authorization: Bearer \" . getenv(\"MOWGLY_TOKEN\"),\n        \"Content-Type: application/json\",\n    ],\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_TIMEOUT => 3,\n]);\necho curl_exec($ch);\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareByBinRequest"},"examples":{"bin":{"value":{"bin":"400000","offer_id":"00000000-0000-4000-8000-000000000002","trip":{"destination":"Japon","departure_date":"2026-08-01","return_date":"2026-08-15"}}}}}}},"responses":{"200":{"description":"Résolution (`detected`, `probable` ou `unknown`) et comparatif si la carte est identifiée.\nSi le BIN est inconnu, `comparison` est `null` et `fallback` invite à passer par un sélecteur de carte.\n","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareByBinResponse"},"examples":{"detecte":{"$ref":"#/components/examples/CompareByBinResponseExample"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/widget/session":{"post":{"tags":["Mode 1 · Widget site"],"operationId":"createWidgetSession","summary":"Émettre un jeton de rendu","description":"Appel serveur à serveur. Utilisez un jeton d'intégration de canal `software` :\nce canal ne contrôle pas `Origin`. Si une liste d'adresses IP est configurée sur le jeton, l'appel doit en provenir.\n\nUn jeton de canal `website` exige un en-tête `Origin` (ou `Referer`) autorisé.\nUn serveur qui ne l'envoie pas reçoit `403`.\n\nL'identifiant d'offre (`offer_ids`) se lit dans le portail, rubrique Mes offres,\nou dans `GET /pro/v1/portal/docs` (scope `portal:read`).\n\nLe jeton de rendu obtenu est passé au widget dans la page.\nN'exposez jamais votre jeton d'intégration dans un navigateur.\n\n**Scope requis :** `compare:run` · **Mode :** 1\n","x-required-scope":"compare:run","x-codeSamples":[{"lang":"curl","label":"curl","source":"# Jeton d'intégration de canal software, lu côté serveur.\ncurl -X POST https://pro.mowgly.fr/pro/v1/widget/session \\\n  -H \"Authorization: Bearer $MOWGLY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"card_id\":\"'\"$CARD_ID\"'\",\"offer_ids\":[\"'\"$OFFER_ID\"'\"]}'\n"},{"lang":"Node.js","label":"Node.js","source":"// Jeton d'intégration de canal software, lu côté serveur.\nconst response = await fetch(\"https://pro.mowgly.fr/pro/v1/widget/session\", {\n  method: \"POST\",\n  headers: {\n    Authorization: `Bearer ${process.env.MOWGLY_TOKEN}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\n    card_id: process.env.CARD_ID,\n    offer_ids: [process.env.OFFER_ID],\n  }),\n});\nconst body = await response.json();\n"},{"lang":"Python","label":"Python","source":"import os\nimport requests\n\n# Jeton d'intégration de canal software, lu côté serveur.\nresponse = requests.post(\n    \"https://pro.mowgly.fr/pro/v1/widget/session\",\n    headers={\"Authorization\": f\"Bearer {os.environ['MOWGLY_TOKEN']}\"},\n    json={\n        \"card_id\": os.environ[\"CARD_ID\"],\n        \"offer_ids\": [os.environ[\"OFFER_ID\"]],\n    },\n    timeout=3,\n)\nprint(response.json())\n"},{"lang":"PHP","label":"PHP","source":"// Jeton d'intégration de canal software, lu côté serveur.\n$payload = json_encode([\n    \"card_id\" => getenv(\"CARD_ID\"),\n    \"offer_ids\" => [getenv(\"OFFER_ID\")],\n]);\n$ch = curl_init(\"https://pro.mowgly.fr/pro/v1/widget/session\");\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,\n    CURLOPT_POSTFIELDS => $payload,\n    CURLOPT_HTTPHEADER => [\n        \"Authorization: Bearer \" . getenv(\"MOWGLY_TOKEN\"),\n        \"Content-Type: application/json\",\n    ],\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_TIMEOUT => 3,\n]);\necho curl_exec($ch);\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetSessionRequest"},"examples":{"defaut":{"value":{"offer_ids":["00000000-0000-4000-8000-000000000002"],"card_id":"00000000-0000-4000-8000-000000000001"}}}}}},"responses":{"200":{"description":"Jeton de rendu.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetSessionResponse"},"examples":{"session":{"summary":"Jeton de rendu, carte imposée","value":{"render_token":"rt_exemple_session","token_type":"render","expires_in":180,"max_uses":1,"session_id":"sess_voyage_japon","scope":{"card_id":"00000000-0000-4000-8000-000000000001","offer_ids":["00000000-0000-4000-8000-000000000002"],"mode":1,"card_selection":"fixed"},"request_id":"req_01J9X3K2ZP8A"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/advisor/issuers":{"get":{"tags":["Mode 2 · Espace conseiller"],"operationId":"listIssuers","summary":"Lister les banques émettrices","description":"**Scope requis :** `resolve:run` · **Mode :** 2","x-required-scope":"resolve:run","responses":{"200":{"description":"Banques émettrices.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"type":"object","required":["issuers","request_id"],"properties":{"issuers":{"type":"array","items":{"$ref":"#/components/schemas/Issuer"}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"banques":{"summary":"Banque de démonstration","value":{"issuers":[{"issuer_id":"issuer_banque_exemple","name":"Banque Exemple","logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg","card_count":1}],"request_id":"req_01J9X3K2ZP8A"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/advisor/issuers/{issuer_id}/cards":{"get":{"tags":["Mode 2 · Espace conseiller"],"operationId":"listIssuerCards","summary":"Lister les cartes d'une banque","description":"**Scope requis :** `resolve:run` · **Mode :** 2","x-required-scope":"resolve:run","parameters":[{"name":"issuer_id","in":"path","required":true,"description":"Identifiant de banque renvoyé par `GET /pro/v1/advisor/issuers`.","schema":{"type":"string","examples":["issuer_banque_exemple"]}}],"responses":{"200":{"description":"Cartes de la banque.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"type":"object","required":["issuer_id","cards","request_id"],"properties":{"issuer_id":{"type":"string","examples":["issuer_banque_exemple"]},"cards":{"type":"array","items":{"$ref":"#/components/schemas/CardSummary"}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"cartes":{"summary":"Cartes de la banque","value":{"issuer_id":"issuer_banque_exemple","cards":[{"card_id":"00000000-0000-4000-8000-000000000001","card_name":"Carte Exemple Premier","card_network":"Visa","card_image_url":"https://pro.mowgly.fr/cards/exemple-premier.png","bank_name":"Banque Exemple","bank_logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg"}],"request_id":"req_01J9X3K2ZP8A"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/advisor/resolve":{"post":{"tags":["Mode 2 · Espace conseiller"],"operationId":"resolveCard","summary":"Valider la carte choisie","description":"Confirme qu'une carte choisie dans le sélecteur est active et renvoie son identité.\n\n**Scope requis :** `resolve:run` · **Mode :** 2\n","x-required-scope":"resolve:run","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["card_id"],"additionalProperties":false,"properties":{"card_id":{"type":"string","format":"uuid","examples":["00000000-0000-4000-8000-000000000001"]}}},"examples":{"carte":{"summary":"Carte Exemple Premier","value":{"card_id":"00000000-0000-4000-8000-000000000001"}}}}}},"responses":{"200":{"description":"Carte validée.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"type":"object","required":["card","request_id"],"properties":{"card":{"$ref":"#/components/schemas/CardSummary"},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"validee":{"summary":"Carte active","value":{"card":{"card_id":"00000000-0000-4000-8000-000000000001","card_name":"Carte Exemple Premier","card_network":"Visa","card_image_url":"https://pro.mowgly.fr/cards/exemple-premier.png","bank_name":"Banque Exemple","bank_logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg"},"request_id":"req_01J9X3K2ZP8A"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/advisor/pdf":{"post":{"tags":["Mode 2 · Espace conseiller"],"operationId":"exportAdvisorPdf","summary":"Export PDF à votre marque","description":"PDF du comparatif à votre en-tête, avec les mentions réglementaires du courtier (ORIAS).\nLes erreurs sont renvoyées en JSON.\n\n**Scope requis :** `compare:run` · **Mode :** 2\n","x-required-scope":"compare:run","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareRequest"},"examples":{"defaut":{"$ref":"#/components/examples/CompareRequestExample"}}}}},"responses":{"200":{"description":"Document PDF.","content":{"application/pdf":{"schema":{"type":"string","contentMediaType":"application/pdf"}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/events":{"post":{"tags":["Captation"],"operationId":"createEvent","summary":"Déclarer un événement de parcours","description":"Déclarez ce qui se passe chez vous (comparatif affiché, bouton cliqué, e-mail envoyé...).\n`meta` est refusé si une clé ou une valeur ressemble à une donnée nominative.\n\n**Scope requis :** `compare:run`\n","x-required-scope":"compare:run","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyOptional"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventRequest"},"examples":{"email":{"value":{"type":"email_sent","comparison_id":"00000000-0000-4000-8000-000000000003","occurred_at":"2026-07-15T09:00:00Z"}}}}}},"responses":{"200":{"description":"Rejeu idempotent (en-tête `Idempotent-Replayed: true`), rien n'est créé.","headers":{"Idempotent-Replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventResponse"},"examples":{"rejeu":{"summary":"Même événement, rien n'est recréé","value":{"event_id":"00000000-0000-4000-8000-000000000020","type":"email_sent","request_id":"req_01J9X3K2ZP8A"}}}}}},"201":{"description":"Événement enregistré.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventResponse"},"examples":{"enregistre":{"summary":"E-mail de relance envoyé","value":{"event_id":"00000000-0000-4000-8000-000000000020","type":"email_sent","request_id":"req_01J9X3K2ZP8A"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/bookings":{"post":{"tags":["Captation"],"operationId":"createBooking","summary":"Déclarer une souscription","description":"Déclarez une souscription à votre offre, idéalement reliée au comparatif d'origine (`comparison_id`).\nAucune donnée nominative. L'en-tête `Idempotency-Key` est obligatoire.\n\n**Scope requis :** `compare:run`\n","x-required-scope":"compare:run","parameters":[{"$ref":"#/components/parameters/IdempotencyKeyRequired"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingRequest"},"examples":{"booking":{"value":{"offer_id":"00000000-0000-4000-8000-000000000002","comparison_id":"00000000-0000-4000-8000-000000000003","amount":100,"currency":"EUR","external_ref":"ORD-DEMO-0001"}}}}}},"responses":{"200":{"description":"Rejeu idempotent (en-tête `Idempotent-Replayed: true`), rien n'est créé.","headers":{"Idempotent-Replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingResponse"},"examples":{"rejeu":{"summary":"Même souscription, rien n'est recréé","value":{"booking_id":"00000000-0000-4000-8000-000000000030","offer_id":"00000000-0000-4000-8000-000000000002","comparison_id":"00000000-0000-4000-8000-000000000003","request_id":"req_01J9X3K2ZP8A"}}}}}},"201":{"description":"Souscription enregistrée.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingResponse"},"examples":{"creee":{"summary":"Souscription reliée au comparatif","value":{"booking_id":"00000000-0000-4000-8000-000000000030","offer_id":"00000000-0000-4000-8000-000000000002","comparison_id":"00000000-0000-4000-8000-000000000003","request_id":"req_01J9X3K2ZP8A"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/portal/sandbox":{"post":{"tags":["Portail"],"operationId":"compareSandbox","summary":"Comparer en bac à sable","description":"Exécute un vrai `/compare`, restreint à vos offres et à un jeu de cartes de démonstration.\nMême requête et même réponse que `POST /pro/v1/compare`.\n\n**Scope requis :** `compare:run`\n","x-required-scope":"compare:run","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareRequest"},"examples":{"defaut":{"$ref":"#/components/examples/CompareRequestExample"}}}}},"responses":{"200":{"description":"Comparatif de démonstration.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareResponse"},"examples":{"complet":{"$ref":"#/components/examples/CompareResponseExample"}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/pro/v1/portal/docs":{"get":{"tags":["Portail"],"operationId":"getPortalDocs","summary":"Lignes de vos offres analysées","description":"Export de vos offres actives et de leurs lignes, tel qu'utilisé par `/compare`.\n\n**Scope requis :** `portal:read`\n","x-required-scope":"portal:read","responses":{"200":{"description":"Offres et lignes.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"type":"object","required":["offers","request_id"],"properties":{"offers":{"type":"array","items":{"$ref":"#/components/schemas/PortalOffer"}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"examples":{"offres":{"summary":"Offre analysée","value":{"offers":[{"offer_id":"00000000-0000-4000-8000-000000000002","offer_name":"Assurance Voyage Sérénité","underwriter_name":"Assureur Exemple","version":3,"analysed_at":"2026-09-12T10:00:00Z","lines":[{"line_id":"00000000-0000-4000-8000-000000000010","nature":"garantie","label":"Frais médicaux à l'étranger","offer_display":"300 000 €","offer_citation":{"text":"Frais médicaux engagés à l'étranger : 300 000 € par personne.","page":"8","section":"Article 4"}}]}],"request_id":"req_01J9X3K2ZP8A"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Jeton d'intégration MOWGLY (`mwg_...`). Le mode et le périmètre sont dérivés du jeton."}},"parameters":{"IfNoneMatch":{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag d'une réponse précédente. Renvoie `304` si le référentiel est inchangé."},"IdempotencyKeyRequired":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Valeur unique par opération (UUID recommandé), conservée 24 heures."},"IdempotencyKeyOptional":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128},"description":"Recommandé. Valeur unique par opération (UUID recommandé), conservée 24 heures."}},"headers":{"XRequestId":{"description":"Identifiant de la requête (`req_` suivi de 12 caractères aléatoires), à communiquer au support.","schema":{"$ref":"#/components/schemas/RequestId"}},"RateLimitLimit":{"description":"Plafond de la fenêtre courante.","schema":{"type":"integer"}},"RateLimitRemaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimitReset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}},"RetryAfter":{"description":"Secondes à attendre avant un nouvel essai.","schema":{"type":"integer"}},"IdempotentReplayed":{"description":"`true` si la réponse est le rejeu d'une requête déjà traitée.","schema":{"type":"string","enum":["true"]}}},"schemas":{"RequestId":{"type":"string","pattern":"^req_[A-Za-z0-9_-]{12}$","description":"Identifiant de la requête, identique à l'en-tête `X-Request-Id`. Préfixe `req_` suivi de 12 caractères aléatoires.","examples":["req_01J9X3K2ZP8A"]},"ErrorCode":{"type":"string","enum":["VALIDATION_ERROR","OFFER_REQUIRED","IDEMPOTENCY_KEY_REQUIRED","UNAUTHORIZED","TOKEN_EXPIRED","TOKEN_SUSPENDED","FORBIDDEN","ACCOUNT_INACTIVE","EVALUATION_DEMO_CARDS_ONLY","TOKEN_MODE_MISSING","MODE_NOT_ALLOWED","NO_ACTIVE_OFFER","OFFER_NOT_OWNED","SCOPES_REQUIRED","NOT_FOUND","METHOD_NOT_ALLOWED","CARD_NOT_FOUND","NOT_A_CARD","OFFER_NOT_FOUND","ISSUER_NOT_FOUND","TOKEN_NOT_FOUND","IDEMPOTENCY_CONFLICT","RATE_LIMITED","CARD_VELOCITY_LIMIT","QUOTA_EXCEEDED","INTERNAL_ERROR"]},"Error":{"type":"object","required":["error","request_id"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string","description":"Message lisible, en français. Ne pas parser.","examples":["Jeton d'authentification invalide."]},"details":{"type":["object","null"],"additionalProperties":true,"description":"Précisions éventuelles (par exemple le champ en erreur)."}}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"RawValue":{"description":"Valeur brute, de forme variable (texte, nombre, booléen, objet ou liste).\nPour l'affichage, utilisez le champ `*_display` correspondant.\n","type":["string","number","boolean","object","array","null"]},"Citation":{"type":"object","description":"Source de la valeur dans les conditions contractuelles.","required":["text","page","section"],"properties":{"text":{"type":["string","null"],"description":"Extrait du document.","examples":["Frais médicaux engagés à l'étranger : 300 000 € par personne."]},"page":{"type":["string","null"],"description":"Page telle qu'imprimée sur le document (par exemple `12` ou `12-13`).","examples":["8"]},"section":{"type":["string","null"],"description":"Section ou article.","examples":["Article 4"]}}},"CardSummary":{"type":"object","required":["card_id","card_name","card_network","card_image_url","bank_name","bank_logo_url"],"properties":{"card_id":{"type":"string","format":"uuid","examples":["00000000-0000-4000-8000-000000000001"]},"card_name":{"type":"string","examples":["Carte Exemple Premier"]},"card_network":{"type":["string","null"],"examples":["Visa"]},"card_image_url":{"type":["string","null"],"format":"uri","examples":["https://pro.mowgly.fr/cards/exemple-premier.png"]},"bank_name":{"type":"string","examples":["Banque Exemple"]},"bank_logo_url":{"type":["string","null"],"format":"uri","examples":["https://pro.mowgly.fr/banks/banque-exemple.svg"]}}},"CardDetail":{"allOf":[{"$ref":"#/components/schemas/CardSummary"},{"type":"object","required":["card_slug","bank_legal_name","bank_orias","bank_website","notice"],"properties":{"card_slug":{"type":"string","examples":["banque-exemple-premier"]},"bank_legal_name":{"type":["string","null"],"examples":["Banque Exemple SA"]},"bank_orias":{"type":["string","null"],"description":"Immatriculation ORIAS de la banque émettrice.","examples":["07000000"]},"bank_website":{"type":["string","null"],"format":"uri","examples":["https://www.banque-exemple.fr"]},"notice":{"type":"object","description":"Notice d'assurance de la carte utilisée pour la comparaison.","required":["version","effective_date","source_url","document_url"],"properties":{"version":{"type":["string","null"],"examples":["2026-01"]},"effective_date":{"type":["string","null"],"format":"date","examples":["2026-01-01"]},"source_url":{"type":["string","null"],"format":"uri","description":"Page de la banque où la notice est publiée.","examples":["https://www.banque-exemple.fr/cartes/premier"]},"document_url":{"type":["string","null"],"format":"uri","description":"Document de la notice.","examples":["https://www.banque-exemple.fr/docs/notice-premier-2026.pdf"]}}}}}]},"Issuer":{"type":"object","required":["issuer_id","name","logo_url","card_count"],"properties":{"issuer_id":{"type":"string","examples":["issuer_banque_exemple"]},"name":{"type":"string","examples":["Banque Exemple"]},"logo_url":{"type":["string","null"],"format":"uri","examples":["https://pro.mowgly.fr/banks/banque-exemple.svg"]},"card_count":{"type":"integer","minimum":0}}},"CompareRequest":{"type":"object","required":["card_id","offer_ids"],"additionalProperties":false,"properties":{"card_id":{"type":"string","format":"uuid","description":"Identifiant carte (`GET /pro/v1/cards`)."},"offer_ids":{"type":"array","minItems":1,"items":{"type":"string","format":"uuid"},"description":"Identifiants de vos offres actives."}}},"ComparisonResult":{"type":"object","required":["comparison_id","mode","card","offers","disclaimer","addons"],"properties":{"comparison_id":{"type":"string","format":"uuid","description":"À renvoyer dans `/events` et `/bookings` pour relier le parcours au comparatif."},"mode":{"type":"integer","enum":[1,2,3]},"card":{"$ref":"#/components/schemas/CardDetail"},"offers":{"type":"array","items":{"$ref":"#/components/schemas/ComparedOffer"}},"disclaimer":{"type":"string","description":"Mention de portée à afficher avec le comparatif.","examples":["Comparaison établie à partir des documents contractuels cités. Elle ne constitue pas un conseil."]},"addons":{"$ref":"#/components/schemas/Addons"}}},"CompareResponse":{"allOf":[{"$ref":"#/components/schemas/ComparisonResult"},{"type":"object","required":["request_id"],"properties":{"request_id":{"$ref":"#/components/schemas/RequestId"}}}]},"ComparedOffer":{"type":"object","required":["offer_id","offer_name","underwriter_name","status","version","analysed_at","lines"],"properties":{"offer_id":{"type":"string","format":"uuid","examples":["00000000-0000-4000-8000-000000000002"]},"offer_name":{"type":"string","examples":["Assurance Voyage Sérénité"]},"underwriter_name":{"type":["string","null"],"description":"Assureur porteur du risque.","examples":["Assureur Exemple"]},"status":{"type":"string","enum":["active"]},"version":{"type":"integer","description":"Version de l'analyse de l'offre."},"analysed_at":{"type":["string","null"],"format":"date-time"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/CompareLine"}}}},"LineNature":{"type":"string","enum":["garantie","exclusion","condition","modalite"]},"CompareLine":{"type":"object","required":["line_id","nature","label","offer_value","offer_display","offer_citation","details","comparable","targets"],"properties":{"line_id":{"type":"string","format":"uuid"},"nature":{"$ref":"#/components/schemas/LineNature"},"label":{"type":"string","examples":["Annulation de voyage"]},"offer_value":{"$ref":"#/components/schemas/RawValue"},"offer_display":{"type":["string","null"],"description":"Valeur de l'offre, prête à afficher (même rendu que le widget MOWGLY).","examples":["300 000 €"]},"offer_citation":{"$ref":"#/components/schemas/Citation"},"details":{"$ref":"#/components/schemas/LineDetails"},"comparable":{"type":"boolean","description":"`true` si au moins une cible porte un point de comparaison avec la carte."},"targets":{"type":"array","items":{"$ref":"#/components/schemas/CompareTarget"}}}},"LineDetails":{"type":"object","description":"Précisions contractuelles de la ligne, en texte prêt à afficher. Toutes optionnelles.\n","additionalProperties":false,"patternProperties":{"^quotidien_[a-z0-9_]+$":{"type":"string"}},"properties":{"plafond":{"type":"string"},"plafond_monde":{"type":"string"},"plafond_usa_canada":{"type":"string"},"franchise":{"type":"string"},"seuil":{"type":"string"},"limites_application":{"type":"string"},"condition":{"type":"string"},"motifs":{"type":"string"},"exclusions":{"type":"string"},"prestation":{"type":"string"},"prestations":{"type":"string"},"hebergement":{"type":"string"},"transport":{"type":"string"},"villegiature":{"type":"string"},"location":{"type":"string"},"paiement_cb_requis":{"type":"string"},"territorialite":{"type":"string"},"perimetre":{"type":"string"},"portee":{"type":"string"},"qui_couvert":{"type":"string"},"duree_max_jours":{"type":"string"},"objets_de_valeur":{"type":"string"},"equipement_personnel":{"type":"string"},"deduction":{"type":"string"},"dentaire":{"type":"string"},"affiliation":{"type":"string"}}},"CompareTarget":{"type":"object","description":"Point de la carte aligné sur la ligne d'offre.\n","required":["cb_present","cb_value","cb_display","cb_citation","cb_reason"],"additionalProperties":false,"properties":{"cb_present":{"type":"boolean","description":"`false` : la notice de la carte ne traite pas ce point."},"cb_value":{"$ref":"#/components/schemas/RawValue"},"cb_display":{"type":["string","null"],"description":"Valeur de la carte, prête à afficher (même rendu que le widget MOWGLY).","examples":["155 000 €"]},"cb_citation":{"oneOf":[{"$ref":"#/components/schemas/Citation"},{"type":"null"}]},"cb_reason":{"type":["string","null"],"enum":["concept_not_covered","field_absent",null],"description":"Motif lorsque `cb_present` vaut `false`.\n`concept_not_covered` : la notice de la carte ne prévoit pas cette garantie.\n`field_absent` : la carte traite ce point mais l'information n'est pas disponible. N'en concluez pas que la carte ne couvre pas.\n"}}},"Addons":{"type":"object","description":"Compléments selon le mode du jeton. Mode 1 : objet vide. Mode 2 : `differences`. Mode 3 : `email_template`.\n","additionalProperties":false,"properties":{"differences":{"$ref":"#/components/schemas/Differences"},"email_template":{"$ref":"#/components/schemas/EmailTemplate"}}},"Differences":{"type":"object","description":"Écarts factuels entre l'offre et la carte, ligne par ligne. Aucun classement, aucune recommandation.\n","required":["disclaimer","offers"],"properties":{"disclaimer":{"type":"string"},"offers":{"type":"array","items":{"type":"object","required":["offer_id","offer_name","offer_exceeds_card","card_exceeds_offer"],"properties":{"offer_id":{"type":"string","format":"uuid"},"offer_name":{"type":"string"},"offer_exceeds_card":{"type":"array","description":"Points où l'offre va au-delà de la carte.","items":{"$ref":"#/components/schemas/DifferenceItem"}},"card_exceeds_offer":{"type":"array","description":"Points où la carte va au-delà de l'offre.","items":{"$ref":"#/components/schemas/DifferenceItem"}}}}}}},"DifferenceItem":{"type":"object","required":["line_label","text"],"properties":{"line_label":{"type":"string"},"text":{"type":"string"}}},"EmailTemplate":{"type":"object","required":["subject","body_text","body_html","disclaimer"],"properties":{"subject":{"type":"string","examples":["Votre voyage au Japon : Assurance Voyage Sérénité et votre Carte Exemple Premier"]},"body_text":{"type":"string","examples":["Bonjour, voici le comparatif entre Assurance Voyage Sérénité (300 000 €) et votre Carte Exemple Premier (155 000 €) pour les frais médicaux à l'étranger."]},"body_html":{"type":"string","examples":["<p>Frais médicaux à l'étranger : Assurance Voyage Sérénité 300 000 €, Carte Exemple Premier 155 000 €.</p>"]},"disclaimer":{"type":"string","examples":["Comparaison établie à partir des documents contractuels cités. Elle ne constitue pas un conseil. MOWGLY, courtier en assurances immatriculé à l'ORIAS n° 25 007 209."]}}},"Trip":{"type":"object","description":"Contexte de voyage, sans donnée nominative. Renvoyé tel quel.","additionalProperties":false,"properties":{"destination":{"type":"string","maxLength":64,"examples":["Japon"]},"departure_date":{"type":"string","format":"date"},"return_date":{"type":"string","format":"date"}}},"CompareByBinRequest":{"type":"object","additionalProperties":false,"anyOf":[{"required":["bin"]},{"required":["card_id"]}],"properties":{"bin":{"type":"string","pattern":"^[0-9]{6,8}$","description":"6 à 8 premiers chiffres de la carte."},"card_id":{"type":"string","format":"uuid","description":"Carte déjà connue (court-circuite la résolution)."},"offer_id":{"type":"string","format":"uuid","description":"Offre à comparer. Obligatoire si plusieurs offres actives sans offre par défaut."},"trip":{"$ref":"#/components/schemas/Trip"}}},"CompareByBinResponse":{"type":"object","required":["mode","resolution","trip","offer_selection","comparison","fallback","request_id"],"properties":{"mode":{"type":"integer","const":3},"resolution":{"type":"object","required":["status","confidence","card","candidates","bin_info"],"properties":{"status":{"type":"string","enum":["detected","probable","unknown"],"description":"`detected` : carte identifiée.\n`probable` : plusieurs cartes possibles ; le comparatif porte sur la plus probable (`card`),\nles autres sont dans `candidates`. Faites confirmer la carte par l'utilisateur.\n`unknown` : carte non identifiée, voir `fallback`.\n"},"confidence":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Indice de confiance de la résolution (0 à 1)."},"card":{"oneOf":[{"$ref":"#/components/schemas/CardSummary"},{"type":"null"}]},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/CardSummary"}},"bin_info":{"type":["object","null"],"description":"Métadonnées non nominatives du BIN.","additionalProperties":false,"properties":{"card_network":{"type":["string","null"],"examples":["Visa"]},"card_type":{"type":["string","null"],"description":"Débit, crédit, prépayée.","examples":["debit"]},"card_category":{"type":["string","null"],"examples":["Premier"]},"issuer_name":{"type":["string","null"]},"country_code":{"type":["string","null"],"pattern":"^[A-Z]{2}$","examples":["FR"]}}}}},"trip":{"oneOf":[{"$ref":"#/components/schemas/Trip"},{"type":"null"}]},"offer_selection":{"type":["object","null"],"required":["offer_id","source"],"properties":{"offer_id":{"type":"string","format":"uuid"},"source":{"type":"string","enum":["request","default","single"],"description":"`request` : passée dans la requête. `default` : offre par défaut de votre portail. `single` : votre unique offre active."}}},"comparison":{"oneOf":[{"$ref":"#/components/schemas/ComparisonResult"},{"type":"null"}]},"fallback":{"type":["object","null"],"description":"Présent uniquement si `status` vaut `unknown`. Proposez un sélecteur de carte alimenté par\n`GET /pro/v1/cards`, puis rappelez cet endpoint avec `card_id`.\n","required":["code","message"],"properties":{"code":{"type":"string","enum":["BIN_UNKNOWN"]},"message":{"type":"string"}}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"WidgetSessionRequest":{"type":"object","required":["offer_ids"],"additionalProperties":false,"properties":{"offer_ids":{"type":"array","minItems":1,"items":{"type":"string","format":"uuid"}},"card_id":{"type":"string","format":"uuid","description":"Carte imposée. Absent : l'utilisateur choisit sa carte dans le widget."},"ttl":{"type":"integer","minimum":30,"maximum":600,"default":180,"description":"Durée de vie en secondes."},"max_uses":{"type":"integer","minimum":1,"maximum":5,"description":"Usages autorisés. 1 maximum si `card_id` est fourni, 5 sinon."},"session_id":{"type":"string","maxLength":128,"description":"Identifiant opaque de votre session."}}},"WidgetSessionResponse":{"type":"object","required":["render_token","token_type","expires_in","max_uses","session_id","scope","request_id"],"properties":{"render_token":{"type":"string","description":"Jeton opaque à passer au widget. Ne le journalisez pas.","examples":["rt_exemple_session"]},"token_type":{"type":"string","const":"render"},"expires_in":{"type":"integer","description":"Secondes."},"max_uses":{"type":"integer"},"session_id":{"type":["string","null"],"examples":["sess_voyage_japon"]},"scope":{"type":"object","required":["card_id","offer_ids","mode","card_selection"],"properties":{"card_id":{"type":["string","null"],"format":"uuid"},"offer_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"mode":{"type":"integer","enum":[1]},"card_selection":{"type":"string","enum":["fixed","open"]}}},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"EventType":{"type":"string","enum":["comparison_displayed","cta_clicked","email_sent","email_opened","email_clicked","quote_started"]},"EventRequest":{"type":"object","required":["type"],"additionalProperties":false,"properties":{"type":{"$ref":"#/components/schemas/EventType"},"comparison_id":{"type":"string","format":"uuid"},"offer_id":{"type":"string","format":"uuid"},"occurred_at":{"type":"string","format":"date-time"},"meta":{"type":"object","maxProperties":12,"description":"Contexte libre, valeurs simples uniquement, 2 Ko maximum, aucune donnée nominative.","additionalProperties":{"type":["string","number","boolean","null"]}}}},"EventResponse":{"type":"object","required":["event_id","type","request_id"],"properties":{"event_id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/EventType"},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"BookingRequest":{"type":"object","required":["offer_id"],"additionalProperties":false,"properties":{"offer_id":{"type":"string","format":"uuid"},"comparison_id":{"type":"string","format":"uuid"},"amount":{"type":"number","minimum":0,"description":"Prime ou montant, à titre informatif."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","examples":["EUR"]},"external_ref":{"type":"string","maxLength":64,"description":"Votre référence, jamais nominative.","examples":["ORD-DEMO-0001"]},"occurred_at":{"type":"string","format":"date-time"}}},"BookingResponse":{"type":"object","required":["booking_id","offer_id","comparison_id","request_id"],"properties":{"booking_id":{"type":"string","format":"uuid"},"offer_id":{"type":"string","format":"uuid"},"comparison_id":{"type":["string","null"],"format":"uuid"},"request_id":{"$ref":"#/components/schemas/RequestId"}}},"PortalOffer":{"type":"object","required":["offer_id","offer_name","underwriter_name","version","analysed_at","lines"],"properties":{"offer_id":{"type":"string","format":"uuid","examples":["00000000-0000-4000-8000-000000000002"]},"offer_name":{"type":"string","examples":["Assurance Voyage Sérénité"]},"underwriter_name":{"type":["string","null"],"examples":["Assureur Exemple"]},"version":{"type":"integer","examples":[3]},"analysed_at":{"type":["string","null"],"format":"date-time","examples":["2026-09-12T10:00:00Z"]},"lines":{"type":"array","items":{"type":"object","required":["line_id","nature","label","offer_display","offer_citation"],"properties":{"line_id":{"type":"string","format":"uuid","examples":["00000000-0000-4000-8000-000000000010"]},"nature":{"$ref":"#/components/schemas/LineNature"},"label":{"type":"string","examples":["Frais médicaux à l'étranger"]},"offer_display":{"type":["string","null"],"examples":["300 000 €"]},"offer_citation":{"$ref":"#/components/schemas/Citation"}}}}}}},"responses":{"ValidationError":{"description":"Requête invalide (`VALIDATION_ERROR`, `OFFER_REQUIRED`, `IDEMPOTENCY_KEY_REQUIRED`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"validation":{"value":{"error":{"code":"VALIDATION_ERROR","message":"`card_id` requis."},"request_id":"req_01J9X3K2ZP8A"}}}}}},"Unauthorized":{"description":"Authentification refusée (`UNAUTHORIZED`, `TOKEN_EXPIRED`, `TOKEN_SUSPENDED`).","headers":{"WWW-Authenticate":{"description":"Schéma d'authentification requis. Présent sur chaque réponse 401.","schema":{"type":"string","const":"Bearer"}},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"jeton_invalide":{"summary":"Jeton refusé","value":{"error":{"code":"UNAUTHORIZED","message":"Jeton d'authentification invalide."},"request_id":"req_01J9X3K2ZP8A"}}}}}},"Forbidden":{"description":"Accès refusé (`FORBIDDEN`, `ACCOUNT_INACTIVE`, `EVALUATION_DEMO_CARDS_ONLY`, `TOKEN_MODE_MISSING`, `MODE_NOT_ALLOWED`, `NO_ACTIVE_OFFER`, `OFFER_NOT_OWNED`, `SCOPES_REQUIRED`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Ressource introuvable (`CARD_NOT_FOUND`, `NOT_A_CARD`, `OFFER_NOT_FOUND`, `ISSUER_NOT_FOUND`, `TOKEN_NOT_FOUND`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"Clé d'idempotence déjà utilisée avec un autre corps (`IDEMPOTENCY_CONFLICT`).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Limite atteinte (`RATE_LIMITED`, `CARD_VELOCITY_LIMIT`, `QUOTA_EXCEEDED`).","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Erreur inattendue (`INTERNAL_ERROR`). Communiquez le `request_id` au support.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"examples":{"CompareRequestExample":{"summary":"Une carte, une offre","value":{"card_id":"00000000-0000-4000-8000-000000000001","offer_ids":["00000000-0000-4000-8000-000000000002"]}},"CompareResponseExample":{"summary":"Comparatif complet (données fictives)","value":{"comparison_id":"00000000-0000-4000-8000-000000000003","mode":1,"card":{"card_id":"00000000-0000-4000-8000-000000000001","card_name":"Carte Exemple Premier","card_network":"Visa","card_image_url":"https://pro.mowgly.fr/cards/exemple-premier.png","bank_name":"Banque Exemple","bank_logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg","card_slug":"banque-exemple-premier","bank_legal_name":"Banque Exemple SA","bank_orias":"07000000","bank_website":"https://www.banque-exemple.fr","notice":{"version":"2026-01","effective_date":"2026-01-01","source_url":"https://www.banque-exemple.fr/cartes/premier","document_url":"https://www.banque-exemple.fr/docs/notice-premier-2026.pdf"}},"offers":[{"offer_id":"00000000-0000-4000-8000-000000000002","offer_name":"Assurance Voyage Sérénité","underwriter_name":"Assureur Exemple","status":"active","version":3,"analysed_at":"2026-09-12T10:00:00Z","lines":[{"line_id":"00000000-0000-4000-8000-000000000010","nature":"garantie","label":"Frais médicaux à l'étranger","offer_value":"300 000 €","offer_display":"300 000 €","offer_citation":{"text":"Frais médicaux engagés à l'étranger : 300 000 € par personne.","page":"8","section":"Article 4"},"details":{"plafond":"300 000 € par personne"},"comparable":true,"targets":[{"cb_present":true,"cb_value":"155 000 €","cb_display":"155 000 €","cb_citation":{"text":"Frais médicaux à l'étranger : jusqu'à 155 000 € par assuré.","page":"12","section":"3.2"},"cb_reason":null}]},{"line_id":"00000000-0000-4000-8000-000000000011","nature":"garantie","label":"Retard de bagages","offer_value":"300 €","offer_display":"300 €","offer_citation":{"text":"Retard de bagages supérieur à 24 heures : 300 €.","page":"10","section":"Article 7"},"details":{},"comparable":true,"targets":[{"cb_present":false,"cb_value":null,"cb_display":null,"cb_citation":null,"cb_reason":"concept_not_covered"}]},{"line_id":"00000000-0000-4000-8000-000000000012","nature":"exclusion","label":"Faute intentionnelle","offer_value":[{"evenement":"Faute intentionnelle ou dolosive"}],"offer_display":"Faute intentionnelle ou dolosive","offer_citation":{"text":"Sont exclus les dommages résultant d'une faute intentionnelle ou dolosive.","page":"14","section":"Article 11"},"details":{},"comparable":true,"targets":[{"cb_present":true,"cb_value":[{"evenement":"Faute intentionnelle ou dolosive"}],"cb_display":"Faute intentionnelle ou dolosive","cb_citation":{"text":"Exclusions communes : la faute intentionnelle ou dolosive de l'assuré.","page":"5","section":"1.4"},"cb_reason":null}]}]}],"disclaimer":"Comparaison établie à partir des documents contractuels cités. Elle ne constitue pas un conseil.","addons":{},"request_id":"req_01J9X3K2ZP8A"}},"CompareByBinResponseExample":{"summary":"Carte identifiée par BIN (données fictives)","value":{"mode":3,"resolution":{"status":"detected","confidence":0.92,"card":{"card_id":"00000000-0000-4000-8000-000000000001","card_name":"Carte Exemple Premier","card_network":"Visa","card_image_url":"https://pro.mowgly.fr/cards/exemple-premier.png","bank_name":"Banque Exemple","bank_logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg"},"candidates":[],"bin_info":{"card_network":"Visa","card_type":"debit","card_category":"Premier","issuer_name":"Banque Exemple","country_code":"FR"}},"trip":{"destination":"Japon","departure_date":"2026-08-01","return_date":"2026-08-15"},"offer_selection":{"offer_id":"00000000-0000-4000-8000-000000000002","source":"request"},"comparison":{"comparison_id":"00000000-0000-4000-8000-000000000003","mode":3,"card":{"card_id":"00000000-0000-4000-8000-000000000001","card_name":"Carte Exemple Premier","card_network":"Visa","card_image_url":"https://pro.mowgly.fr/cards/exemple-premier.png","bank_name":"Banque Exemple","bank_logo_url":"https://pro.mowgly.fr/banks/banque-exemple.svg","card_slug":"banque-exemple-premier","bank_legal_name":"Banque Exemple SA","bank_orias":"07000000","bank_website":"https://www.banque-exemple.fr","notice":{"version":"2026-01","effective_date":"2026-01-01","source_url":"https://www.banque-exemple.fr/cartes/premier","document_url":"https://www.banque-exemple.fr/docs/notice-premier-2026.pdf"}},"offers":[{"offer_id":"00000000-0000-4000-8000-000000000002","offer_name":"Assurance Voyage Sérénité","underwriter_name":"Assureur Exemple","status":"active","version":3,"analysed_at":"2026-09-12T10:00:00Z","lines":[{"line_id":"00000000-0000-4000-8000-000000000010","nature":"garantie","label":"Frais médicaux à l'étranger","offer_value":"300 000 €","offer_display":"300 000 €","offer_citation":{"text":"Frais médicaux engagés à l'étranger : 300 000 € par personne.","page":"8","section":"Article 4"},"details":{"plafond":"300 000 € par personne"},"comparable":true,"targets":[{"cb_present":true,"cb_value":"155 000 €","cb_display":"155 000 €","cb_citation":{"text":"Frais médicaux à l'étranger : jusqu'à 155 000 € par assuré.","page":"12","section":"3.2"},"cb_reason":null}]}]}],"disclaimer":"Comparaison établie à partir des documents contractuels cités. Elle ne constitue pas un conseil.","addons":{"email_template":{"subject":"Votre voyage au Japon : Assurance Voyage Sérénité et votre Carte Exemple Premier","body_text":"Bonjour,\n\nVous préparez un séjour au Japon, du 1er au 15 août 2026. Voici le comparatif entre l'offre Assurance Voyage Sérénité (Assureur Exemple) et votre Carte Exemple Premier (Banque Exemple).\n\nFrais médicaux à l'étranger\n- Assurance Voyage Sérénité : 300 000 € par personne. Extrait : « Frais médicaux engagés à l'étranger : 300 000 € par personne. » (article 4, page 8).\n- Carte Exemple Premier : 155 000 € par assuré. Extrait : « Frais médicaux à l'étranger : jusqu'à 155 000 € par assuré. » (section 3.2, page 12).\n\nCe comparatif reprend les documents contractuels cités. Il ne constitue pas un conseil en assurance.\n","body_html":"<p>Bonjour,</p>\n<p>Vous préparez un séjour au Japon, du 1er au 15 août 2026. Voici le comparatif entre l'offre <strong>Assurance Voyage Sérénité</strong> (Assureur Exemple) et votre <strong>Carte Exemple Premier</strong> (Banque Exemple).</p>\n<table>\n  <thead>\n    <tr>\n      <th>Garantie</th>\n      <th>Assurance Voyage Sérénité</th>\n      <th>Carte Exemple Premier</th>\n    </tr>\n  </thead>\n  <tbody>\n    <tr>\n      <td>Frais médicaux à l'étranger</td>\n      <td>300 000 € par personne<br>Article 4, page 8</td>\n      <td>155 000 € par assuré<br>Section 3.2, page 12</td>\n    </tr>\n  </tbody>\n</table>\n<p>Ce comparatif reprend les documents contractuels cités. Il ne constitue pas un conseil en assurance.</p>\n","disclaimer":"Comparaison établie à partir des documents contractuels cités. Elle ne constitue pas un conseil. MOWGLY, courtier en assurances immatriculé à l'ORIAS n° 25 007 209."}}},"fallback":null,"request_id":"req_01J9X3K2ZP8A"}}}}}