OPT-OPS-001Bank's choiceregulatedAPI contract and operations

OpenAPI contract published by the bank

How does the bank publish its implementation of the spec?

The options

  • Adapted STET file

    host must be customised, basePath and the authorization and token URLs can be customised.

  • Marked deviations

    Reference version in x-stet-psd2-api-reference-version, derived definitions marked with x-original-definition.

In STET 1.6.3
  • The x-comments at the top of the OpenAPI file, and the Warning response header.
Bank side
Marking the version is strongly recommended. A deprecated endpoint can be flagged with the Warning: 299 header.
TPP side
Read these markers to spot deviations from the standard, and watch for Warning in responses.
Regulation

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).

Texts cited

Entry checked on October 19, 2026.

Based on the STET PSD2 API 1.6.3 specification, licensed CC BY 3.0 FR.

The entry as stored
{
  "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"
}