OPT-OPS-001Choix de la banqueréglementéContrat d'API et exploitation

Contrat OpenAPI publié par la banque

Comment la banque publie-t-elle son implémentation de la spec ?

Les options

  • Fichier STET adapté

    host obligatoirement personnalisé, basePath et URL d'autorisation et de token personnalisables.

  • Écarts marqués

    Version de référence dans x-stet-psd2-api-reference-version, définitions dérivées marquées x-original-definition.

Dans STET 1.6.3
  • Les commentaires x-comments en tête du fichier OpenAPI, et l'en-tête de réponse Warning.
Côté banque
Le marquage de la version est fortement recommandé. Un point d'entrée déprécié peut être signalé par l'en-tête Warning: 299.
Côté TPP
Lire ces marqueurs pour repérer les écarts au standard, et surveiller Warning dans les réponses.
Réglementation

Les changements de spécification de l'interface sont annoncés aux TPP au moins trois mois à l'avance, sauf urgence (art. 30(4) des RTS). Pour l'exemption de secours, la banque publie un résumé de sa spécification (orientation 6.4 de l'EBA/GL/2018/07).

Textes cités

Fiche vérifiée le 19 octobre 2026.

D'après la spécification STET PSD2 API 1.6.3, sous licence CC BY 3.0 FR.

La fiche telle qu'elle est stockée
{
  "id": "OPT-OPS-001",
  "edition": "1.6.3",
  "chooser": "aspsp",
  "title": {
    "fr": "Contrat OpenAPI publié par la banque",
    "en": "OpenAPI contract published by the bank",
    "es": "Contrato OpenAPI publicado por el banco",
    "pt-br": "Contrato OpenAPI publicado pelo banco"
  },
  "question": {
    "fr": "Comment la banque publie-t-elle son implémentation de la spec ?",
    "en": "How does the bank publish its implementation of the spec?",
    "es": "¿Cómo publica el banco su implementación de la especificación?",
    "pt-br": "Como o banco publica a sua implementação da especificação?"
  },
  "options": [
    {
      "label": {
        "fr": "Fichier STET adapté",
        "en": "Adapted STET file",
        "es": "Archivo STET adaptado",
        "pt-br": "Arquivo STET adaptado"
      },
      "text": {
        "fr": "`host` obligatoirement personnalisé, `basePath` et URL d'autorisation et de token personnalisables.",
        "en": "`host` must be customised, `basePath` and the authorization and token URLs can be customised.",
        "es": "`host` de personalización obligatoria, `basePath` y URL de autorización y de token personalizables.",
        "pt-br": "`host` obrigatoriamente personalizado, `basePath` e URLs de autorização e de token personalizáveis."
      }
    },
    {
      "label": {
        "fr": "Écarts marqués",
        "en": "Marked deviations",
        "es": "Desviaciones marcadas",
        "pt-br": "Desvios marcados"
      },
      "text": {
        "fr": "Version de référence dans `x-stet-psd2-api-reference-version`, définitions dérivées marquées `x-original-definition`.",
        "en": "Reference version in `x-stet-psd2-api-reference-version`, derived definitions marked with `x-original-definition`.",
        "es": "Versión de referencia en `x-stet-psd2-api-reference-version`, definiciones derivadas marcadas con `x-original-definition`.",
        "pt-br": "Versão de referência em `x-stet-psd2-api-reference-version`, definições derivadas marcadas com `x-original-definition`."
      }
    }
  ],
  "stet": {
    "sections": [],
    "openapi": [],
    "flows": [],
    "changes": [],
    "remark": {
      "fr": "Les commentaires `x-comments` en tête du fichier OpenAPI, et l'en-tête de réponse `Warning`.",
      "en": "The `x-comments` at the top of the OpenAPI file, and the `Warning` response header.",
      "es": "Los comentarios `x-comments` al principio del archivo OpenAPI, y el header de respuesta `Warning`.",
      "pt-br": "Os comentários `x-comments` no início do arquivo OpenAPI, e o header de resposta `Warning`."
    }
  },
  "aspsp": {
    "fr": "Le marquage de la version est fortement recommandé. Un point d'entrée déprécié peut être signalé par l'en-tête `Warning: 299`.",
    "en": "Marking the version is strongly recommended. A deprecated endpoint can be flagged with the `Warning: 299` header.",
    "es": "Se recomienda encarecidamente marcar la versión. Un endpoint obsoleto puede señalarse con el header `Warning: 299`.",
    "pt-br": "A marcação da versão é fortemente recomendada. Um endpoint obsoleto pode ser sinalizado pelo header `Warning: 299`."
  },
  "tpp": {
    "fr": "Lire ces marqueurs pour repérer les écarts au standard, et surveiller `Warning` dans les réponses.",
    "en": "Read these markers to spot deviations from the standard, and watch for `Warning` in responses.",
    "es": "Leer estas marcas para detectar las desviaciones respecto al estándar, y vigilar `Warning` en las respuestas.",
    "pt-br": "Ler esses marcadores para identificar os desvios em relação ao padrão, e monitorar `Warning` nas respostas."
  },
  "regulation": {
    "text": {
      "fr": "Les changements de spécification de l'interface sont annoncés aux TPP au moins trois mois à l'avance, sauf urgence (art. 30(4) des RTS). Pour l'exemption de secours, la banque publie un résumé de sa spécification (orientation 6.4 de l'EBA/GL/2018/07).",
      "en": "Changes to the interface specification are announced to TPPs at least three months in advance, except in emergencies (Article 30(4) of the RTS). For the exemption from the contingency mechanism, the bank publishes a summary of its specification (Guideline 6.4 of EBA/GL/2018/07).",
      "es": "Los cambios en la especificación de la interfaz se anuncian a los TPP con al menos tres meses de antelación, salvo urgencia (art. 30(4) de las RTS). Para la exención del mecanismo de reserva, el banco publica un resumen de su especificación (directriz 6.4 de EBA/GL/2018/07).",
      "pt-br": "As mudanças na especificação da interface são anunciadas aos TPP com pelo menos três meses de antecedência, salvo urgência (art. 30(4) das RTS). Para obter a isenção do mecanismo de contingência, o banco publica um resumo da sua especificação (orientação 6.4 das orientações EBA/GL/2018/07)."
    },
    "sources": [
      {
        "act": "rts",
        "ref": "art. 30(4)"
      },
      {
        "act": "eba-gl-2018-07",
        "ref": "6.4"
      }
    ]
  },
  "note": null,
  "production": null,
  "verifiedAt": "2026-10-19"
}