psd2_swagger2.yaml

{
  "swagger": "2.0",
  "info": {
    "version": "0.0.1",
    "title": "OpenPSD PSD2",
    "description": "PSD2 API based on the Berlin Group specs\n"
  },
  "host": "api.openpsd.org",
  "basePath": "/psd2/v1",
  "schemes": [
    "https"
  ],
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "paths": {
    "/periodic-payments/{payment-product}": {
      "post": {
        "description": "Creates a payment initiation resource addressable under {paymentID} with all data relevant for the corresponding payment product. This is the first step in the API to initiate the related payment",
        "summary": "create a periodic payment",
        "tags": [
          "payments"
        ],
        "operationId": "PeriodicPaymentsByPaymentProductPost",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "payment-product",
            "in": "path",
            "required": true,
            "enum": [
              "sepa-credit-transfers",
              "instant-sepa-credit-transfers",
              "target-2-payments",
              "cross-border-credit-transfers"
            ],
            "x-enum-elements": [
              {
                "name": "sepacredittransfers",
                "description": ""
              },
              {
                "name": "instantsepacredittransfers",
                "description": ""
              },
              {
                "name": "target2payments",
                "description": ""
              },
              {
                "name": "crossbordercredittransfers",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The addressed payment product, e.g. SCT. The default list of products supported in this standard is, pain.001-sepa-credit-transfers, pain.001-instant-sepa-credit-transfers, pain.001-target-2-payments or pain.001-cross-border-credit-transfers. Further products might be published by the ASPSP within its XS2A documentation."
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "enum": [
              "application/json",
              "application/xml",
              "application/text"
            ],
            "x-enum-elements": [
              {
                "name": "Enum_applicationjson",
                "description": ""
              },
              {
                "name": "Enum_applicationxml",
                "description": ""
              },
              {
                "name": "Enum_applicationtext",
                "description": ""
              }
            ],
            "type": "string",
            "description": "Content-Type"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "PSU-IP-Address",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP."
          },
          {
            "name": "body",
            "in": "body",
            "required": true,
            "description": "",
            "schema": {
              "$ref": "#/definitions/PeriodicPaymentsRequest"
            }
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "TPP-Redirect-Preferred",
            "in": "header",
            "required": false,
            "type": "boolean",
            "description": "If it equals \"true\", the TPP prefers a redirect over an embedded SCA approach. If it equals \"false\", the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU."
          },
          {
            "name": "TPP-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Mandatory for the SCA OAuth Approach."
          },
          {
            "name": "TPP-Nok-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": ""
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/PeriodicPaymentsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/payments/{payment-product}": {
      "post": {
        "description": "Creates a payment initiation resource addressable under {paymentId} with all data relevant for the corresponding payment product. This is the first step in the API to initiate the related payment",
        "summary": "create a single payment",
        "tags": [
          "payments"
        ],
        "operationId": "PaymentsByPaymentProductPost",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "payment-product",
            "in": "path",
            "required": true,
            "enum": [
              "sepa-credit-transfers",
              "instant-sepa-credit-transfers",
              "target-2-payments",
              "cross-border-credit-transfers"
            ],
            "x-enum-elements": [
              {
                "name": "sepacredittransfers",
                "description": ""
              },
              {
                "name": "instantsepacredittransfers",
                "description": ""
              },
              {
                "name": "target2payments",
                "description": ""
              },
              {
                "name": "crossbordercredittransfers",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The addressed payment product, e.g. SCT. The default list of products supported in this standard is, pain.001-sepa-credit-transfers, pain.001-instant-sepa-credit-transfers, pain.001-target-2-payments or pain.001-cross-border-credit-transfers. Further products might be published by the ASPSP within its XS2A documentation."
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "enum": [
              "application/json",
              "application/xml",
              "application/text"
            ],
            "x-enum-elements": [
              {
                "name": "Enum_applicationjson",
                "description": ""
              },
              {
                "name": "Enum_applicationxml",
                "description": ""
              },
              {
                "name": "Enum_applicationtext",
                "description": ""
              }
            ],
            "type": "string",
            "description": "Content-Type"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "PSU-IP-Address",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP."
          },
          {
            "name": "body",
            "in": "body",
            "required": true,
            "description": "",
            "schema": {
              "type": "object"
            }
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "TPP-Redirect-Preferred",
            "in": "header",
            "required": false,
            "type": "boolean",
            "description": "If it equals \"true\", the TPP prefers a redirect over an embedded SCA approach. If it equals \"false\", the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU."
          },
          {
            "name": "TPP-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Mandatory for the SCA OAuth Approach."
          },
          {
            "name": "TPP-Nok-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": ""
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/PaymentsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/bulk-payments/{payment-product}": {
      "post": {
        "description": "Creates a payment initiation resource addressable under {paymentId} with all data relevant for the corresponding payment product. This is the first step in the API to initiate the related payment",
        "summary": "create a bulk payment",
        "tags": [
          "payments"
        ],
        "operationId": "BulkPaymentsByPaymentProductPost",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "payment-product",
            "in": "path",
            "required": true,
            "enum": [
              "sepa-credit-transfers",
              "instant-sepa-credit-transfers",
              "target-2-payments",
              "cross-border-credit-transfers"
            ],
            "x-enum-elements": [
              {
                "name": "sepacredittransfers",
                "description": ""
              },
              {
                "name": "instantsepacredittransfers",
                "description": ""
              },
              {
                "name": "target2payments",
                "description": ""
              },
              {
                "name": "crossbordercredittransfers",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The addressed payment product, e.g. SCT. The default list of products supported in this standard is, pain.001-sepa-credit-transfers, pain.001-instant-sepa-credit-transfers, pain.001-target-2-payments or pain.001-cross-border-credit-transfers. Further products might be published by the ASPSP within its XS2A documentation."
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "enum": [
              "application/json",
              "application/xml",
              "application/text"
            ],
            "x-enum-elements": [
              {
                "name": "Enum_applicationjson",
                "description": ""
              },
              {
                "name": "Enum_applicationxml",
                "description": ""
              },
              {
                "name": "Enum_applicationtext",
                "description": ""
              }
            ],
            "type": "string",
            "description": "Content-Type"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "PSU-IP-Address",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP."
          },
          {
            "name": "body",
            "in": "body",
            "required": true,
            "description": "",
            "schema": {
              "type": "object"
            }
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "TPP-Redirect-Preferred",
            "in": "header",
            "required": false,
            "type": "boolean",
            "description": "If it equals \"true\", the TPP prefers a redirect over an embedded SCA approach. If it equals \"false\", the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU."
          },
          {
            "name": "TPP-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Mandatory for the SCA OAuth Approach."
          },
          {
            "name": "TPP-Nok-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": ""
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/BulkPaymentsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/{payment-service}/{payment-product}/{paymentId}": {
      "get": {
        "description": "Reads the details of an initiated payment.",
        "summary": "get payment details",
        "tags": [
          "payments"
        ],
        "operationId": "PaymentIdByPaymentServiceAndPaymentProductGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "payment-service",
            "in": "path",
            "required": true,
            "enum": [
              "payments",
              "bulk-payments",
              "periodic-payments"
            ],
            "x-enum-elements": [
              {
                "name": "payments",
                "description": ""
              },
              {
                "name": "bulkpayments",
                "description": ""
              },
              {
                "name": "periodicpayments",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The payment service to use."
          },
          {
            "name": "payment-product",
            "in": "path",
            "required": true,
            "enum": [
              "sepa-credit-transfers",
              "instant-sepa-credit-transfers",
              "target-2-payments",
              "cross-border-credit-transfers"
            ],
            "x-enum-elements": [
              {
                "name": "sepacredittransfers",
                "description": ""
              },
              {
                "name": "instantsepacredittransfers",
                "description": ""
              },
              {
                "name": "target2payments",
                "description": ""
              },
              {
                "name": "crossbordercredittransfers",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The addressed payment product, e.g. SCT. The default list of products supported in this standard is, pain.001-sepa-credit-transfers, pain.001-instant-sepa-credit-transfers, pain.001-target-2-payments or pain.001-cross-border-credit-transfers. Further products might be published by the ASPSP within its XS2A documentation."
          },
          {
            "name": "paymentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "payment Id"
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "enum": [
              "application/json",
              "application/xml",
              "application/text"
            ],
            "x-enum-elements": [
              {
                "name": "Enum_applicationjson",
                "description": ""
              },
              {
                "name": "Enum_applicationxml",
                "description": ""
              },
              {
                "name": "Enum_applicationtext",
                "description": ""
              }
            ],
            "type": "string",
            "description": "Content-Type"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "PSU-IP-Address",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP."
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "TPP-Redirect-Preferred",
            "in": "header",
            "required": false,
            "type": "boolean",
            "description": "If it equals \"true\", the TPP prefers a redirect over an embedded SCA approach. If it equals \"false\", the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU."
          },
          {
            "name": "TPP-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Mandatory for the SCA OAuth Approach."
          },
          {
            "name": "TPP-Nok-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": ""
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "type": "object"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      },
      "put": {
        "description": "Updates data on the payment resource if needed. It may authorise a payment within the Embedded SCA Approach where needed.",
        "summary": "update payment",
        "tags": [
          "payments"
        ],
        "operationId": "PaymentIdByPaymentServiceAndPaymentProductPut",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "payment-service",
            "in": "path",
            "required": true,
            "enum": [
              "payments",
              "bulk-payments",
              "periodic-payments"
            ],
            "x-enum-elements": [
              {
                "name": "payments",
                "description": ""
              },
              {
                "name": "bulkpayments",
                "description": ""
              },
              {
                "name": "periodicpayments",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The payment service to use."
          },
          {
            "name": "payment-product",
            "in": "path",
            "required": true,
            "enum": [
              "sepa-credit-transfers",
              "instant-sepa-credit-transfers",
              "target-2-payments",
              "cross-border-credit-transfers"
            ],
            "x-enum-elements": [
              {
                "name": "sepacredittransfers",
                "description": ""
              },
              {
                "name": "instantsepacredittransfers",
                "description": ""
              },
              {
                "name": "target2payments",
                "description": ""
              },
              {
                "name": "crossbordercredittransfers",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The addressed payment product, e.g. SCT. The default list of products supported in this standard is, pain.001-sepa-credit-transfers, pain.001-instant-sepa-credit-transfers, pain.001-target-2-payments or pain.001-cross-border-credit-transfers. Further products might be published by the ASPSP within its XS2A documentation."
          },
          {
            "name": "paymentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "payment Id"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          },
          {
            "name": "body",
            "in": "body",
            "required": false,
            "description": "",
            "schema": {
              "$ref": "#/definitions/PaymentidRequest"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "OK result with Decoupled Approach",
            "schema": {
              "$ref": "#/definitions/PaymentidResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/{payment-service}/{payment-product}/{paymentId}/status": {
      "get": {
        "description": "Reads the transaction status of the payment",
        "summary": "get the status of a payment",
        "tags": [
          "payments"
        ],
        "operationId": "PaymentIdStatusByPaymentServiceAndPaymentProductGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "payment-service",
            "in": "path",
            "required": true,
            "enum": [
              "payments",
              "bulk-payments",
              "periodic-payments"
            ],
            "x-enum-elements": [
              {
                "name": "payments",
                "description": ""
              },
              {
                "name": "bulkpayments",
                "description": ""
              },
              {
                "name": "periodicpayments",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The payment service to use."
          },
          {
            "name": "payment-product",
            "in": "path",
            "required": true,
            "enum": [
              "sepa-credit-transfers",
              "instant-sepa-credit-transfers",
              "target-2-payments",
              "cross-border-credit-transfers"
            ],
            "x-enum-elements": [
              {
                "name": "sepacredittransfers",
                "description": ""
              },
              {
                "name": "instantsepacredittransfers",
                "description": ""
              },
              {
                "name": "target2payments",
                "description": ""
              },
              {
                "name": "crossbordercredittransfers",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The addressed payment product, e.g. SCT. The default list of products supported in this standard is, pain.001-sepa-credit-transfers, pain.001-instant-sepa-credit-transfers, pain.001-target-2-payments or pain.001-cross-border-credit-transfers. Further products might be published by the ASPSP within its XS2A documentation."
          },
          {
            "name": "paymentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "payment Id"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/PaymentidStatusResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/accounts/{account-id}/transactions": {
      "get": {
        "description": "Reads a transaction list For a given account, additional parameters are e.g. the attributes “date_from” and “date_to”. If the attribute “withbalance” is used, the ASPSP will add balances to the transaction list. The latter might be provided by the ASPSP anyhow, if transaction lists without balances are not supported.",
        "summary": "transactions for account",
        "tags": [
          "account"
        ],
        "operationId": "AccountsTransactionsByAccountIdGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "account-id",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "This identification is denoting the addressed account. The account-id is retrieved by using a \"Read Account List\" call. The account-id is the \"resourceId\" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent."
          },
          {
            "name": "bookingStatus",
            "in": "query",
            "required": true,
            "type": "string",
            "description": "Permitted codes are \"booked\", \"pending\" and \"both \"booked\" shall be supported by the ASPSP. To support the \"pending\" and \"both\" feature is optional for the ASPSP, Error code if not supported in the online banking frontend"
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          },
          {
            "name": "dateFrom",
            "in": "query",
            "required": false,
            "type": "string",
            "format": "date",
            "description": "Starting date (inclusive the date dateFrom) of the transaction list, mandated if no delta access is required"
          },
          {
            "name": "dateTo",
            "in": "query",
            "required": false,
            "type": "string",
            "format": "date",
            "description": "End date (inclusive the data dateTo) of the transaction list, default is now if not given."
          },
          {
            "name": "entryReferenceFrom",
            "in": "query",
            "required": false,
            "type": "string",
            "description": "This data attribute is indicating that the AISP is in favour to get all transactions after the transaction with identification entryReferenceFrom alternatively to the above defined period. This is a implementation of a delta access. If this data element is contained, the entries \"dateFrom\" and \"dateTo\" might be ignored by the ASPSP if a delta report is supported."
          },
          {
            "name": "deltaList",
            "in": "query",
            "required": false,
            "type": "boolean",
            "description": "This data attribute is indicating that the AISP is in favour to get all transactions after the last report access for this PSU on the addressed account. This is another implementation of a delta access-report. This delta indicator might be rejected by the ASPSP if this function is not supported."
          },
          {
            "name": "Accept",
            "in": "header",
            "required": false,
            "enum": [
              "xml",
              "JSON",
              "text"
            ],
            "x-enum-elements": [
              {
                "name": "xml",
                "description": ""
              },
              {
                "name": "JSON",
                "description": ""
              },
              {
                "name": "text",
                "description": ""
              }
            ],
            "type": "string",
            "description": "The TPP can indicate the formats of account reports supported together with a priorisation following the HTTP header definition."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/AccountsTransactionsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/consents": {
      "post": {
        "description": "Creates a consent resource, defining access rights to dedicated accounts of a given PSU-ID. These accounts must be addressed explicitly in the method as parameters.",
        "summary": "create a consent",
        "tags": [
          "Consent"
        ],
        "operationId": "ConsentsPost",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "TPP-Redirect-Preferred",
            "in": "header",
            "required": false,
            "type": "boolean",
            "description": "If it equals \"true\", the TPP prefers a redirect over an embedded SCA approach. If it equals \"false\", the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU."
          },
          {
            "name": "TPP-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Mandatory for the SCA OAuth Approach."
          },
          {
            "name": "TPP-Nok-Redirect-URI",
            "in": "header",
            "required": false,
            "type": "string",
            "description": ""
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          },
          {
            "name": "body",
            "in": "body",
            "required": false,
            "description": "",
            "schema": {
              "$ref": "#/definitions/ConsentsRequest"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Consent Request was correctly performed.",
            "schema": {
              "$ref": "#/definitions/ConsentsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/consents/{consentId}": {
      "get": {
        "description": "Reads the exact definition of the given consent resource {consentId}",
        "summary": "get consent details",
        "tags": [
          "Consent"
        ],
        "operationId": "ConsentsByConsentIdGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "consentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "ID of the corresponding consent object as returned by an Account Information Consent Request"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ConsentsResponse125"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      },
      "put": {
        "description": "Updates data on the consent resource, authorises a consent within the Embedded SCA Approach where needed.",
        "summary": "update consent",
        "tags": [
          "Consent"
        ],
        "operationId": "ConsentsByConsentIdPut",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "consentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "ID of the corresponding consent object as returned by an Account Information Consent Request"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "PSU-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation, if OAuth is not chosen as Pre-Step."
          },
          {
            "name": "PSU-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility."
          },
          {
            "name": "PSU-Corporate-ID",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSP's documentation. Only used in a corporate context."
          },
          {
            "name": "PSU-Corporate-ID-Type",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Might be mandated in the ASPSPs documentation. Only used in a corporate context."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          },
          {
            "name": "body",
            "in": "body",
            "required": false,
            "description": "",
            "schema": {
              "$ref": "#/definitions/ConsentsRequest144"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ConsentsResponse146"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      },
      "delete": {
        "description": "Deletes a created consent with ID.",
        "summary": "delete consent",
        "tags": [
          "Consent"
        ],
        "operationId": "ConsentsByConsentIdDelete",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "consentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "ID of the corresponding consent object as returned by an Account Information Consent Request"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          }
        ],
        "responses": {
          "204": {
            "description": "Consent resource was successfully deleted."
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/accounts/{account-id}": {
      "get": {
        "description": "Reads a list of bank accounts, with balances where required. It is assumed that a consent of the PSU to this access is already given and stored on the ASPSP system. The addressed list of accounts depends then on the PSU ID and the stored consent addressed by consentId, respectively the OAuth2 access token.",
        "summary": "account details",
        "tags": [
          "account"
        ],
        "operationId": "AccountsByAccountIdGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "account-id",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "This identification is denoting the addressed account. The account-id is retrieved by using a \"Read Account List\" call. The account-id is the \"resourceId\" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent."
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "withBalance",
            "in": "query",
            "required": false,
            "type": "boolean",
            "description": "If contained, this function reads the list of accessible payment accounts including the booking balance, if granted by the PSU in the related consent and available by the ASPSP. This parameter might be ignored by the ASPSP."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/AccountsResponse18"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/accounts/{account-id}/balances": {
      "get": {
        "description": "Reads the balance list for a given account.",
        "summary": "balances for account",
        "tags": [
          "account"
        ],
        "operationId": "AccountsBalancesByAccountIdGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "account-id",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "This identification is denoting the addressed account. The account-id is retrieved by using a \"Read Account List\" call. The account-id is the \"resourceId\" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent."
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/AccountsBalancesResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/accounts/{account-id}/transactions/{resourceId}": {
      "get": {
        "description": "Reads transaction details of an addressed transaction.",
        "summary": "transaction details for transaction of an account",
        "tags": [
          "account"
        ],
        "operationId": "AccountsTransactionsByAccountIdAndResourceIdGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "type": "string",
            "maxLength": 35,
            "description": "This identification is given by the attribute resourceId of the corresponding entry of a transaction list."
          },
          {
            "name": "account-id",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "This identification is denoting the addressed account. The account-id is retrieved by using a \"Read Account List\" call. The account-id is the \"resourceId\" attribute of the account structure. Its value is constant at least throughout the lifecycle of a given consent."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/AccountsTransactionsResponse81"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "security": [],
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/accounts": {
      "get": {
        "description": "Reads a list of bank accounts, with balances where required. It is assumed that a consent of the PSU to this access is already given and stored on the ASPSP system. The addressed list of accounts depends then on the PSU ID and the stored consent addressed by consentId, respectively the OAuth2 access token.",
        "summary": "list of accounts",
        "tags": [
          "account"
        ],
        "operationId": "AccountsGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Consent-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "description": "Shall be contained since \"Establish Consent Transaction\" was performed via this API before."
          },
          {
            "name": "withBalance",
            "in": "query",
            "required": false,
            "type": "boolean",
            "description": "If contained, this function reads the list of accessible payment accounts including the booking balance, if granted by the PSU in the related consent and available by the ASPSP. This parameter might be ignored by the ASPSP."
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained only, if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in the related consent authorisation."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/AccountsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/funds-confirmations": {
      "post": {
        "description": "Checks whether funds are available for a payment transaction on an account linked with a given tuple cardissuer/cardnumber, or an IBAN and TPP respectively",
        "summary": "check funds",
        "tags": [
          "Funds"
        ],
        "operationId": "FundsConfirmationsPost",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          },
          {
            "name": "body",
            "in": "body",
            "required": false,
            "description": "",
            "schema": {
              "$ref": "#/definitions/FundsConfirmationsRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/FundsConfirmationsResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    },
    "/consents/{consentId}/status": {
      "get": {
        "description": "Reads the transaction status of the addressed consent resource.",
        "summary": "get status of a consent",
        "tags": [
          "Consent"
        ],
        "operationId": "ConsentsStatusByConsentIdGet",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "consentId",
            "in": "path",
            "required": true,
            "type": "string",
            "description": "ID of the corresponding consent object as returned by an Account Information Consent Request"
          },
          {
            "name": "X-Request-ID",
            "in": "header",
            "required": true,
            "type": "string",
            "format": "uuid",
            "description": "ID of the request, unique to the call, as determined by the initiating party."
          },
          {
            "name": "Digest",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request."
          },
          {
            "name": "Signature",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP."
          },
          {
            "name": "TPP-Signature-Certificate",
            "in": "header",
            "required": false,
            "type": "string",
            "description": "The certificate used for signing the request, in base64 encoding. It shall be contained if a signature is used, see above."
          }
        ],
        "responses": {
          "200": {
            "description": "Transaction status",
            "schema": {
              "$ref": "#/definitions/ConsentsStatusResponse"
            },
            "examples": {}
          },
          "400": {
            "description": "Bad Request",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "401": {
            "description": "Unauthorized",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "403": {
            "description": "Forbidden",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          },
          "default": {
            "description": "Internal Server Error",
            "schema": {
              "$ref": "#/definitions/TppMessage"
            }
          }
        },
        "x-unitTests": [],
        "x-operation-settings": {
          "CollectParameters": false,
          "AllowDynamicQueryParameters": false,
          "AllowDynamicFormParameters": false,
          "IsMultiContentStreaming": false
        }
      }
    }
  },
  "definitions": {
    "FundsConfirmationsResponse": {
      "title": "Funds Confirmations Response",
      "type": "object",
      "properties": {
        "fundsAvaiable": {
          "description": "Equals “true” if sufficient funds are available at the time of the request, “false” otherwise.",
          "type": "boolean"
        }
      },
      "required": [
        "fundsAvaiable"
      ]
    },
    "PSUData": {
      "title": "PSUData",
      "type": "object",
      "properties": {
        "password": {
          "description": "",
          "example": "very42secret%",
          "type": "string"
        }
      }
    },
    "OtpFormat": {
      "title": "OtpFormat",
      "example": "characters",
      "x-enum-elements": [
        {
          "name": "characters",
          "description": ""
        },
        {
          "name": "integer",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "characters",
        "integer"
      ]
    },
    "AvailableAccounts": {
      "title": "AvailableAccounts",
      "example": "allAccounts",
      "x-enum-elements": [
        {
          "name": "allAccounts",
          "description": ""
        },
        {
          "name": "allAccountsWithBalances",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "allAccounts",
        "allAccountsWithBalances"
      ]
    },
    "AccountsTransactionsResponse81": {
      "title": "Accounts Transactions Response81",
      "type": "object",
      "properties": {
        "transactionsDetails": {
          "$ref": "#/definitions/Transaction"
        }
      }
    },
    "AccountsResponse18": {
      "title": "Accounts Response18",
      "type": "object",
      "properties": {
        "account": {
          "$ref": "#/definitions/AccountDetails"
        }
      },
      "required": [
        "account"
      ]
    },
    "Category": {
      "title": "Category",
      "example": "WARNING",
      "x-enum-elements": [
        {
          "name": "WARNING",
          "description": ""
        },
        {
          "name": "ERROR",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "WARNING",
        "ERROR"
      ]
    },
    "AccountsResponse": {
      "title": "Accounts Response",
      "type": "object",
      "properties": {
        "accounts": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AccountDetails"
          }
        }
      },
      "required": [
        "accounts"
      ]
    },
    "Protocol": {
      "title": "protocol",
      "example": "http",
      "x-enum-elements": [
        {
          "name": "http",
          "description": ""
        },
        {
          "name": "https",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "http",
        "https"
      ]
    },
    "Links": {
      "title": "Links",
      "type": "object",
      "properties": {
        "scaRedirect": {
          "description": "A link to an ASPSP site where SCA is performed within the Redirect SCA approach.",
          "type": "string"
        },
        "scaOAuth": {
          "description": "The link refers to a JSON document specifying the OAuth details of the ASPSP’s authorisation server. JSON document follows the definition given in https://tools.ietf.org/html/draft-ietf-oauth- discovery.",
          "type": "string"
        },
        "updatePsuIdentification": {
          "description": "The link to the payment initiation or account information resource, which needs to be updated by the psu identification if not delivered yet.",
          "type": "string"
        },
        "updateProprietaryData": {
          "description": "The link to the payment initiation or account information resource, which needs to be updated by the proprietary data.",
          "type": "string"
        },
        "updatePsuAuthentication": {
          "description": "The link to the payment initiation or account information resource, which needs to be updated by a psu password and eventually the psu identification if not delivered yet.",
          "type": "string"
        },
        "selectAuthenticationMethod": {
          "description": "This is a link to a resource, where the TPP can select the applicable second factor authentication methods for the PSU, if there were several available authentication methods.",
          "type": "string"
        },
        "authoriseTransaction": {
          "description": "The link to the payment initiation or consent resource, where the “Transaction Authorization”Request“ is sent to. This is the link to the resource which will authorize the payment or the consent by checking the SCA authentication data within the Embedded SCA approach.",
          "type": "string"
        },
        "self": {
          "description": "The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation.",
          "type": "string"
        },
        "status": {
          "description": "Status of the resource.",
          "type": "string"
        },
        "account": {
          "description": "A link to the resource providing the details of one account",
          "type": "string"
        },
        "balances": {
          "description": "A link to the resource providing the balance of a dedicated account.",
          "type": "string"
        },
        "transactions": {
          "description": "A link to the resource providing the transaction history of a dediated amount.",
          "type": "string"
        },
        "transactionsDetails": {
          "description": "A link to the resource providing details of a dedicated transaction.",
          "type": "string"
        },
        "first": {
          "description": "Navigation link for paginated account reports.",
          "type": "string"
        },
        "next": {
          "description": "Navigation link for paginated account reports.",
          "type": "string"
        },
        "previous": {
          "description": "Navigation link for paginated account reports.",
          "type": "string"
        },
        "last": {
          "description": "Navigation link for paginated account reports.",
          "type": "string"
        },
        "download": {
          "description": "Download link for huge AIS data packages.",
          "type": "string"
        }
      }
    },
    "Transaction": {
      "title": "Transaction",
      "type": "object",
      "properties": {
        "transactionAmount": {
          "$ref": "#/definitions/Amount"
        },
        "transactionId": {
          "description": "Can be used as access-id in the API, where more details on an transaction is offered.",
          "type": "string"
        },
        "entryReference": {
          "description": "Is the identification of the transaction as used e.g. for reference for deltafunction on application level. The same identification as for example used within camt.05x messages",
          "type": "string",
          "maxLength": 35
        },
        "endToEndId": {
          "description": "Unique end to end identity.",
          "type": "string",
          "maxLength": 35
        },
        "mandateId": {
          "description": "Identification of a Cheque.",
          "example": "Mandate-2018-04-20-1234",
          "type": "string",
          "maxLength": 35
        },
        "creditorId": {
          "description": "Identification of Creditors, e.g. a SEPA Creditor ID",
          "type": "string",
          "maxLength": 35
        },
        "bookingDate": {
          "description": "The Date when an entry is posted to an account on the ASPSPs books.",
          "example": "2017-10-30",
          "type": "string",
          "format": "date"
        },
        "valueDate": {
          "description": "The Date at which assets become available to the account owner in case of a credit",
          "example": "2017-10-30",
          "type": "string",
          "format": "date"
        },
        "exchangeRates": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/ExchangeRate"
          }
        },
        "creditorName": {
          "description": "Identification of Creditors, e.g. a SEPA Creditor ID",
          "type": "string",
          "maxLength": 70
        },
        "creditorAccount": {
          "$ref": "#/definitions/AccountReference"
        },
        "ultimateCreditor": {
          "description": "",
          "type": "string",
          "maxLength": 70
        },
        "debtorName": {
          "description": "Name of the debtor if a \"Credited\" transaction",
          "type": "string",
          "maxLength": 70
        },
        "debtorAccount": {
          "$ref": "#/definitions/AccountReference"
        },
        "ultimateDebtor": {
          "description": "",
          "type": "string",
          "maxLength": 70
        },
        "remittanceInformationStructured": {
          "description": "Reference to be transported in the field.",
          "type": "string",
          "maxLength": 140
        },
        "puposeCode": {
          "description": "",
          "type": "string"
        },
        "bankTransactionCode": {
          "description": "Bank transaction code as used by the ASPSP and using the sub elements of this structured code defined by ISO20022",
          "type": "string"
        },
        "proprietaryBankTransactionCode": {
          "description": "proprietary bank transaction code as used within a community or within an ASPSP e.g. for MT94x based transaction reports",
          "example": "PMNT-RCVD-ESDD",
          "type": "string",
          "maxLength": 35
        },
        "_links": {
          "description": "The following links could be used here: transactionDetails for retrieving details of a transaction.",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        }
      },
      "required": [
        "transactionAmount"
      ]
    },
    "AccountDetails": {
      "title": "AccountDetails",
      "type": "object",
      "properties": {
        "currency": {
          "description": "ISO 4217 Alpha 3 currency code",
          "example": "EUR",
          "type": "string",
          "maxLength": 3
        },
        "resourceid": {
          "description": "This is the data element to be used in the path when retrieving data from a dedicated account.",
          "type": "string",
          "maxLength": 35
        },
        "iban": {
          "description": "This data element can be used in the body of the Consent Request Message for retrieving account access consent from this payment account.",
          "example": "DE89370400440532013000",
          "type": "string"
        },
        "bban": {
          "description": "This data element can be used in the body of the Consent Request Message for retrieving account access consent from this account. This data elements is used for payment accounts which have no IBAN.",
          "type": "string"
        },
        "pan": {
          "description": "Primary Account Number (PAN) of a card, can be tokenized by the ASPSP due to PCI DSS requirements. This data element can be used in the body of the Consent Request Message for retrieving account access consent from this card.",
          "type": "string",
          "maxLength": 35
        },
        "maskedPan": {
          "description": "Primary Account Number (PAN) of a card, can be tokenized by the ASPSP due to PCI DSS requirements. This data element can be used in the body of the Consent Request Message for retrieving account access consent from this card.",
          "type": "string",
          "maxLength": 35
        },
        "msisdn": {
          "description": "An alias to access a payment account via a registered mobile phone number. This alias might be needed e.g. in the payment initiation service. The support of this alias must be explicitly documented by the ASPSP for the corresponding API Calls.",
          "type": "string",
          "maxLength": 35
        },
        "name": {
          "description": "Name given by the bank or the PSU in OnlineBanking.",
          "type": "string",
          "maxLength": 35
        },
        "product": {
          "description": "Product Name of the Bank for this account, proprietary definition",
          "type": "string",
          "maxLength": 35
        },
        "cashAccountType": {
          "description": "ExternalCashAccountType1Code from ISO 20022",
          "type": "string"
        },
        "bic": {
          "description": "The BIC associated to the account.",
          "type": "string"
        },
        "linkedAccounts": {
          "description": "Case of a set of pending card transactions, the APSP will provide the relevant cash account the card is set up on.",
          "type": "string",
          "maxLength": 70
        },
        "usage": {
          "description": "Specifies the usage of the account - PRIV: private personal account - ORGA: professional account",
          "example": "PRIV",
          "type": "string",
          "maxLength": 140
        },
        "details": {
          "description": "Specifications that might be provided by the ASPSP - characteristics of the account - characteristics of the relevant card",
          "type": "string",
          "maxLength": 140
        },
        "balances": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Balance"
          }
        },
        "_links": {
          "description": "Links to the account, which can be directly used for retrieving account information from this dedicated account. Links to “balances” and/or “transactions”",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        }
      },
      "required": [
        "currency"
      ]
    },
    "MessageCode": {
      "title": "MessageCode",
      "example": "CERTIFICATE_INVALID",
      "x-enum-elements": [
        {
          "name": "CERTIFICATE_INVALID",
          "description": ""
        },
        {
          "name": "CERTIFICATE_EXPIRED",
          "description": ""
        },
        {
          "name": "CERTIFICATE_BLOCKED",
          "description": ""
        },
        {
          "name": "CERTIFICATE_REVOKED",
          "description": ""
        },
        {
          "name": "CERTIFICATE_MISSING",
          "description": ""
        },
        {
          "name": "SIGNATURE_INVALID",
          "description": ""
        },
        {
          "name": "SIGNATURE_MISSING",
          "description": ""
        },
        {
          "name": "FORMAT_ERROR",
          "description": ""
        },
        {
          "name": "PARAMETER_NOT_SUPPORTED",
          "description": ""
        },
        {
          "name": "PSU_CREDENTIALS_INVALID",
          "description": ""
        },
        {
          "name": "SERVICE_INVALID",
          "description": ""
        },
        {
          "name": "SERVICE_BLOCKED",
          "description": ""
        },
        {
          "name": "CORPORATE_ID_INVALID",
          "description": ""
        },
        {
          "name": "CONSENT_UNKNOWN",
          "description": ""
        },
        {
          "name": "CONSENT_INVALID",
          "description": ""
        },
        {
          "name": "CONSENT_EXPIRED",
          "description": ""
        },
        {
          "name": "TOKEN_UNKNOWN",
          "description": ""
        },
        {
          "name": "TOKEN_INVALID",
          "description": ""
        },
        {
          "name": "TOKEN_EXPIRED",
          "description": ""
        },
        {
          "name": "RESOURCE_UNKNOWN",
          "description": ""
        },
        {
          "name": "RESOURCE_EXPIRED",
          "description": ""
        },
        {
          "name": "TIMESTAMP_INVALID",
          "description": ""
        },
        {
          "name": "PERIOD_INVALID",
          "description": ""
        },
        {
          "name": "SCA_METHOD_UNKNOWN",
          "description": ""
        },
        {
          "name": "PRODUCT_INVALID",
          "description": ""
        },
        {
          "name": "PRODUCT_UNKNOWN",
          "description": ""
        },
        {
          "name": "PAYMENT_FAILED",
          "description": ""
        },
        {
          "name": "REQUIRED_KID_MISSING",
          "description": ""
        },
        {
          "name": "EXECUTION_DATE_INVALID",
          "description": ""
        },
        {
          "name": "SESSIONS_NOT_SUPPORTED",
          "description": ""
        },
        {
          "name": "ACCESS_EXCEEDED",
          "description": ""
        },
        {
          "name": "REQUESTED_FORMATS_INVALID",
          "description": ""
        },
        {
          "name": "CARD_INVALID",
          "description": ""
        },
        {
          "name": "NO_PIIS_ACTIVATION",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "CERTIFICATE_INVALID",
        "CERTIFICATE_EXPIRED",
        "CERTIFICATE_BLOCKED",
        "CERTIFICATE_REVOKED",
        "CERTIFICATE_MISSING",
        "SIGNATURE_INVALID",
        "SIGNATURE_MISSING",
        "FORMAT_ERROR",
        "PARAMETER_NOT_SUPPORTED",
        "PSU_CREDENTIALS_INVALID",
        "SERVICE_INVALID",
        "SERVICE_BLOCKED",
        "CORPORATE_ID_INVALID",
        "CONSENT_UNKNOWN",
        "CONSENT_INVALID",
        "CONSENT_EXPIRED",
        "TOKEN_UNKNOWN",
        "TOKEN_INVALID",
        "TOKEN_EXPIRED",
        "RESOURCE_UNKNOWN",
        "RESOURCE_EXPIRED",
        "TIMESTAMP_INVALID",
        "PERIOD_INVALID",
        "SCA_METHOD_UNKNOWN",
        "PRODUCT_INVALID",
        "PRODUCT_UNKNOWN",
        "PAYMENT_FAILED",
        "REQUIRED_KID_MISSING",
        "EXECUTION_DATE_INVALID",
        "SESSIONS_NOT_SUPPORTED",
        "ACCESS_EXCEEDED",
        "REQUESTED_FORMATS_INVALID",
        "CARD_INVALID",
        "NO_PIIS_ACTIVATION"
      ]
    },
    "PeriodicPaymentsResponse": {
      "title": "Periodic Payments Response",
      "type": "object",
      "properties": {
        "transactionStatus": {
          "$ref": "#/definitions/TransactionStatus"
        },
        "paymentId": {
          "description": "resource identification of the generated payment initiation resource.",
          "type": "string"
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "transactionFees": {
          "$ref": "#/definitions/Amount"
        },
        "transactionFeeIndicator": {
          "description": "",
          "type": "boolean"
        },
        "scaMethods": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Authentication"
          }
        },
        "chosenScaMethod": {
          "$ref": "#/definitions/Authentication"
        },
        "challengeData": {
          "$ref": "#/definitions/Challenge"
        },
        "psuMessage": {
          "description": "Text to be displayed to the PSU",
          "type": "string"
        },
        "tppMessages": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/TppMessage261"
          }
        }
      },
      "required": [
        "transactionStatus",
        "paymentId",
        "_links"
      ]
    },
    "Frequency": {
      "title": "frequency",
      "example": "Daily",
      "x-enum-elements": [
        {
          "name": "Daily",
          "description": ""
        },
        {
          "name": "Weekly",
          "description": ""
        },
        {
          "name": "EveryTwoWeeks",
          "description": ""
        },
        {
          "name": "Monthly",
          "description": ""
        },
        {
          "name": "EveryTwoMonths",
          "description": ""
        },
        {
          "name": "Quarterly",
          "description": ""
        },
        {
          "name": "SemiAnnual",
          "description": ""
        },
        {
          "name": "Annual",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "Daily",
        "Weekly",
        "EveryTwoWeeks",
        "Monthly",
        "EveryTwoMonths",
        "Quarterly",
        "SemiAnnual",
        "Annual"
      ]
    },
    "BulkPaymentsResponse": {
      "title": "Bulk Payments Response",
      "type": "object",
      "properties": {
        "transactionStatus": {
          "$ref": "#/definitions/TransactionStatus"
        },
        "paymentId": {
          "description": "resource identification of the generated payment initiation resource.",
          "type": "string"
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "transactionFees": {
          "$ref": "#/definitions/Amount"
        },
        "transactionFeeIndicator": {
          "description": "",
          "type": "boolean"
        },
        "scaMethods": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Authentication"
          }
        },
        "chosenScaMethod": {
          "$ref": "#/definitions/Authentication"
        },
        "challengeData": {
          "$ref": "#/definitions/Challenge"
        },
        "psuMessage": {
          "description": "Text to be displayed to the PSU",
          "type": "string"
        },
        "tppMessages": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/TppMessage261"
          }
        }
      },
      "required": [
        "transactionStatus",
        "paymentId",
        "_links"
      ]
    },
    "PaymentsResponse": {
      "title": "Payments Response",
      "type": "object",
      "properties": {
        "transactionStatus": {
          "$ref": "#/definitions/TransactionStatus"
        },
        "paymentId": {
          "description": "resource identification of the generated payment initiation resource.",
          "type": "string"
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "transactionFees": {
          "$ref": "#/definitions/Amount"
        },
        "transactionFeeIndicator": {
          "description": "",
          "type": "boolean"
        },
        "scaMethods": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Authentication"
          }
        },
        "chosenScaMethod": {
          "$ref": "#/definitions/Authentication"
        },
        "challengeData": {
          "$ref": "#/definitions/Challenge"
        },
        "psuMessage": {
          "description": "Text to be displayed to the PSU",
          "type": "string"
        },
        "tppMessages": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/TppMessage261"
          }
        }
      },
      "required": [
        "transactionStatus",
        "paymentId",
        "_links"
      ]
    },
    "PaymentidResponse": {
      "title": "PaymentId Response",
      "type": "object",
      "properties": {
        "transactionStatus": {
          "$ref": "#/definitions/TransactionStatus"
        },
        "chosenScaMethod": {
          "$ref": "#/definitions/Authentication"
        },
        "challengeData": {
          "$ref": "#/definitions/Challenge"
        },
        "scaMethods": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Authentication"
          }
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "consentStatus": {
          "$ref": "#/definitions/ConsentStatus"
        },
        "psuMessage": {
          "description": "Text to be displayed to the PSU",
          "type": "string"
        }
      },
      "required": [
        "transactionStatus"
      ]
    },
    "TransactionStatus": {
      "title": "TransactionStatus",
      "example": "ACCP",
      "x-enum-elements": [
        {
          "name": "ACCP",
          "description": ""
        },
        {
          "name": "ACSC",
          "description": ""
        },
        {
          "name": "ACSP",
          "description": ""
        },
        {
          "name": "ACTC",
          "description": ""
        },
        {
          "name": "ACWC",
          "description": ""
        },
        {
          "name": "ACWP",
          "description": ""
        },
        {
          "name": "RCVD",
          "description": ""
        },
        {
          "name": "PDNG",
          "description": ""
        },
        {
          "name": "RJCT",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "ACCP",
        "ACSC",
        "ACSP",
        "ACTC",
        "ACWC",
        "ACWP",
        "RCVD",
        "PDNG",
        "RJCT"
      ]
    },
    "ConsentsResponse146": {
      "title": "Consents Response146",
      "type": "object",
      "properties": {
        "chosenScaMethod": {
          "$ref": "#/definitions/Authentication"
        },
        "challengeData": {
          "$ref": "#/definitions/Challenge"
        },
        "scaMethods": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Authentication"
          }
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "transactionStatus": {
          "$ref": "#/definitions/TransactionStatus"
        },
        "consentStatus": {
          "$ref": "#/definitions/ConsentStatus"
        },
        "psuMessage": {
          "description": "Text to be displayed to the PSU",
          "type": "string"
        }
      }
    },
    "ConsentsResponse125": {
      "title": "Consents Response125",
      "type": "object",
      "properties": {
        "access": {
          "$ref": "#/definitions/AccountAccess"
        },
        "recurringIndicator": {
          "description": "\"true\" if the consent is for recurring access to the account data \"false\", if the consent is for one access to the account data",
          "type": "boolean"
        },
        "validUntil": {
          "description": "",
          "type": "string",
          "format": "date"
        },
        "frequencyPerDay": {
          "description": "",
          "type": "integer",
          "format": "int32"
        },
        "lastActionDate": {
          "description": "",
          "type": "string",
          "format": "date"
        },
        "consentStatus": {
          "$ref": "#/definitions/ConsentStatus"
        },
        "scaStatus": {
          "description": "This data element is containing information about the status of the SCA method applied. This is free text but might be coded in a future version of the specification.",
          "type": "string"
        }
      },
      "required": [
        "access",
        "recurringIndicator",
        "validUntil",
        "frequencyPerDay",
        "lastActionDate",
        "consentStatus"
      ]
    },
    "Challenge": {
      "title": "Challenge",
      "type": "object",
      "properties": {
        "image": {
          "description": "PNG data (max. 512 kilobyte) to be displayed to the PSU, Base64 encoding. This attribute is used only, when PHOTO_OTP or CHIP_OTP is the selected SCA method.",
          "type": "string"
        },
        "data": {
          "description": "String challenge data",
          "type": "string"
        },
        "imageLink": {
          "description": "A link where the ASPSP will provides the challenge image for the TPP.",
          "type": "string"
        },
        "otpMaxLength": {
          "description": "The maximal length for the OTP to be typed in by the PSU.",
          "type": "integer",
          "format": "int32"
        },
        "otpFormat": {
          "$ref": "#/definitions/OtpFormat"
        },
        "additionalInformation": {
          "description": "Additional explanation for the PSU to explain e.g. fallback mechanism for the chosen sca method",
          "type": "string"
        }
      }
    },
    "Authentication": {
      "title": "Authentication",
      "type": "object",
      "properties": {
        "authenticationType": {
          "$ref": "#/definitions/AuthenticationType"
        },
        "authenticationMethodId": {
          "description": "An identification provided by the ASPSP for the later identification of the authentication method selection.",
          "type": "string",
          "maxLength": 35
        },
        "authenticationVersion": {
          "description": "Depending on the \"authenticationType\". This version can be used by differentiating authentication tools used within performing OTP generation in the same authentication type. This version can be referred to in the ASPSP’s documentation.",
          "type": "string"
        },
        "name": {
          "description": "This is the name of the authentication method defined by the PSU in the Online Banking frontend of the ASPSP. Alternatively this could be a description provided by the ASPSP like “SMS OTP on phone +49160 xxxxx 28”. This name shall be used by the TPP when presenting a list of authentication methods to the PSU, if available.",
          "type": "string"
        },
        "explanation": {
          "description": "detailed information about the sca method for the PSU.",
          "type": "string"
        }
      },
      "required": [
        "authenticationType",
        "authenticationMethodId"
      ]
    },
    "ConsentStatus": {
      "title": "ConsentStatus",
      "example": "received",
      "x-enum-elements": [
        {
          "name": "received",
          "description": ""
        },
        {
          "name": "rejected",
          "description": ""
        },
        {
          "name": "valid",
          "description": ""
        },
        {
          "name": "revokedByPsu",
          "description": ""
        },
        {
          "name": "expired",
          "description": ""
        },
        {
          "name": "terminatedByTpp",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "received",
        "rejected",
        "valid",
        "revokedByPsu",
        "expired",
        "terminatedByTpp"
      ]
    },
    "ConsentsResponse": {
      "title": "Consents Response",
      "type": "object",
      "properties": {
        "consentStatus": {
          "$ref": "#/definitions/ConsentStatus"
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "consentId": {
          "description": "Identification of the consent resource as it is used in the API structure. Shall be contained, if a consent resource was generated.",
          "example": "qwer3456tzui7890",
          "type": "string"
        },
        "scaMethods": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Authentication"
          }
        },
        "chosenSca Method": {
          "$ref": "#/definitions/Authentication"
        },
        "challengeData": {
          "$ref": "#/definitions/Challenge"
        },
        "psuMessage": {
          "description": "Text to be displayed to the PSU",
          "type": "string"
        }
      },
      "required": [
        "consentStatus",
        "_links"
      ]
    },
    "AccountAccess": {
      "title": "AccountAccess",
      "type": "object",
      "properties": {
        "accounts": {
          "description": "Is asking for detailed account information. If the array is empty, the TPP is asking for an accessible account list. This may be restricted in a PSU/ASPSP authorization dialogue.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AccountReference"
          }
        },
        "balances": {
          "description": "Is asking for balances of the addressed accounts. If the array is empty, the TPP is asking for the balances of all accessible account lists. This may be restricted in a PSU/ASPSP authorization dialogue",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AccountReference"
          }
        },
        "transactions": {
          "description": "Is asking for transactions of the addressed accounts. If the array is empty, the TPP is asking for the transactions of all accessible account lists. This may be restricted in a PSU/ASPSP authorization dialogue",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AccountReference"
          }
        },
        "availableAccounts": {
          "$ref": "#/definitions/AvailableAccounts"
        },
        "allPsd2": {
          "description": "Optional if supported by API provide. Only the value \"allAccounts\" is admitted.",
          "example": "allAccounts",
          "type": "string",
          "default": "allAccounts"
        }
      }
    },
    "ConsentsRequest": {
      "title": "consentsRequest",
      "type": "object",
      "properties": {
        "access": {
          "$ref": "#/definitions/AccountAccess"
        },
        "recurringIndicator": {
          "description": "\"true\" if the consent is for recurring access to the account data \"false\", if the consent is for one access to the account data",
          "type": "boolean"
        },
        "validUntil": {
          "description": "This parameter is requesting a valid until date for the requested consent. The content is the local ASPSP date in ISODate Format, e.g. 2017-10-30. If a maximal available date is requested, a date in far future is to be used: \"9999-12-31\". The consent object to be retrieved by the GET Consent Request will contain the adjusted date.",
          "example": "2017-10-30",
          "type": "string",
          "format": "date"
        },
        "frequencyPerDay": {
          "description": "This field indicates the requested maximum frequency for an access per day. For a one-off access, this attribute is set to \"1\".",
          "example": 1,
          "type": "integer",
          "format": "int32"
        },
        "combinedServiceIndicator": {
          "description": "If \"true\" indicates that a payment initiation service will be addressed in the same \"session\", cp. Section 8.",
          "type": "boolean"
        }
      },
      "required": [
        "access",
        "recurringIndicator",
        "validUntil",
        "frequencyPerDay",
        "combinedServiceIndicator"
      ]
    },
    "ExchangeRate": {
      "title": "ExchangeRate",
      "type": "object",
      "properties": {
        "currencyFrom": {
          "description": "ISO 4217 Alpha 3 currency code",
          "example": "EUR",
          "type": "string",
          "maxLength": 3
        },
        "rateFrom": {
          "description": "",
          "type": "string"
        },
        "currencyTo": {
          "description": "ISO 4217 Alpha 3 currency code",
          "example": "EUR",
          "type": "string",
          "maxLength": 3
        },
        "rateTo": {
          "description": "",
          "type": "string"
        },
        "rateDate": {
          "description": "",
          "example": "2017-10-30",
          "type": "string",
          "format": "date"
        },
        "rateContract": {
          "description": "",
          "type": "string"
        }
      },
      "required": [
        "currencyFrom",
        "rateFrom",
        "currencyTo",
        "rateTo",
        "rateDate"
      ]
    },
    "AccountReference": {
      "title": "AccountReference",
      "type": "object",
      "properties": {
        "iban": {
          "description": "This data element can be used in the body of the Consent Request Message for retrieving account access consent from this payment account.",
          "type": "string",
          "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{1-30}$"
        },
        "bban": {
          "description": "This data element can be used in the body of the Consent Request Message for retrieving account access consent from this account. This data elements is used for payment accounts which have no IBAN.",
          "type": "string"
        },
        "pan": {
          "description": "Primary Account Number (PAN) of a card, can be tokenized by the ASPSP due to PCI DSS requirements. This data element can be used in the body of the Consent Request Message for retrieving account access consent from this card.",
          "type": "string",
          "maxLength": 35
        },
        "maskedPan": {
          "description": "Primary Account Number (PAN) of a card, can be tokenized by the ASPSP due to PCI DSS requirements. This data element can be used in the body of the Consent Request Message for retrieving account access consent from this card.",
          "type": "string",
          "maxLength": 35
        },
        "msisdn": {
          "description": "An alias to access a payment account via a registered mobile phone number. This alias might be needed e.g. in the payment initiation service. The support of this alias must be explicitly documented by the ASPSP for the corresponding API Calls.",
          "type": "string",
          "maxLength": 35
        },
        "currency": {
          "description": "ISO 4217 Alpha 3 currency code",
          "example": "EUR",
          "type": "string",
          "maxLength": 3
        }
      }
    },
    "BalanceType": {
      "title": "BalanceType",
      "example": "closingBooked",
      "x-enum-elements": [
        {
          "name": "closingBooked",
          "description": ""
        },
        {
          "name": "expected",
          "description": ""
        },
        {
          "name": "authorised",
          "description": ""
        },
        {
          "name": "openingBooked",
          "description": ""
        },
        {
          "name": "interimAvailable",
          "description": ""
        },
        {
          "name": "forwardAvailable",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "closingBooked",
        "expected",
        "authorised",
        "openingBooked",
        "interimAvailable",
        "forwardAvailable"
      ]
    },
    "Remittance": {
      "title": "Remittance",
      "type": "object",
      "properties": {
        "reference": {
          "description": "",
          "type": "string",
          "maxLength": 35
        },
        "referenceType": {
          "description": "",
          "type": "string",
          "maxLength": 35
        },
        "referenceIssuer": {
          "description": "",
          "type": "string",
          "maxLength": 35
        }
      },
      "required": [
        "reference"
      ]
    },
    "Address": {
      "title": "Address",
      "type": "object",
      "properties": {
        "country": {
          "description": "",
          "type": "string"
        },
        "street": {
          "description": "",
          "type": "string",
          "maxLength": 70
        },
        "buildingNumber": {
          "description": "",
          "type": "string"
        },
        "city": {
          "description": "",
          "type": "string"
        },
        "postalCode": {
          "description": "",
          "type": "string"
        }
      },
      "required": [
        "country"
      ]
    },
    "FundsConfirmationsRequest": {
      "title": "Funds Confirmations Request",
      "type": "object",
      "properties": {
        "account": {
          "$ref": "#/definitions/AccountReference"
        },
        "instructedAmount": {
          "$ref": "#/definitions/Amount"
        },
        "cardNumber": {
          "description": "",
          "type": "string"
        },
        "payee": {
          "description": "",
          "type": "string",
          "maxLength": 70
        }
      },
      "required": [
        "account",
        "instructedAmount"
      ]
    },
    "PeriodicPaymentsRequest": {
      "title": "Periodic Payments Request",
      "type": "object",
      "properties": {
        "startDate": {
          "description": "",
          "type": "string",
          "format": "date"
        },
        "executionRule": {
          "description": "",
          "type": "string"
        },
        "endDate": {
          "description": "",
          "type": "string",
          "format": "date"
        },
        "frequency": {
          "$ref": "#/definitions/Frequency"
        },
        "dayOfExecution": {
          "description": "",
          "type": "integer",
          "minimum": 1.0,
          "maximum": 31.0,
          "format": "int32"
        }
      }
    },
    "TppMessage261": {
      "title": "TppMessage261",
      "type": "object",
      "properties": {
        "category": {
          "$ref": "#/definitions/Category"
        },
        "code": {
          "$ref": "#/definitions/MessageCode"
        },
        "text": {
          "description": "",
          "example": "additional text information of the ASPSP up to 512 characters",
          "type": "string",
          "maxLength": 512
        },
        "path": {
          "description": "",
          "type": "string"
        }
      },
      "required": [
        "category",
        "code",
        "text"
      ]
    },
    "PaymentidStatusResponse": {
      "title": "PaymentId Status Response",
      "type": "object",
      "properties": {
        "transactionStatus": {
          "$ref": "#/definitions/TransactionStatus"
        },
        "scaStatus": {
          "description": "This data element is containing information about the status of the SCA method applied. This is free text but might be coded in a future version of the specification.",
          "type": "string"
        }
      }
    },
    "PaymentidRequest": {
      "title": "PaymentId Request",
      "type": "object",
      "properties": {
        "psuData": {
          "$ref": "#/definitions/PSUData"
        },
        "authenticationMethodId": {
          "description": "",
          "type": "string"
        },
        "scaAuthenticationData": {
          "description": "",
          "type": "string"
        }
      }
    },
    "ContentType": {
      "title": "Content-Type",
      "example": "application/json",
      "x-enum-elements": [
        {
          "name": "Enum_applicationjson",
          "description": ""
        },
        {
          "name": "Enum_applicationxml",
          "description": ""
        },
        {
          "name": "Enum_applicationtext",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "application/json",
        "application/xml",
        "application/text"
      ]
    },
    "PaymentProduct": {
      "title": "payment-product",
      "example": "sepa-credit-transfers",
      "x-enum-elements": [
        {
          "name": "sepacredittransfers",
          "description": ""
        },
        {
          "name": "instantsepacredittransfers",
          "description": ""
        },
        {
          "name": "target2payments",
          "description": ""
        },
        {
          "name": "crossbordercredittransfers",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "sepa-credit-transfers",
        "instant-sepa-credit-transfers",
        "target-2-payments",
        "cross-border-credit-transfers"
      ]
    },
    "PaymentService": {
      "title": "payment-service",
      "example": "payments",
      "x-enum-elements": [
        {
          "name": "payments",
          "description": ""
        },
        {
          "name": "bulkpayments",
          "description": ""
        },
        {
          "name": "periodicpayments",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "payments",
        "bulk-payments",
        "periodic-payments"
      ]
    },
    "ConsentsStatusResponse": {
      "title": "Consents Status Response",
      "type": "object",
      "properties": {
        "consentStatus": {
          "$ref": "#/definitions/ConsentStatus"
        },
        "scaStatus": {
          "description": "This data element is containing information about the status of the SCA method applied. This is free text but might be coded in a future version of the specification.",
          "type": "string"
        }
      },
      "required": [
        "consentStatus"
      ]
    },
    "ConsentsRequest144": {
      "title": "Consents Request144",
      "type": "object",
      "properties": {
        "psuData": {
          "$ref": "#/definitions/PSUData"
        },
        "authenticationMethodId": {
          "description": "",
          "type": "string"
        },
        "scaAuthenticationData": {
          "description": "",
          "type": "string"
        }
      }
    },
    "AuthenticationType": {
      "title": "AuthenticationType",
      "example": "SMS_OTP",
      "x-enum-elements": [
        {
          "name": "SMS_OTP",
          "description": ""
        },
        {
          "name": "CHIP_OTP",
          "description": ""
        },
        {
          "name": "PHOTO_OTP",
          "description": ""
        },
        {
          "name": "PUSH_OTP",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "SMS_OTP",
        "CHIP_OTP",
        "PHOTO_OTP",
        "PUSH_OTP"
      ]
    },
    "AccountReport": {
      "title": "AccountReport",
      "type": "object",
      "properties": {
        "booked": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Transaction"
          }
        },
        "_links": {
          "description": "The following links might be used within this context, account link (mandatory), first_page_link (optional), second_page_link (optional), current_page_ link (optional), last_page_link (optional)",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "pending": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Transaction"
          }
        }
      },
      "required": [
        "booked",
        "_links"
      ]
    },
    "AccountsTransactionsResponse": {
      "title": "Accounts Transactions Response",
      "type": "object",
      "properties": {
        "account": {
          "$ref": "#/definitions/AccountReference"
        },
        "transactions": {
          "$ref": "#/definitions/AccountReport"
        },
        "_links": {
          "description": "",
          "type": "object",
          "additionalProperties": {
            "type": "object"
          }
        },
        "balances": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Balance"
          }
        }
      }
    },
    "Accept": {
      "title": "Accept",
      "example": "xml",
      "x-enum-elements": [
        {
          "name": "xml",
          "description": ""
        },
        {
          "name": "JSON",
          "description": ""
        },
        {
          "name": "text",
          "description": ""
        }
      ],
      "type": "string",
      "enum": [
        "xml",
        "JSON",
        "text"
      ]
    },
    "AccountsBalancesResponse": {
      "title": "Accounts Balances Response",
      "type": "object",
      "properties": {
        "balances": {
          "description": "",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Balance"
          }
        },
        "account": {
          "$ref": "#/definitions/AccountReference"
        }
      },
      "required": [
        "balances"
      ]
    },
    "TppMessage": {
      "title": "TppMessage",
      "type": "object",
      "properties": {
        "category": {
          "$ref": "#/definitions/Category"
        },
        "code": {
          "$ref": "#/definitions/MessageCode"
        },
        "text": {
          "description": "",
          "example": "additional text information of the ASPSP up to 512 characters",
          "type": "string",
          "maxLength": 512
        },
        "path": {
          "description": "",
          "type": "string"
        }
      },
      "required": [
        "category",
        "code",
        "text"
      ]
    },
    "Amount": {
      "title": "Amount",
      "type": "object",
      "properties": {
        "currency": {
          "description": "ISO 4217 Alpha 3 currency code",
          "example": "EUR",
          "type": "string",
          "maxLength": 3
        },
        "amount": {
          "description": "The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot.",
          "example": "123.42",
          "type": "string"
        }
      },
      "required": [
        "currency",
        "amount"
      ]
    },
    "Balance": {
      "title": "Balance",
      "type": "object",
      "properties": {
        "balanceAmount": {
          "$ref": "#/definitions/Amount"
        },
        "balanceType": {
          "$ref": "#/definitions/BalanceType"
        },
        "lastChangeDateTime": {
          "description": "",
          "type": "string",
          "format": "date-time"
        },
        "referenceDate": {
          "description": "",
          "example": "2017-10-30",
          "type": "string",
          "format": "date"
        },
        "lastCommittedTransaction": {
          "description": "",
          "type": "string",
          "maxLength": 35
        }
      },
      "required": [
        "balanceAmount",
        "balanceType"
      ]
    }
  }
}