openapi: 3.0.1
info:
  title: NextGenPSD2 XS2A Framework
  description: "\r\n# Summary\r\n\r\nThe **NextGenPSD2** Framework Version 1.3.9 offers a modern, open, harmonized and interoperable set of Application Programming Interfaces (APIs) as the safest and most efficient way to provide data securely. The NextGenPSD2 Framework reduces XS2A complexity and costs, addresses the problem of multiple competing standards in Europe and, aligned with the goals of the Euro Retail Payments Board, enables european banking customers to benefit from innovative products and services('Banking as a Service') by granting TPPs safe and secure (authenticated and authorized) access to their bank accounts and financial data.\r\n\r\nThe possible Approaches are:\r\n* Redirect SCA Approach\r\n* OAuth SCA Approach\r\n* Decoupled SCA Approach\r\n* Embedded SCA Approach without SCA method\r\n* Embedded SCA Approach with only one SCA method available\r\n* Embedded SCA Approach with Selection of a SCA method\r\n\r\nNot every message defined in this API definition is necessary for all approaches.\r\nFurthermore this API definition does not differ between methods which are mandatory, conditional, or optional.Therefore for a particular implementation of a Berlin Group PSD2 compliant API it is only necessary to support a certain subset of the methods defined in this API definition.\r\n\r\n**Please have a look at the implementation guidelines if you are not sure      which message has to be used for the approach you are going to use.**\r\n\r\n## Some General Remarks Related to this version of the OpenAPI Specification:\r\n\r\n* **This API definition is based on the Implementation Guidelines of the Berlin Group PSD2 API.**  It is not a replacement in any sense. The main specification is (at the moment) always the Implementation Guidelines of the Berlin Group PSD2 API\r\n"
  contact:
    name: Alta Software llc
    url: https://psd2.altasoft.ge
    email: psd2@altasoft.ge
  version: v0.8
servers:
  - url: psd2-sandbox1.altasoft.ge
    description: Sandbox Server 1
  - url: psd2-sandbox2.altasoft2.ge
    description: Sandbox Server 2
paths:
  /0.8/v1/accounts:
    get:
      tags:
        - Accounts
      summary: Read account list
      description: 'Read the identifiers of the available payment account together with  booking balance information, depending on the consent granted.  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.   Returns all identifiers of the accounts, to which an account access has been granted to through  the /consents endpoint by the PSU.  In addition, relevant information about the accounts and hyperlinks to corresponding account  information resources are provided if a related consent has been already granted.  Remark: Note that the /consents endpoint optionally offers to grant an access on all available  payment accounts of a PSU.  In this case, this endpoint will deliver the information about all available payment accounts  of the PSU at this ASPSP.'
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: withBalance
          in: query
          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.'
          schema:
            type: boolean
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountListResponse'
              examples:
                getAccountListResponseExample1:
                  summary: Example of Getting Account List by ConsentId.
                  value: {"accounts":[{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","iban":"GE02AL0000000000118060","currency":"GEL","name":"Account #1 name","displayName":"Account #1 display name","product":"Current account","status":"enabled","bic":"ALTAGE22","usage":"PRIV","_links":{"balances":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"},"transactions":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}}]}
                getAccountListResponseExample2:
                  summary: Example of Getting Account List by ConsentId.
                  value: {"accounts":[{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","iban":"GE02AL0000000000118060","currency":"XXX","name":"Account #1 name","displayName":"Account #1 display name","product":"Current account","status":"enabled","bic":"ALTAGE22","usage":"PRIV","balances":[{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"interimAvailable"},{"balanceAmount":{"currency":"USD","amount":"1000.00"},"balanceType":"interimAvailable"},{"balanceAmount":{"currency":"EUR","amount":"1000.00"},"balanceType":"interimAvailable"}]},{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","iban":"GE02AL0000000001718520","currency":"XXX","name":"Account #2 name","displayName":"Account #2 display name","product":"Current account","status":"enabled","bic":"ALTAGE22","usage":"PRIV","balances":[{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"USD","amount":"1000.00"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"EUR","amount":"1000.00"},"balanceType":"closingBooked"}]},{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","iban":"GE02AL0000000000118020","currency":"XXX","name":"Account #3 name","displayName":"Account #3 display name","product":"Current account","status":"enabled","bic":"ALTAGE22","usage":"PRIV","balances":[{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"interimBooked"},{"balanceAmount":{"currency":"USD","amount":"1000.00"},"balanceType":"interimBooked"},{"balanceAmount":{"currency":"EUR","amount":"1000.00"},"balanceType":"interimBooked"}]}]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/accounts/{account-id}/balances':
    get:
      tags:
        - Accounts
      summary: Read balance
      description: "Reads account data from a given account addressed by 'account-id'.\r\n            **Remark:** This account-id can be a tokenised identification due to data protection reason since the path  information might be logged on intermediary servers within the ASPSP sphere.  This account-id then can be retrieved by the 'Get account list' call.  The account-id is constant at least throughout the lifecycle of a given consent."
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: This identification is denoting the addressed (card) account. The account-id is retrieved by using a 'Read Account List' or 'Read Card 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.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBalancesResponse'
              examples:
                getBalancesResponseExample1:
                  summary: Example of Getting Account Balances by AccountId.
                  value: {"account":{"iban":"GE02AL0000000000118060","currency":"GEL"},"balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/accounts/{account-id}/transactions/{transactionId}':
    get:
      tags:
        - Accounts
      summary: Read transaction details
      description: "Reads transaction details from a given transaction addressed by 'transactionId' on a given account addressed by 'account-id'.\r\nThis call is only available on transactions as reported in a JSON format.\r\n**Remark:** Please note that the PATH might be already given in detail by the corresponding entry of the response of the 'Read Transaction List'\r\ncall within the _links sub-field."
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: "This identification is denoting the addressed (card) account.  The account-id is retrieved by using a 'Read Account List'\r\n            or 'Read Card Account list' call.  The account-id is the 'resourceId' attribute of the account structure.\r\n            Its value is constant at least throughout the lifecycle of a given consent."
          required: true
          schema:
            type: string
        - name: transactionId
          in: path
          description: This identification is given by the attribute transactionId of the corresponding entry of a transaction list.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTransactionDetailsResponse'
              examples:
                getTransactionDetailsExample1:
                  summary: Example of transaction details
                  value: {"transactionsDetails":{"transactionId":"GE02AL0000000000118020_1","bookingDate":"2020-10-29","valueDate":"2020-10-31","transactionAmount":{"currency":"GEL","amount":"-7777.00"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/accounts/{account-id}/transactions':
    get:
      tags:
        - Accounts
      summary: Read transaction list of an account
      description: "Read transaction reports or transaction lists of a given account dressed by 'account-id', depending on the steering parameter 'bookingStatus' together with balances.\r\n            For a given account, additional parameters are e.g. the attributes 'dateFrom' and 'dateTo'.\r\n            The ASPSP might add balance information, if transaction lists without balances are not supported."
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: "This identification is denoting the addressed (card) account.\r\n            The account-id is retrieved by using a 'Read Account List' or 'Read Card Account list' call.\r\n            The account-id is the 'resourceId' attribute of the account structure.\r\n            Its value is constant at least throughout the lifecycle of a given consent."
          required: true
          schema:
            type: string
        - name: bookingStatus
          in: query
          description: "Permitted codes are\r\n              * 'information',\r\n              * 'booked',\r\n              * 'pending', and\r\n              * 'both'\r\n              'booked' shall be supported by the ASPSP.\r\n              To support the 'pending' and 'both' feature is optional for the ASPSP,  Error code if not supported in the online banking frontend"
          schema:
            $ref: '#/components/schemas/BookingStatus'
        - name: dateFrom
          in: query
          description: 'Conditional: Starting date (inclusive the date dateFrom) of the transaction list, mandated if no delta access is required and if bookingStatus does not equal ''information''. For booked transactions, the relevant date is the booking date. For pending transactions, the relevant date is the entry date, which may not be transparent  neither in this API nor other channels of the ASPSP.'
          schema:
            type: string
            format: date
        - name: dateTo
          in: query
          description: 'End date (inclusive the data dateTo) of the transaction list, default is ''now'' if not given.   Might be ignored if a delta function is used. For booked transactions, the relevant date is the booking date. For pending transactions, the relevant date is the entry date, which may not be transparent  neither in this API nor other channels of the ASPSP.'
          schema:
            type: string
            format: date
        - name: entryReferenceFrom
          in: query
          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. Optional if supported by API provider.'
          schema:
            type: string
        - name: deltaList
          in: query
          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. Optional if supported by API provider
          schema:
            type: boolean
        - name: withBalance
          in: query
          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.'
          schema:
            type: boolean
        - name: state
          in: query
          description: ''
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTransactionListResponse'
              examples:
                getTransactionListResponseExample1:
                  summary: Example of transactions by account without balances
                  value: {"account":{"iban":"GE02AL0000000000118020"},"transactions":{"booked":[{"transactionId":"GE02AL0000000000118020_1","bookingDate":"2020-10-29","valueDate":"2020-10-30","transactionAmount":{"currency":"GEL","amount":"-577.60"}},{"transactionId":"GE02AL0000000000118020_2","bookingDate":"2020-11-29","valueDate":"2020-11-30","transactionAmount":{"currency":"GEL","amount":"-7077.00"}},{"transactionId":"GE02AL0000000000118020_3","bookingDate":"2020-09-29","valueDate":"2020-09-30","transactionAmount":{"currency":"GEL","amount":"5277.55"}}],"pending":[{"transactionId":"GE02AL0000000000118020_1","bookingDate":"2020-10-29","valueDate":"2020-10-30","transactionAmount":{"currency":"GEL","amount":"577.00"}},{"transactionId":"GE02AL0000000000118020_2","bookingDate":"2020-11-29","valueDate":"2020-11-30","transactionAmount":{"currency":"GEL","amount":"-45277.00"}}],"_links":{"account":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0"},"first":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?state=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQ"},"next":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?state=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQreertty"},"last":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?state=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQqwwweeer"}}},"_links":{"download":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"}}}
                getTransactionListResponseExample2:
                  summary: Example of transactions by account with balances
                  value: {"account":{"iban":"GE02AL0000000000118020"},"transactions":{"booked":[{"transactionId":"GE02AL0000000000118020_1","bookingDate":"2020-10-29","valueDate":"2020-10-30","transactionAmount":{"currency":"GEL","amount":"-7077.00"}},{"transactionId":"GE02AL0000000000118020_2","bookingDate":"2020-11-29","valueDate":"2020-11-30","transactionAmount":{"currency":"GEL","amount":"-7767.45"}},{"transactionId":"GE02AL0000000000118020_3","bookingDate":"2020-09-29","valueDate":"2020-09-30","transactionAmount":{"currency":"GEL","amount":"5277.50"}}],"pending":[{"transactionId":"GE02AL0000000000118020_1","bookingDate":"2020-10-29","valueDate":"2020-10-30","transactionAmount":{"currency":"GEL","amount":"577.65"}},{"transactionId":"GE02AL0000000000118020_2","bookingDate":"2020-11-29","valueDate":"2020-11-30","transactionAmount":{"currency":"GEL","amount":"-45277.12"}}],"_links":{"account":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0"},"first":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQ"},"next":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQreertty"},"last":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQqwwweeer"}}},"balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/accounts/{account-id}':
    get:
      tags:
        - Accounts
      summary: Read account details
      description: 'Reads details about an account, 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 details of this account depends then on the stored consent addressed by consentId,  respectively the OAuth2 access token.  **NOTE:** The account-id can represent a multicurrency account.  In this case the currency code is set to ''XXX''.  Give detailed information about the addressed account.  Give detailed information about the addressed account together with balance information'
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: This identification is denoting the addressed (card) account.  The account-id is retrieved by using a 'Read Account List' or 'Read Card 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.
          required: true
          schema:
            type: string
        - name: withBalance
          in: query
          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.'
          schema:
            type: boolean
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadAccountDetailsResponse'
              examples:
                readAccountDetailsExample:
                  summary: Example of account details
                  value: {"account":{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","iban":"GE02AL0000000000118060","currency":"GEL","name":"Account #1 name","displayName":"Account #1 display name","product":"Current account","status":"enabled","bic":"ALTAGE22","usage":"PRIV","_links":{"balances":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"},"transactions":{"href":"v1/accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/bulk-payments/aspsp:
    post:
      tags:
        - BulkPayments
      summary: Performs bulk payment within ASPSP
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkPaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/BulkPaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/bulk-payments/domestic:
    post:
      tags:
        - BulkPayments
      summary: Performs Bulk  domestic payments
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkPaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/BulkPaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/bulk-payments/foreign:
    post:
      tags:
        - BulkPayments
      summary: Performs Bulk foreign payments
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/bulk-payments/{payment-product}/{paymentId}':
    get:
      tags:
        - BulkPayments
      summary: Get payment information
      description: Returns the content of a payment object
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SinglePaymentInitiationWithStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    delete:
      tags:
        - BulkPayments
      summary: Payment cancellation request
      description: "This method initiates the cancellation of a payment.  Depending on the payment-service, the payment-product and the ASPSP's\r\n            implementation,  this TPP call might be sufficient to cancel a payment.  If an authorisation of the payment cancellation is mandated by the\r\n            ASPSP,  a corresponding hyperlink will be contained in the response message.  Cancels the addressed payment with resource identification\r\n            paymentId if applicable to the payment-service, payment-product and received in product related timelines\r\n            (e.g. before end of business day for scheduled payments of the last business day before the scheduled execution day).\r\n            The response to this DELETE command will tell the TPP whether the\r\n            * access method was rejected,\r\n            * access method was successful, or\r\n            * access method is generally applicable, but further authorisation processes are needed."
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationCancelResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/bulk-payments/{payment-product}/{paymentId}/status':
    get:
      tags:
        - BulkPayments
      summary: Payment initiation status request
      description: Check the transaction status of a payment initiation.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/bulk-payments/{payment-product}/{paymentId}/authorisations':
    post:
      tags:
        - BulkPayments
      summary: Start the authorisation process for a payment initiation
      description: 'Create an authorisation sub-resource and start the authorisation process.  The message might in addition transmit authentication and authorisation related data.   This method is iterated n times for a n times SCA authorisation in a  corporate context, each creating an own authorisation sub-endpoint for  the corresponding PSU authorising the transaction.  The ASPSP might make the usage of this access method unnecessary in case  of only one SCA process needed, since the related authorisation resource  might be automatically created by the ASPSP after the submission of the  payment data with the first POST payments/{payment-product} call.  The start authorisation process is a process which is needed for creating a new authorisation  or cancellation sub-resource.   This applies in the following scenarios:    * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding Payment      initiation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be      uploaded by using the extended forms:     * ''startAuthorisationWithPsuIdentfication''     * ''startAuthorisationWithPsuAuthentication''     * ''startAuthorisationWithEncryptedPsuAuthentication''     * ''startAuthorisationWithAuthentciationMethodSelection''   * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.   * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding      Payment cancellation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be uploaded      by using the extended forms as indicated above.   * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for      executing the cancellation.   * The signing basket needs to be authorised yet.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - BulkPayments
      summary: Get payment initiation authorisation sub-resources request
      description: Read a list of all authorisation subresources IDs which have been created.  This function returns an array of hyperlinks to all generated authorisation sub-resources.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorisationsResponse'
              examples:
                consentAuthorizationsExample1:
                  summary: Example of valid consent authorizations
                  value: {"authorisationIds":["241b524b-c1e2-4c9b-a019-2c8097c864c2"]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/bulk-payments/{payment-product}/{paymentId}/authorisations/{authorisationId}':
    get:
      tags:
        - BulkPayments
      summary: Read the SCA status of the payment authorisation
      description: This method returns the SCA status of a payment initiation's authorisation sub-resource.
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - BulkPayments
      summary: Update PSU data for payment initiation
      description: 'This methods updates PSU data on the authorisation resource if needed.  It may authorise a payment within the Embedded SCA Approach where needed.  Independently from the SCA Approach it supports e.g. the selection of  the authentication method and a non-SCA PSU authentication.  There are several possible update PSU data requests in the context of payment initiation services needed,  which depends on the SCA approach:  * Redirect SCA Approach:   A specific update PSU data request is applicable for      * the selection of authentication methods, before choosing the actual SCA approach. * Decoupled SCA Approach:   A specific update PSU data request is only applicable for   * adding the PSU identification, if not provided yet in the payment initiation request or the account information consent request, or if no OAuth2 access token is used, or   * the selection of authentication methods. * Embedded SCA Approach:    The Update PSU Data request might be used    * to add credentials as a first factor authentication data of the PSU and   * to select the authentication method and   * transaction authorisation.  The SCA Approach might depend on the chosen SCA method.  For that reason, the following possible Update PSU data request can apply to all SCA approaches:  * Select an SCA method in case of several SCA methods are available for the customer.  There are the following request types on this access path:   * Update PSU identification   * Update PSU authentication   * Select PSU autorization method      WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.   * Transaction authorisation     WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.'
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/bulk-payments/{payment-product}/{paymentId}/cancellation-authorisations':
    post:
      tags:
        - BulkPayments
      summary: Start the authorisation process for the cancellation of the addressed payment
      description: 'Creates an authorisation sub-resource and start the authorisation process of the cancellation of the addressed payment.  The message might in addition transmit authentication and authorisation related data.  This method is iterated n times for a n times SCA authorisation in a  corporate context, each creating an own authorisation sub-endpoint for  the corresponding PSU authorising the cancellation-authorisation.  The ASPSP might make the usage of this access method unnecessary in case  of only one SCA process needed, since the related authorisation resource  might be automatically created by the ASPSP after the submission of the  payment data with the first POST payments/{payment-product} call.  The start authorisation process is a process which is needed for creating a new authorisation  or cancellation sub-resource.   This applies in the following scenarios:    * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding payment      initiation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be      uploaded by using the extended forms:     * ''startAuthorisationWithPsuIdentfication''     * ''startAuthorisationWithPsuAuthentication''     * ''startAuthorisationWithAuthentciationMethodSelection''    * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.   * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding      payment cancellation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be uploaded      by using the extended forms as indicated above.   * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for      executing the cancellation.   * The signing basket needs to be authorised yet.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - BulkPayments
      summary: Will deliver an array of resource identifications to all generated cancellation authorisation sub-resources
      description: Retrieve a list of all created cancellation authorisation sub-resources.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancellationsResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/bulk-payments/{payment-product}/{paymentId}/cancellation-authorisations/{authorisationId}':
    get:
      tags:
        - BulkPayments
      summary: Read the SCA status of the payment cancellation's authorisation
      description: This method returns the SCA status of a payment initiation's authorisation sub-resource.
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - BulkPayments
      summary: Update PSU data for payment initiation cancellation
      description: 'This method updates PSU data on the cancellation authorisation resource if needed.  It may authorise a cancellation of the payment within the Embedded SCA Approach where needed.  Independently from the SCA Approach it supports e.g. the selection of  the authentication method and a non-SCA PSU authentication.  This methods updates PSU data on the cancellation authorisation resource if needed.   There are several possible update PSU data requests in the context of a cancellation authorisation within the payment initiation services needed,  which depends on the SCA approach:  * Redirect SCA Approach:   A specific Update PSU data request is applicable for      * the selection of authentication methods, before choosing the actual SCA approach. * Decoupled SCA Approach:   A specific Update PSU data request is only applicable for   * adding the PSU Identification, if not provided yet in the payment initiation request or the Account Information Consent Request, or if no OAuth2 access token is used, or   * the selection of authentication methods. * Embedded SCA Approach:    The Update PSU data request might be used    * to add credentials as a first factor authentication data of the PSU and   * to select the authentication method and   * transaction authorisation.  The SCA approach might depend on the chosen SCA method.  For that reason, the following possible update PSU data request can apply to all SCA approaches:  * Select an SCA method in case of several SCA methods are available for the customer.  There are the following request types on this access path:   * Update PSU identification   * Update PSU authentication   * Select PSU autorization method      WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.   * Transaction Authorisation     WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          description: Resource identification of the related SCA.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/card-accounts:
    get:
      tags:
        - CardAccounts
      summary: Read a list of card accounts
      description: "Reads a list of card accounts with additional information, e.g. balance information.\r\n            It is assumed that a consent of the PSU to this access is already given and stored on the ASPSP system.\r\n            The addressed list of card accounts depends then on the PSU ID and the stored consent addressed by consentId,\r\n            respectively the OAuth2 access token."
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCardAccountListResponse'
              examples:
                getCardAccountListExample1:
                  summary: Example of card accounts with balance
                  value: {"cardAccounts":[{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********6950","currency":"GEL","ownerName":"Demo User","displayName":"Account #0 display name","product":"Current account","status":"enabled","usage":"PRIV","balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}],"_links":{"transactions":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}},{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********2250","currency":"USD","ownerName":"Demo User","displayName":"Account #1 display name","product":"Current account","status":"enabled","usage":"PRIV","balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}],"_links":{"transactions":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}},{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********4610","currency":"EUR","ownerName":"Demo User","displayName":"Account #2 display name","product":"Current account","status":"enabled","usage":"PRIV","balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}],"_links":{"transactions":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}}]}
                getCardAccountListExample2:
                  summary: Example of card accounts without balance
                  value: {"cardAccounts":[{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********8980","currency":"GEL","ownerName":"Demo User","displayName":"Account #0 display name","product":"Current account","status":"enabled","usage":"PRIV","_links":{"balances":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"},"transactions":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}},{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********4070","currency":"USD","ownerName":"Demo User","displayName":"Account #1 display name","product":"Current account","status":"enabled","usage":"PRIV","_links":{"balances":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"},"transactions":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}},{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********9620","currency":"EUR","ownerName":"Demo User","displayName":"Account #2 display name","product":"Current account","status":"enabled","usage":"PRIV","_links":{"balances":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"},"transactions":{"href":"/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}}]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/card-accounts/{account-id}/balances':
    get:
      tags:
        - CardAccounts
      summary: Read card account balances
      description: 'Reads balance data from a given card account addressed by  \"account-id\".   Remark: This account-id can be a tokenised identification due  to data protection reason since the path information might be  logged on intermediary servers within the ASPSP sphere.  This account-id then can be retrieved by the  \"Get card account list\" call.'
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \"Read Account List\" or \"Read Card 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.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCardAccountBalancesResponse'
              examples:
                getCardAccountBalancesExample:
                  summary: Example of card account balances
                  value: {"cardAccount":{"iban":"GE02AL0000000000118060","maskedPan":"418057**********6950","currency":"GEL"},"balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/card-accounts/{account-id}/transactions':
    get:
      tags:
        - CardAccounts
      summary: Read transaction list of an account
      description: Reads account data from a given card account addressed by \"account-id\".
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \"Read Account List\" or \"Read Card 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.
          required: true
          schema:
            type: string
        - name: bookingStatus
          in: query
          description: 'Permitted codes are    * \"information\",   * \"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'
          required: true
          schema:
            $ref: '#/components/schemas/BookingStatus'
        - name: dateFrom
          in: query
          description: 'Conditional: Starting date (inclusive the date dateFrom) of the transaction list, mandated if no delta access is required and if bookingStatus does not equal \"information.  For booked transactions, the relevant date is the booking date.   For pending transactions, the relevant date is the entry date, which may not be transparent  neither in this API nor other channels of the ASPSP.'
          schema:
            type: string
            format: date
        - name: dateTo
          in: query
          description: 'End date (inclusive the data dateTo) of the transaction list, default is \"now\" if not given.   Might be ignored if a delta function is used.  For booked transactions, the relevant date is the booking date.   For pending transactions, the relevant date is the entry date, which may not be transparent  neither in this API nor other channels of the ASPSP.'
          schema:
            type: string
            format: date
        - name: deltaList
          in: query
          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. Optional if supported by API provider
          schema:
            type: boolean
        - name: state
          in: query
          description: ''
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardAccountsTransactionsResponse'
              examples:
                cardAccountsTransactionExample:
                  summary: Example of card account transaction
                  value: {"cardAccount":{"iban":"GE02AL0000000000118060","maskedPan":"418057**********6950","currency":"GEL"},"cardTransactions":{"booked":[{"transactionAmount":{"currency":"GEL","amount":"3520.45"},"maskedPAN":"418057**********6950"},{"transactionAmount":{"currency":"GEL","amount":"2520.00"},"maskedPAN":"418057**********6950"},{"transactionAmount":{"currency":"GEL","amount":"1520.86"},"maskedPAN":"418057**********6950"}],"_links":{"cardAccount":{"href":"v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0"},"first":{"href":"v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQ"},"next":{"href":"v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQ"},"last":{"href":"v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQ"},"previous":{"href":"v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions?entryReferenceFrom=eyJBY2NvdW50UmVmZXJlbmNlSWQiOiI3YjUwNTkwNi0wNzRlLTRlODctYWJkNC02NDI0YjRmNjIxYzAiLCJTdGFydFRyYW5zYWN0aW9uUG9pbnRlciI6bnVsbCwiQm9va2luZ1N0YXR1cyI6MSwiRGF0ZUZyb20iOnt9LCJEYXRlVG8iOnt9LCJEZWx0YUxpc3QiOm51bGwsIldpdGhCYWxhbmNlIjp0cnVlfQ"}}},"balances":[{"balanceAmount":{"currency":"GEL","amount":"100.60"},"balanceType":"interimAvailable","creditLimitIncluded":false,"referenceDate":"2020-11-03"},{"balanceAmount":{"currency":"GEL","amount":"103.20"},"balanceType":"closingBooked"},{"balanceAmount":{"currency":"GEL","amount":"1000.00"},"balanceType":"expected"}]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/card-accounts/{account-id}':
    get:
      tags:
        - CardAccounts
      summary: Read details about a card account
      description: "Reads details about a card account.\r\n            It is assumed that a consent of the PSU to this access is already given and stored on the ASPSP system.\r\n            The addressed details of this account depends then on the stored consent addressed by consentId, respectively the OAuth2  access token."
      parameters:
        - name: Consent-ID
          in: header
          description: 'ConsentId of the related AIS consent, which was performed prior to this payment initiation.'
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
        - name: account-id
          in: path
          description: This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \"Read Account List\" or \"Read Card 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.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardAccountByIdResponse'
              examples:
                cardAccountByIdExample:
                  summary: Example of card account by id
                  value: {"cardAccount":{"resourceId":"7b505906-074e-4e87-abd4-6424b4f621c0","maskedPan":"418057**********6950","currency":"GEL","name":"Account #1 name","displayName":"Account #1 display name","product":"Current account","status":"enabled","usage":"PRIV","_links":{"balances":{"href":"0.8/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/balances"},"transactions":{"href":"0.8/v1/card-accounts/7b505906-074e-4e87-abd4-6424b4f621c0/transactions"}}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/consents:
    post:
      tags:
        - Consents
      summary: Create consent
      description: "<br>\r\n            This method create a consent resource, defining access rights to dedicated accounts of a\r\n            given PSU-ID. These accounts are addressed explicitly in the method as parameters as a\r\n            core function.\r\n            \r\n<br>\r\n            **Side Effects** When this consent request is a request where the 'recurringIndicator'\r\n            equals 'true', and if it exists already a former consent for recurring access on account\r\n            information for the addressed PSU, then the former consent automatically expires as soon\r\n            as the new consent request is authorised by the PSU. Optional Extension: As an option,\r\n            an ASPSP might optionally accept a specific access right on the access on all PSD2\r\n            related services for all available accounts. As another option an ASPSP might optionally\r\n            also accept a command, where only access rights are inserted without mentioning the\r\n            addressed account. The relation to accounts is then handled afterwards between PSU and\r\n            ASPSP. This option is not supported for the Embedded SCA Approach. As a last option, an\r\n            ASPSP might in addition accept a command with access rights\r\n            * to see the list of available payment accounts or\r\n            * to see the list of available payment accounts with balances.\r\n            "
      requestBody:
        description: Request body for a consents request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateConsentRequestBody'
            examples:
              createConsentExample1:
                summary: Consent request on account list of available accounts.
                value: {"access":{"availableAccounts":"allAccounts"},"recurringIndicator":false,"validUntil":"2021-02-28","frequencyPerDay":4,"combinedServiceIndicator":false}
              createConsentExample2:
                summary: Consent request on account list without indication of accounts.
                value: {"access":{"balances":[],"transactions":[]},"recurringIndicator":false,"validUntil":"2021-02-28","frequencyPerDay":4,"combinedServiceIndicator":false}
              createConsentExample3:
                summary: Consent request on account list with dedicated accounts.
                value: {"access":{"accounts":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"}],"balances":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"},{"iban":"GE02AL0000000001718520","currency":"GEL"}],"transactions":[{"iban":"GE02AL0000000001718520","currency":"GEL"},{"maskedPan":"123456******1234"}]},"recurringIndicator":false,"validUntil":"2021-02-28","frequencyPerDay":4,"combinedServiceIndicator":false}
          application/*+json:
            schema:
              $ref: '#/components/schemas/CreateConsentRequestBody'
            examples:
              createConsentExample1:
                summary: Consent request on account list of available accounts.
                value: {"access":{"availableAccounts":"allAccounts"},"recurringIndicator":false,"validUntil":"2021-02-28","frequencyPerDay":4,"combinedServiceIndicator":false}
              createConsentExample2:
                summary: Consent request on account list without indication of accounts.
                value: {"access":{"balances":[],"transactions":[]},"recurringIndicator":false,"validUntil":"2021-02-28","frequencyPerDay":4,"combinedServiceIndicator":false}
              createConsentExample3:
                summary: Consent request on account list with dedicated accounts.
                value: {"access":{"accounts":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"}],"balances":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"},{"iban":"GE02AL0000000001718520","currency":"GEL"}],"transactions":[{"iban":"GE02AL0000000001718520","currency":"GEL"},{"maskedPan":"123456******1234"}]},"recurringIndicator":false,"validUntil":"2021-02-28","frequencyPerDay":4,"combinedServiceIndicator":false}
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateConsentResponse'
              examples:
                createConsentResponseExample1:
                  summary: Redirect with Oauth2 (Start authorization)
                  value: {"consentStatus":"received","consentId":"beae3ef6-e219-4626-a037-af10cd937df5","_links":{"self":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5"},"status":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/status"},"startAuthorisation":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations"}}}
                createConsentResponseExample2:
                  summary: Redirect with Oauth2 (Start authentication)
                  value: {"consentStatus":"valid","consentId":"beae3ef6-e219-4626-a037-af10cd937df5","_links":{"self":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5"},"status":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/status"},"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/consents/{consentId}/status':
    get:
      tags:
        - Consents
      summary: Consent status request
      description: Read the status of an account information consent resource.
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConsentStatusResponse'
              examples:
                getConsentStatusResponseExample1:
                  summary: Example of valid consent.
                  value: {"consentStatus":"valid"}
                getConsentStatusResponseExample2:
                  summary: Example of expired consent.
                  value: {"consentStatus":"expired","psuMessage":"Consent already expired"}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/consents/{consentId}':
    get:
      tags:
        - Consents
      summary: Get consent request
      description: "Returns the content of an account information consent object. This is returning the data\r\nfor the TPP especially in cases, where the consent was directly managed between ASPSP\r\nand PSU e.g. in a redirect SCA Approach."
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConsentInformationResponse'
              examples:
                getConsentInformationResponseExample1:
                  summary: Example of valid consent.
                  value: {"access":{"accounts":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"}],"balances":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"},{"iban":"GE02AL0000000001718520","currency":"GEL"}],"transactions":[{"iban":"GE02AL0000000001718520","currency":"GEL"},{"maskedPan":"123456******1234"}]},"recurringIndicator":true,"validUntil":"2021-02-28","frequencyPerDay":4,"lastActionDate":"2020-11-23","consentStatus":"valid","_links":{"account":{"href":"0.8/v1/accounts"},"card-account":{"href":"0.8/v1/card-accounts"}}}
                getConsentInformationResponseExample2:
                  summary: Example of expired consent.
                  value: {"access":{"accounts":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"}],"balances":[{"iban":"GE02AL0000000000118020","currency":"GEL"},{"iban":"GE02AL0000000000309110","currency":"USD"},{"iban":"GE02AL0000000001618610","currency":"EUR"},{"iban":"GE02AL0000000001718520","currency":"GEL"}],"transactions":[{"iban":"GE02AL0000000001718520","currency":"GEL"},{"maskedPan":"123456******1234"}]},"recurringIndicator":true,"validUntil":"2020-02-28","frequencyPerDay":4,"lastActionDate":"2020-11-23","consentStatus":"expired","_links":{"account":{"href":"0.8/v1/accounts"},"card-account":{"href":"0.8/v1/card-accounts"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    delete:
      tags:
        - Consents
      summary: Delete consent
      description: The TPP can delete an account information consent object if needed.
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/consents/{consentId}/authorisations':
    post:
      tags:
        - Consents
      summary: Start the authorisation process for a consent
      description: "Create an authorisation sub-resource and start the authorisation process of a consent.\r\nThe message might in addition transmit authentication and authorisation related data.\r\nThis method is iterated n times for a n times SCA authorisation in a corporate context,\r\neach creating an own authorisation sub-endpoint for the corresponding PSU authorising\r\nthe consent. The ASPSP might make the usage of this access method unnecessary, since the\r\nrelated authorisation resource will be automatically created by the ASPSP after the\r\nsubmission of the consent data with the first POST consents call. The start\r\nauthorisation process is a process which is needed for creating a new authorisation or\r\ncancellation sub-resource. This applies in the following scenarios:\r\n* The ASPSP has indicated with an 'startAuthorisation' hyperlink in the preceding Payment\r\ninitiation response that an explicit start of the authorisation process is needed by the\r\nTPP. The 'startAuthorisation' hyperlink can transport more information about data which\r\nneeds to be uploaded by using the extended forms:\r\n* 'startAuthorisationWithPsuIdentfication',\r\n* 'startAuthorisationWithPsuAuthentication'\r\n* 'startAuthorisationWithEncryptedPsuAuthentication'\r\n* 'startAuthorisationWithAuthentciationMethodSelection'\r\n* The related payment initiation cannot yet be executed since a multilevel SCA is mandated.\r\n* The ASPSP has indicated with an 'startAuthorisation' hyperlink in the preceding\r\npayment cancellation response that an explicit start of the authorisation process is\r\nneeded by the TPP. The 'startAuthorisation' hyperlink can transport more information\r\nabout data which needs to be uploaded by using the extended forms as indicated above.\r\n* The related payment cancellation request cannot be applied yet since a multilevel SCA\r\nis mandate for executing the cancellation. * The signing basket needs to be authorised yet."
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
      requestBody:
        description: Request body for start consent authorization request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - Consents
      summary: Get consent authorisation sub-resources request
      description: "Return a list of all authorisation sub resources IDs which have been created. This\r\nfunction returns an array of hyperlinks to all generated authorisation sub-resources."
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorisationsResponse'
              examples:
                consentAuthorizationsExample1:
                  summary: Example of valid consent authorizations
                  value: {"authorisationIds":["241b524b-c1e2-4c9b-a019-2c8097c864c2"]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/consents/{consentId}/authorisations/{authorisationId}':
    get:
      tags:
        - Consents
      summary: Read the SCA status of the consent authorisation
      description: This method returns the SCA status of a consent initiation's authorisation sub-resource.
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
        - name: authorisationId
          in: path
          description: Resource identification of the related SCA.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - Consents
      summary: Update PSU Data for consents
      description: "This method updates PSU data on the consents resource if needed. It may authorise a\r\nconsent within the Embedded SCA Approach where needed. Independently from the SCA\r\nApproach it supports e.g. the selection of the authentication method and a non-SCA PSU\r\nauthentication. This methods updates PSU data on the cancellation authorisation resource\r\nif needed. There are several possible update PSU data requests in the context of a\r\nconsent request if needed, which depends on the SCA approach:\r\n* Redirect SCA Approach: A specific Update PSU data request is applicable for\r\n* the selection of authentication methods, before choosing the actual SCA approach.\r\n* Decoupled SCA Approach: A specific update PSU data request is only applicable for\r\n* adding the PSU Identification, if not provided yet in the payment initiation request\r\nor the Account Information Consent Request, or if no OAuth2 access token is used, or\r\n* the selection of authentication methods.\r\n* Embedded SCA Approach: The Update PSU data request might be used\r\n* to add credentials as a first factor authentication data of the PSU and\r\n* to select the authentication method and * transaction authorisation. The SCA Approach\r\nmight depend on the chosen SCA method. For that reason, the following possible update\r\nPSU data request can apply to all SCA approaches:\r\n* Select an SCA method in case of several SCA methods are available for the customer.\r\nThere are the following request types on this access path: * Update PSU identification *\r\nUpdate PSU authentication * Select PSU autorization method WARNING: This method needs a\r\nreduced header, therefore many optional elements are not present. Maybe in a later\r\nversion the access path will change. * Transaction Authorisation WARNING: This method\r\nneeds a reduced header, therefore many optional elements are not present. Maybe in a\r\nlater version the access path will change."
      parameters:
        - name: consentId
          in: path
          description: ID of the corresponding consent object as returned by an account information consent request.
          required: true
          schema:
            maxLength: 36
            minLength: 0
            type: string
          example: beae3ef6-e219-4626-a037-af10cd937df5
        - name: authorisationId
          in: path
          description: Resource identification of the related SCA.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/periodic-payments/aspsp:
    post:
      tags:
        - PeriodicPayments
      summary: Payment initiation request
      description: 'This method is used to initiate a payment at the ASPSP.  ## Variants of payment initiation requests  This method to initiate a payment initiation at the ASPSP can be sent with either a JSON body or an pain.001 body depending on the payment product in the path.  There are the following **payment products**:    - Payment products with payment information in *JSON* format:     - ***sepa-credit-transfers***     - ***instant-sepa-credit-transfers***     - ***target-2-payments***     - ***cross-border-credit-transfers***   - Payment products with payment information in *pain.001* XML format:     - ***pain.001-sepa-credit-transfers***     - ***pain.001-instant-sepa-credit-transfers***     - ***pain.001-target-2-payments***     - ***pain.001-cross-border-credit-transfers***  Furthermore the request body depends on the **payment-service**:   * ***payments***: A single payment initiation request.   * ***periodic-payments***: A collection of several payment initiation requests.        In case of a *pain.001* message there are more than one payments contained in the *pain.001 message.          In case of a *JSON* there are several JSON payment blocks contained in a joining list.   * ***periodic-payments***:      Create a standing order initiation resource for recurrent i.e. periodic payments addressable under {paymentId}       with all data relevant for the corresponding payment product and the execution of the standing order contained in a JSON body.   This is the first step in the API to initiate the related recurring/periodic payment.    ## Single and mulitilevel SCA Processes  The payment initiation requests are independent from the need of one or multilevel  SCA processing, i.e. independent from the number of authorisations needed for the execution of payments.   But the response messages are specific to either one SCA processing or multilevel SCA processing.   For payment initiation with multilevel SCA, this specification requires an explicit start of the authorisation,  i.e. links directly associated with SCA processing like ''scaRedirect'' or ''scaOAuth'' cannot be contained in the  response message of a Payment Initation Request for a payment, where multiple authorisations are needed.  Also if any data is needed for the next action, like selecting an SCA method is not supported in the response,  since all starts of the multiple authorisations are fully equal.  In these cases, first an authorisation sub-resource has to be generated following the ''startAuthorisation'' link.'
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PeriodicPaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/PeriodicPaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/periodic-payments/domestic:
    post:
      tags:
        - PeriodicPayments
      summary: Payment initiation request
      description: 'This method is used to initiate a payment at the ASPSP.  ## Variants of payment initiation requests  This method to initiate a payment initiation at the ASPSP can be sent with either a JSON body or an pain.001 body depending on the payment product in the path.  There are the following **payment products**:    - Payment products with payment information in *JSON* format:     - ***sepa-credit-transfers***     - ***instant-sepa-credit-transfers***     - ***target-2-payments***     - ***cross-border-credit-transfers***   - Payment products with payment information in *pain.001* XML format:     - ***pain.001-sepa-credit-transfers***     - ***pain.001-instant-sepa-credit-transfers***     - ***pain.001-target-2-payments***     - ***pain.001-cross-border-credit-transfers***  Furthermore the request body depends on the **payment-service**:   * ***payments***: A single payment initiation request.   * ***periodic-payments***: A collection of several payment initiation requests.        In case of a *pain.001* message there are more than one payments contained in the *pain.001 message.          In case of a *JSON* there are several JSON payment blocks contained in a joining list.   * ***periodic-payments***:      Create a standing order initiation resource for recurrent i.e. periodic payments addressable under {paymentId}       with all data relevant for the corresponding payment product and the execution of the standing order contained in a JSON body.   This is the first step in the API to initiate the related recurring/periodic payment.    ## Single and mulitilevel SCA Processes  The payment initiation requests are independent from the need of one or multilevel  SCA processing, i.e. independent from the number of authorisations needed for the execution of payments.   But the response messages are specific to either one SCA processing or multilevel SCA processing.   For payment initiation with multilevel SCA, this specification requires an explicit start of the authorisation,  i.e. links directly associated with SCA processing like ''scaRedirect'' or ''scaOAuth'' cannot be contained in the  response message of a Payment Initation Request for a payment, where multiple authorisations are needed.  Also if any data is needed for the next action, like selecting an SCA method is not supported in the response,  since all starts of the multiple authorisations are fully equal.  In these cases, first an authorisation sub-resource has to be generated following the ''startAuthorisation'' link.'
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PeriodicPaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/PeriodicPaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/periodic-payments/foreign:
    post:
      tags:
        - PeriodicPayments
      summary: Payment initiation request
      description: 'This method is used to initiate a payment at the ASPSP.  ## Variants of payment initiation requests  This method to initiate a payment initiation at the ASPSP can be sent with either a JSON body or an pain.001 body depending on the payment product in the path.  There are the following **payment products**:    - Payment products with payment information in *JSON* format:     - ***sepa-credit-transfers***     - ***instant-sepa-credit-transfers***     - ***target-2-payments***     - ***cross-border-credit-transfers***   - Payment products with payment information in *pain.001* XML format:     - ***pain.001-sepa-credit-transfers***     - ***pain.001-instant-sepa-credit-transfers***     - ***pain.001-target-2-payments***     - ***pain.001-cross-border-credit-transfers***  Furthermore the request body depends on the **payment-service**:   * ***payments***: A single payment initiation request.   * ***periodic-payments***: A collection of several payment initiation requests.        In case of a *pain.001* message there are more than one payments contained in the *pain.001 message.          In case of a *JSON* there are several JSON payment blocks contained in a joining list.   * ***periodic-payments***:      Create a standing order initiation resource for recurrent i.e. periodic payments addressable under {paymentId}       with all data relevant for the corresponding payment product and the execution of the standing order contained in a JSON body.   This is the first step in the API to initiate the related recurring/periodic payment.    ## Single and mulitilevel SCA Processes  The payment initiation requests are independent from the need of one or multilevel  SCA processing, i.e. independent from the number of authorisations needed for the execution of payments.   But the response messages are specific to either one SCA processing or multilevel SCA processing.   For payment initiation with multilevel SCA, this specification requires an explicit start of the authorisation,  i.e. links directly associated with SCA processing like ''scaRedirect'' or ''scaOAuth'' cannot be contained in the  response message of a Payment Initation Request for a payment, where multiple authorisations are needed.  Also if any data is needed for the next action, like selecting an SCA method is not supported in the response,  since all starts of the multiple authorisations are fully equal.  In these cases, first an authorisation sub-resource has to be generated following the ''startAuthorisation'' link.'
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PeriodicPaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/PeriodicPaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/periodic-payments/{payment-product}/{paymentId}':
    get:
      tags:
        - PeriodicPayments
      summary: Get payment information
      description: Returns the content of a payment object
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeriodicPaymentInitiationWithStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    delete:
      tags:
        - PeriodicPayments
      summary: Payment cancellation request
      description: "This method initiates the cancellation of a payment.  Depending on the payment-service, the payment-product and the ASPSP's\r\n            implementation,  this TPP call might be sufficient to cancel a payment.  If an authorisation of the payment cancellation is mandated by the\r\n            ASPSP,  a corresponding hyperlink will be contained in the response message.  Cancels the addressed payment with resource identification\r\n            paymentId if applicable to the payment-service, payment-product and received in product related timelines\r\n            (e.g. before end of business day for scheduled payments of the last business day before the scheduled execution day).\r\n            The response to this DELETE command will tell the TPP whether the\r\n            * access method was rejected,\r\n            * access method was successful, or\r\n            * access method is generally applicable, but further authorisation processes are needed."
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationCancelResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/periodic-payments/{payment-product}/{paymentId}/status':
    get:
      tags:
        - PeriodicPayments
      summary: Payment initiation status request
      description: Check the transaction status of a payment initiation.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/periodic-payments/{payment-product}/{paymentId}/authorisations':
    post:
      tags:
        - PeriodicPayments
      summary: Start the authorisation process for a payment initiation
      description: 'Create an authorisation sub-resource and start the authorisation process.  The message might in addition transmit authentication and authorisation related data.   This method is iterated n times for a n times SCA authorisation in a  corporate context, each creating an own authorisation sub-endpoint for  the corresponding PSU authorising the transaction.  The ASPSP might make the usage of this access method unnecessary in case  of only one SCA process needed, since the related authorisation resource  might be automatically created by the ASPSP after the submission of the  payment data with the first POST payments/{payment-product} call.  The start authorisation process is a process which is needed for creating a new authorisation  or cancellation sub-resource.   This applies in the following scenarios:    * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding Payment      initiation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be      uploaded by using the extended forms:     * ''startAuthorisationWithPsuIdentfication''     * ''startAuthorisationWithPsuAuthentication''     * ''startAuthorisationWithEncryptedPsuAuthentication''     * ''startAuthorisationWithAuthentciationMethodSelection''   * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.   * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding      Payment cancellation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be uploaded      by using the extended forms as indicated above.   * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for      executing the cancellation.   * The signing basket needs to be authorised yet.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - PeriodicPayments
      summary: Get payment initiation authorisation sub-resources request
      description: Read a list of all authorisation subresources IDs which have been created.  This function returns an array of hyperlinks to all generated authorisation sub-resources.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancellationsResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/periodic-payments/{payment-product}/{paymentId}/authorisations/{authorisationId}':
    get:
      tags:
        - PeriodicPayments
      summary: Read the SCA status of the payment authorisation
      description: This method returns the SCA status of a payment initiation's authorisation sub-resource.
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - PeriodicPayments
      summary: Update PSU data for payment initiation
      description: 'This methods updates PSU data on the authorisation resource if needed.  It may authorise a payment within the Embedded SCA Approach where needed.  Independently from the SCA Approach it supports e.g. the selection of  the authentication method and a non-SCA PSU authentication.  There are several possible update PSU data requests in the context of payment initiation services needed,  which depends on the SCA approach:  * Redirect SCA Approach:   A specific update PSU data request is applicable for      * the selection of authentication methods, before choosing the actual SCA approach. * Decoupled SCA Approach:   A specific update PSU data request is only applicable for   * adding the PSU identification, if not provided yet in the payment initiation request or the account information consent request, or if no OAuth2 access token is used, or   * the selection of authentication methods. * Embedded SCA Approach:    The Update PSU Data request might be used    * to add credentials as a first factor authentication data of the PSU and   * to select the authentication method and   * transaction authorisation.  The SCA Approach might depend on the chosen SCA method.  For that reason, the following possible Update PSU data request can apply to all SCA approaches:  * Select an SCA method in case of several SCA methods are available for the customer.  There are the following request types on this access path:   * Update PSU identification   * Update PSU authentication   * Select PSU autorization method      WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.   * Transaction authorisation     WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.'
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/periodic-payments/{payment-product}/{paymentId}/cancellation-authorisations':
    post:
      tags:
        - PeriodicPayments
      summary: Start the authorisation process for the cancellation of the addressed payment
      description: 'Creates an authorisation sub-resource and start the authorisation process of the cancellation of the addressed payment.  The message might in addition transmit authentication and authorisation related data.  This method is iterated n times for a n times SCA authorisation in a  corporate context, each creating an own authorisation sub-endpoint for  the corresponding PSU authorising the cancellation-authorisation.  The ASPSP might make the usage of this access method unnecessary in case  of only one SCA process needed, since the related authorisation resource  might be automatically created by the ASPSP after the submission of the  payment data with the first POST payments/{payment-product} call.  The start authorisation process is a process which is needed for creating a new authorisation  or cancellation sub-resource.   This applies in the following scenarios:    * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding payment      initiation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be      uploaded by using the extended forms:     * ''startAuthorisationWithPsuIdentfication''     * ''startAuthorisationWithPsuAuthentication''     * ''startAuthorisationWithAuthentciationMethodSelection''    * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.   * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding      payment cancellation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be uploaded      by using the extended forms as indicated above.   * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for      executing the cancellation.   * The signing basket needs to be authorised yet.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - PeriodicPayments
      summary: Will deliver an array of resource identifications to all generated cancellation authorisation sub-resources
      description: Retrieve a list of all created cancellation authorisation sub-resources.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorisationsResponse'
              examples:
                consentAuthorizationsExample1:
                  summary: Example of valid consent authorizations
                  value: {"authorisationIds":["241b524b-c1e2-4c9b-a019-2c8097c864c2"]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/periodic-payments/{payment-product}/{paymentId}/cancellation-authorisations/{authorisationId}':
    get:
      tags:
        - PeriodicPayments
      summary: Read the SCA status of the payment cancellation's authorisation
      description: This method returns the SCA status of a payment initiation's authorisation sub-resource.
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - PeriodicPayments
      summary: Update PSU data for payment initiation cancellation
      description: 'This method updates PSU data on the cancellation authorisation resource if needed.  It may authorise a cancellation of the payment within the Embedded SCA Approach where needed.  Independently from the SCA Approach it supports e.g. the selection of  the authentication method and a non-SCA PSU authentication.  This methods updates PSU data on the cancellation authorisation resource if needed.   There are several possible update PSU data requests in the context of a cancellation authorisation within the payment initiation services needed,  which depends on the SCA approach:  * Redirect SCA Approach:   A specific Update PSU data request is applicable for      * the selection of authentication methods, before choosing the actual SCA approach. * Decoupled SCA Approach:   A specific Update PSU data request is only applicable for   * adding the PSU Identification, if not provided yet in the payment initiation request or the Account Information Consent Request, or if no OAuth2 access token is used, or   * the selection of authentication methods. * Embedded SCA Approach:    The Update PSU data request might be used    * to add credentials as a first factor authentication data of the PSU and   * to select the authentication method and   * transaction authorisation.  The SCA approach might depend on the chosen SCA method.  For that reason, the following possible update PSU data request can apply to all SCA approaches:  * Select an SCA method in case of several SCA methods are available for the customer.  There are the following request types on this access path:   * Update PSU identification   * Update PSU authentication   * Select PSU autorization method      WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.   * Transaction Authorisation     WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          description: Resource identification of the related SCA.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/payments/aspsp:
    post:
      tags:
        - SinglePayments
      summary: Performs single payment within ASPSP
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/payments/domestic:
    post:
      tags:
        - SinglePayments
      summary: Performs single  domestic payments
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  /0.8/v1/payments/foreign:
    post:
      tags:
        - SinglePayments
      summary: Performs single foreign payments
      parameters:
        - name: Consent-ID
          in: header
          schema:
            maxLength: 36
            minLength: 0
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/SinglePaymentInitiationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationRequestResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/payments/{payment-product}/{paymentId}':
    get:
      tags:
        - SinglePayments
      summary: Get payment information
      description: Returns the content of a payment object
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SinglePaymentInitiationWithStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    delete:
      tags:
        - SinglePayments
      summary: Payment cancellation request
      description: "This method initiates the cancellation of a payment.  Depending on the payment-service, the payment-product and the ASPSP's\r\n            implementation,  this TPP call might be sufficient to cancel a payment.  If an authorisation of the payment cancellation is mandated by the\r\n            ASPSP,  a corresponding hyperlink will be contained in the response message.  Cancels the addressed payment with resource identification\r\n            paymentId if applicable to the payment-service, payment-product and received in product related timelines\r\n            (e.g. before end of business day for scheduled payments of the last business day before the scheduled execution day).\r\n            The response to this DELETE command will tell the TPP whether the\r\n            * access method was rejected,\r\n            * access method was successful, or\r\n            * access method is generally applicable, but further authorisation processes are needed."
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationCancelResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/payments/{payment-product}/{paymentId}/status':
    get:
      tags:
        - SinglePayments
      summary: Payment initiation status request
      description: Check the transaction status of a payment initiation.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInitiationStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/payments/{payment-product}/{paymentId}/authorisations':
    post:
      tags:
        - SinglePayments
      summary: Start the authorisation process for a payment initiation
      description: 'Create an authorisation sub-resource and start the authorisation process.  The message might in addition transmit authentication and authorisation related data.   This method is iterated n times for a n times SCA authorisation in a  corporate context, each creating an own authorisation sub-endpoint for  the corresponding PSU authorising the transaction.  The ASPSP might make the usage of this access method unnecessary in case  of only one SCA process needed, since the related authorisation resource  might be automatically created by the ASPSP after the submission of the  payment data with the first POST payments/{payment-product} call.  The start authorisation process is a process which is needed for creating a new authorisation  or cancellation sub-resource.   This applies in the following scenarios:    * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding Payment      initiation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be      uploaded by using the extended forms:     * ''startAuthorisationWithPsuIdentfication''     * ''startAuthorisationWithPsuAuthentication''     * ''startAuthorisationWithEncryptedPsuAuthentication''     * ''startAuthorisationWithAuthentciationMethodSelection''   * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.   * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding      Payment cancellation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be uploaded      by using the extended forms as indicated above.   * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for      executing the cancellation.   * The signing basket needs to be authorised yet.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - SinglePayments
      summary: Get payment initiation authorisation sub-resources request
      description: Read a list of all authorisation subresources IDs which have been created.  This function returns an array of hyperlinks to all generated authorisation sub-resources.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorisationsResponse'
              examples:
                consentAuthorizationsExample1:
                  summary: Example of valid consent authorizations
                  value: {"authorisationIds":["241b524b-c1e2-4c9b-a019-2c8097c864c2"]}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/payments/{payment-product}/{paymentId}/authorisations/{authorisationId}':
    get:
      tags:
        - SinglePayments
      summary: Read the SCA status of the payment authorisation
      description: This method returns the SCA status of a payment initiation's authorisation sub-resource.
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - SinglePayments
      summary: Update PSU data for payment initiation
      description: 'This methods updates PSU data on the authorisation resource if needed.  It may authorise a payment within the Embedded SCA Approach where needed.  Independently from the SCA Approach it supports e.g. the selection of  the authentication method and a non-SCA PSU authentication.  There are several possible update PSU data requests in the context of payment initiation services needed,  which depends on the SCA approach:  * Redirect SCA Approach:   A specific update PSU data request is applicable for      * the selection of authentication methods, before choosing the actual SCA approach. * Decoupled SCA Approach:   A specific update PSU data request is only applicable for   * adding the PSU identification, if not provided yet in the payment initiation request or the account information consent request, or if no OAuth2 access token is used, or   * the selection of authentication methods. * Embedded SCA Approach:    The Update PSU Data request might be used    * to add credentials as a first factor authentication data of the PSU and   * to select the authentication method and   * transaction authorisation.  The SCA Approach might depend on the chosen SCA method.  For that reason, the following possible Update PSU data request can apply to all SCA approaches:  * Select an SCA method in case of several SCA methods are available for the customer.  There are the following request types on this access path:   * Update PSU identification   * Update PSU authentication   * Select PSU autorization method      WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.   * Transaction authorisation     WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.'
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
        required: true
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/payments/{payment-product}/{paymentId}/cancellation-authorisations':
    post:
      tags:
        - SinglePayments
      summary: Start the authorisation process for the cancellation of the addressed payment
      description: 'Creates an authorisation sub-resource and start the authorisation process of the cancellation of the addressed payment.  The message might in addition transmit authentication and authorisation related data.  This method is iterated n times for a n times SCA authorisation in a  corporate context, each creating an own authorisation sub-endpoint for  the corresponding PSU authorising the cancellation-authorisation.  The ASPSP might make the usage of this access method unnecessary in case  of only one SCA process needed, since the related authorisation resource  might be automatically created by the ASPSP after the submission of the  payment data with the first POST payments/{payment-product} call.  The start authorisation process is a process which is needed for creating a new authorisation  or cancellation sub-resource.   This applies in the following scenarios:    * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding payment      initiation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be      uploaded by using the extended forms:     * ''startAuthorisationWithPsuIdentfication''     * ''startAuthorisationWithPsuAuthentication''     * ''startAuthorisationWithAuthentciationMethodSelection''    * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.   * The ASPSP has indicated with a ''startAuthorisation'' hyperlink in the preceding      payment cancellation response that an explicit start of the authorisation process is needed by the TPP.      The ''startAuthorisation'' hyperlink can transport more information about data which needs to be uploaded      by using the extended forms as indicated above.   * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for      executing the cancellation.   * The signing basket needs to be authorised yet.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
          application/*+json:
            schema:
              $ref: '#/components/schemas/StartConsentAuthorizationRequestBody'
            examples:
              startAuthorizationRequestExample1:
                summary: Start the authorization process for a consent.
                value: 
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartConsentAuthorisationResponse'
              examples:
                startAuthorizationResponseExample1:
                  summary: Example of valid consent authorization
                  value: {"scaStatus":"received","authorisationId":"241b524b-c1e2-4c9b-a019-2c8097c864c2","_links":{"scaOAuth":{"href":"https://oauth2.psd2.altasoft.ge/.well-known/oauth-authorization-server"},"scaStatus":{"href":"0.8/v1/consents/beae3ef6-e219-4626-a037-af10cd937df5/authorisations/241b524b-c1e2-4c9b-a019-2c8097c864c2"}}}
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    get:
      tags:
        - SinglePayments
      summary: Will deliver an array of resource identifications to all generated cancellation authorisation sub-resources
      description: Retrieve a list of all created cancellation authorisation sub-resources.
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancellationsResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
  '/0.8/v1/payments/{payment-product}/{paymentId}/cancellation-authorisations/{authorisationId}':
    get:
      tags:
        - SinglePayments
      summary: Read the SCA status of the payment cancellation's authorisation
      description: This method returns the SCA status of a payment initiation's authorisation sub-resource.
      parameters:
        - name: payment-product
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScaStatusResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
    put:
      tags:
        - SinglePayments
      summary: Update PSU data for payment initiation cancellation
      description: 'This method updates PSU data on the cancellation authorisation resource if needed.  It may authorise a cancellation of the payment within the Embedded SCA Approach where needed.  Independently from the SCA Approach it supports e.g. the selection of  the authentication method and a non-SCA PSU authentication.  This methods updates PSU data on the cancellation authorisation resource if needed.   There are several possible update PSU data requests in the context of a cancellation authorisation within the payment initiation services needed,  which depends on the SCA approach:  * Redirect SCA Approach:   A specific Update PSU data request is applicable for      * the selection of authentication methods, before choosing the actual SCA approach. * Decoupled SCA Approach:   A specific Update PSU data request is only applicable for   * adding the PSU Identification, if not provided yet in the payment initiation request or the Account Information Consent Request, or if no OAuth2 access token is used, or   * the selection of authentication methods. * Embedded SCA Approach:    The Update PSU data request might be used    * to add credentials as a first factor authentication data of the PSU and   * to select the authentication method and   * transaction authorisation.  The SCA approach might depend on the chosen SCA method.  For that reason, the following possible update PSU data request can apply to all SCA approaches:  * Select an SCA method in case of several SCA methods are available for the customer.  There are the following request types on this access path:   * Update PSU identification   * Update PSU authentication   * Select PSU autorization method      WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.   * Transaction Authorisation     WARNING: This method needs a reduced header,      therefore many optional elements are not present.      Maybe in a later version the access path will change.'
      parameters:
        - name: payment-product
          in: path
          description: 'The addressed payment product endpoint, e.g. for SEPA Credit Transfers (SCT). The ASPSP will publish which of the payment products/endpoints will be supported.  The following payment products are supported:   - sepa-credit-transfers   - instant-sepa-credit-transfers   - target-2-payments   - cross-border-credit-transfers   - pain.001-sepa-credit-transfers   - pain.001-instant-sepa-credit-transfers   - pain.001-target-2-payments   - pain.001-cross-border-credit-transfers  **Remark:** For all SEPA Credit Transfer based endpoints which accept XML encoding,  the XML pain.001 schemes provided by EPC are supported by the ASPSP as a minimum for the body content.  Further XML schemes might be supported by some communities.  **Remark:** For cross-border and TARGET-2 payments only community wide pain.001 schemes do exist.  There are plenty of country specificic scheme variants.'
          required: true
          schema:
            $ref: '#/components/schemas/PaymentProductType'
        - name: paymentId
          in: path
          description: Resource identification of the generated payment initiation resource.
          required: true
          schema:
            type: string
        - name: authorisationId
          in: path
          description: Resource identification of the related SCA.
          required: true
          schema:
            type: string
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/UpdateConsentsPsuDataRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateConsentsPsuDataResponse'
        '400':
          description: Bad Request
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error400'
              example: {"type":"https://berlingroup.com/error-codes/FORMAT_ERROR","title":"One or more validation errors occurred.","status":400,"instance":"/v1/consents","code":"FORMAT_ERROR","additionalErrors":[{"code":"FORMAT_ERROR","title":"Digest","detail":"The Digest field is required."},{"code":"FORMAT_ERROR","title":"Signature","detail":"The Signature field is required."}],"_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '401':
          description: Unauthorized
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error401'
              example: {"type":"https://berlingroup.com/error-codes/CERTIFICATE_INVALID","status":401,"instance":"/v1/consents","code":"CERTIFICATE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '403':
          description: Forbidden
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error403'
              example: {"type":"https://berlingroup.com/error-codes/CONSENT_UNKNOWN","status":403,"instance":"/v1/consents","code":"CONSENT_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '404':
          description: Not Found
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error404'
              example: {"type":"https://berlingroup.com/error-codes/RESOURCE_UNKNOWN","status":404,"instance":"/v1/consents","code":"RESOURCE_UNKNOWN","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '405':
          description: Method Not Allowed
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error405'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_INVALID","status":405,"instance":"/v1/consents","code":"SERVICE_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '406':
          description: Not Acceptable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error406'
              example: {"type":"https://berlingroup.com/error-codes/REQUESTED_FORMATS_INVALID","status":406,"instance":"/v1/consents","code":"REQUESTED_FORMATS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '408':
          description: Request Timeout
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error408'
              example: {"type":"https://berlingroup.com/error-codes/REQUEST_TIMEOUT","status":408,"instance":"/v1/consents","code":"REQUEST_TIMEOUT","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '409':
          description: Conflict
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error409'
              example: {"type":"https://berlingroup.com/error-codes/STATUS_INVALID","status":409,"instance":"/v1/consents","code":"STATUS_INVALID","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '415':
          description: Unsupported Media Type
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error415'
              example: {"type":"https://berlingroup.com/error-codes/UNSUPPORTED_MEDIA_TYPE","status":415,"instance":"/v1/consents","code":"UNSUPPORTED_MEDIA_TYPE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '429':
          description: Too Many Requests
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error429'
              example: {"type":"https://berlingroup.com/error-codes/ACCESS_EXCEEDED","status":429,"instance":"/v1/consents","code":"ACCESS_EXCEEDED","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '500':
          description: Internal Server Error
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error500'
              example: {"type":"https://berlingroup.com/error-codes/INTERNAL_SERVER_ERROR","status":500,"instance":"/v1/consents","code":"INTERNAL_SERVER_ERROR","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
        '503':
          description: Service Unavailable
          headers:
            X-Request-ID:
              description: 'ID of the request, unique to the call, as determined by the initiating party.'
              required: true
              schema:
                type: string
                format: uuid
            Digest:
              description: The digest of the response.
              required: true
              schema:
                type: string
            X-Jws-Signature:
              description: JWS signature.
              required: true
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error503'
              example: {"type":"https://berlingroup.com/error-codes/SERVICE_UNAVAILABLE","status":503,"instance":"/v1/consents","code":"SERVICE_UNAVAILABLE","_links":{},"traceId":"00-4d8a7024a02bba4085b12f118f524e97-a062de5fc826614c-00"}
components:
  schemas:
    AccountAccess:
      type: object
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/AccountReference'
          description: "Is asking for detailed account information. If the array is empty in a request, the TPP is asking for an accessible account list.\r\nThis may be restricted in a PSU/ASPSP authorization dialogue.\r\nIf the array is empty, also the arrays for balances, additionalInformation sub attributes or transactions shall be empty, if used."
          nullable: true
        balances:
          type: array
          items:
            $ref: '#/components/schemas/AccountReference'
          description: "Is asking for balances of the addressed accounts.\r\nIf the array is empty in the request, the TPP is asking for the balances of all accessible account lists.\r\nThis may be restricted in a PSU/ASPSP authorization dialogue.\r\nIf the array is empty, also the arrays for accounts, additionalInformation sub attributes or transactions shall be empty, if used."
          nullable: true
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/AccountReference'
          description: "Is asking for transactions of the addressed accounts.\r\nIf the array is empty in the request, the TPP is asking for the transactions of all accessible account lists.\r\nThis may be restricted in a PSU/ASPSP authorization dialogue.\r\nIf the array is empty, also the arrays for accounts, additionalInformation sub attributes or balances shall be empty, if used."
          nullable: true
        additionalInformation:
          $ref: '#/components/schemas/AdditionalInformationAccess'
        availableAccounts:
          $ref: '#/components/schemas/AvailableAccounts'
        availableAccountsWithBalance:
          $ref: '#/components/schemas/AvailableAccounts'
        allPsd2:
          $ref: '#/components/schemas/AvailableAccounts'
        restrictedTo:
          type: array
          items:
            $ref: '#/components/schemas/ExternalCashAccountType1Code'
          description: "<br>\r\n            If the TPP requests access to accounts via availableAccounts(List of available accounts), global or bank driven consents, the TPP may include this element to restrict access to the referred account types.\r\n            Absence of the element is interpreted as \"no restriction\" (therefore access to accounts of all types is requested).\r\n            The element may only occur, if each of the elements\r\n            - accounts\r\n            - balances\r\n            - transactions\r\n            is either not present or contains an empty array.\r\n            \r\n<br>\r\n            (13)-ის თანახმად, აღნიშნული ატრიბუტის მხარდაჭერა შესაძლოა შეწყდეს XS2A-ს შემდეგ ვერსიებში.\r\n            ამდენად, მისი გამოყენება არარეკომენდებულია.\r\n            თუ ატრიბუტი მხარდაჭერილი არ არის, აუცილებელია ამსმპ-მა იმოქმედოს ისე,  თითქოს იგი საერთოდ არ მოსულა დოკუმენტში.\r\n            "
          nullable: true
      additionalProperties: { }
      description: Requested access services for a consent.
    AccountDetails:
      type: object
      properties:
        resourceId:
          type: string
          description: 'This shall be filled, if addressable resource are created by the ASPSP on the /accounts or /card-accounts endpoint.'
          nullable: true
        iban:
          pattern: '[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}'
          type: string
          description: IBAN of an account
          nullable: true
        msisdn:
          maxLength: 35
          minLength: 0
          type: string
          description: Mobile phone number.
          nullable: true
        currency:
          pattern: '[A-Z]{3}'
          type: string
          description: ISO 4217 Alpha 3 currency code.
          nullable: true
        name:
          maxLength: 70
          minLength: 0
          type: string
          description: 'Name of the account, as assigned by the ASPSP, in agreement with the account owner in order to provide an additional means of identification of the account.'
          nullable: true
        displayName:
          maxLength: 70
          minLength: 0
          type: string
          description: Name of the account as defined by the PSU within online channels.
          nullable: true
        product:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Product name of the bank for this account, proprietary definition.'
          nullable: true
        cashAccountType:
          $ref: '#/components/schemas/ExternalCashAccountType1Code'
        status:
          $ref: '#/components/schemas/AccountStatus'
        bic:
          pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}'
          type: string
          description: Bank Identification Code (BIC)
          nullable: true
        linkedAccounts:
          maxLength: 70
          minLength: 0
          type: string
          description: 'In case of a set of pending card transactions, the ASPSP will provide the relevant cash account the card is set up on.'
          nullable: true
        usage:
          $ref: '#/components/schemas/AccountUsage'
        details:
          maxLength: 500
          minLength: 0
          type: string
          description: "Specifications that might be provided by the ASPSP:\r\n    - characteristics of the account\r\n    - characteristics of the relevant card"
          nullable: true
        balances:
          type: array
          items:
            $ref: '#/components/schemas/Balance'
          description: 'A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance.'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: Gets or Sets Links
          nullable: true
        owner:
          maxLength: 140
          minLength: 0
          type: string
          description: "<br>Name of the legal account owner. If there is more than one owner, then e.g. two names might be noted here.\r\n<br>\r\n            For a corporate account, the corporate name is used for this attribute. Even if supported by the ASPSP,\r\n            the provision of this field might depend on the fact whether an explicit consent to this specific\r\n            additional account information has been given by the PSU.\r\n            "
          nullable: true
        partyIdentification:
          $ref: '#/components/schemas/PartyIdentification'
      additionalProperties: false
      description: "The ASPSP shall give at least one of the account reference identifiers:\r\n- iban\r\n- bban\r\n- pan\r\n- maskedPan\r\n- msisdn\r\nIf the account is a multicurrency account currency code in 'currency' is set to 'XXX'."
    AccountReference:
      type: object
      properties:
        iban:
          pattern: '[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}'
          type: string
          nullable: true
        bban:
          pattern: '[a-zA-Z0-9]{1,30}'
          type: string
          nullable: true
        pan:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        maskedPan:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        msisdn:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        currency:
          pattern: '[A-Z]{3}'
          type: string
          nullable: true
        cashAccountType:
          $ref: '#/components/schemas/ExternalCashAccountType1Code'
        other:
          $ref: '#/components/schemas/OtherIdentification'
        name:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
      additionalProperties: { }
    AccountReport:
      type: object
      properties:
        booked:
          type: array
          items:
            $ref: '#/components/schemas/TransactionDetails'
          description: Shall be contained if bookingStatus parameter is set to "booked" or "both"
          nullable: true
        pending:
          type: array
          items:
            $ref: '#/components/schemas/TransactionDetails'
          description: Is not contained if the bookingStatus parameter is set to "booked" or "information".
          nullable: true
        information:
          type: array
          items:
            $ref: '#/components/schemas/TransactionDetails'
          description: Only contained if the bookingStatus is set to "information" and if supported by ASPSP.
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: "The following links might be used within this context:\r\n* account (mandatory) '\r\n* first (optional) '\r\n* next (optional) '\r\n* previous (optional) '\r\n* last (optional)"
          nullable: true
      additionalProperties: false
      description: "JSON based account report.\r\nThis account report contains transactions resulting from the query parameters.\r\n    * 'booked' shall be contained if bookingStatus parameter is set to 'booked' or 'both'.\r\n    * 'pending' is not contained if the bookingStatus parameter is set to \"booked\" or \"information\".\r\n    * 'information' Only contained if the bookingStatus is set to \"information\" and if supported by ASPSP."
    AccountStatus:
      enum:
        - enabled
        - deleted
        - blocked
      type: string
      description: "Account status. The value is one of the following:\r\n* enabled: account is available\r\n* deleted: account is terminated\r\n* blocked: account is blocked e.g. for legal reasons If this field is not used, than the account is available in the sense of this specification."
    AccountUsage:
      enum:
        - PRIV
        - ORGA
      type: string
      description: "Specifies the usage of the account:\r\n    * PRIV: private personal account\r\n    * ORGA: professional account"
    AdditionalInformationAccess:
      type: object
      properties:
        ownerName:
          type: array
          items:
            $ref: '#/components/schemas/AccountReference'
          description: "Is asking for account owner name of the accounts referenced within.\r\nIf the array is empty in the request, the TPP is asking for the account\r\nowner name of all accessible accounts.\r\nThis may be restricted in a PSU/ASPSP authorization dialogue.\r\nIf the array is empty, also the arrays for accounts, balances or transactions shall be empty, if used. The ASPSP will indicate in the consent resource after a successful authorisation,\r\nwhether the ownerName consent can be accepted by providing the accounts on which the ownerName will\r\nbe delivered.\r\nThis array can be empty."
          nullable: true
        trustedBeneficiaries:
          type: array
          items:
            $ref: '#/components/schemas/AccountReference'
          description: "Optional if supported by API provider. Is asking for the trusted beneficiaries related to the accounts referenced within and related to the PSU. If the array is empty in the request, the TPP is asking for the lists of trusted beneficiaries of all accessible accounts.\r\nThis may be restricted in a PSU/ASPSP authorization dialogue by the PSU if also the account lists addressed\r\nby the tags “accounts”, “balances” or “transactions” are empty. The ASPSP will indicate in the consent resource after a successful authorisation,\r\nwhether the trustedBeneficiaries consent can be accepted by providing the accounts on which the list of trusted beneficiaries will be delivered.\r\nThis array can be empty."
          nullable: true
      additionalProperties: { }
      description: "Optional if supported by API provider.\r\nIs asking for additional information as added within this structured object.\r\nThe usage of this data element requires at least one of the entries \\\"accounts\\\",  \\\"transactions\\\" or \\\"balances\\\" also to be contained in the object.\r\nIf detailed accounts are referenced, it is required in addition that any account addressed within\r\nthe additionalInformation attribute is also addressed by at least one of the attributes \\\"accounts\\\",  \\\"transactions\\\" or \\\"balances\\\"."
    AdditionalInformationStructured:
      required:
        - standingOrderDetails
      type: object
      properties:
        standingOrderDetails:
          $ref: '#/components/schemas/StandingOrderDetails'
      additionalProperties: false
      description: Is used if and only if the bookingStatus entry equals \"information\".  Every active standing order related to the dedicated payment account result into one entry.
    Address:
      required:
        - country
      type: object
      properties:
        streetName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        buildingNumber:
          type: string
          nullable: true
        townName:
          type: string
          nullable: true
        postCode:
          type: string
          nullable: true
        country:
          minLength: 1
          pattern: '[A-Z]{2}'
          type: string
      additionalProperties: { }
    Amount:
      required:
        - amount
        - currency
      type: object
      properties:
        currency:
          maxLength: 3
          minLength: 3
          pattern: '[A-Z]{3}'
          type: string
        amount:
          minLength: 1
          pattern: '-?[0-9]{1,14}(\.[0-9]{1,3})?'
          type: string
      additionalProperties: { }
    AuthenticationObject:
      required:
        - authenticationMethodId
        - authenticationType
        - name
      type: object
      properties:
        authenticationType:
          $ref: '#/components/schemas/AuthenticationType'
        authenticationVersion:
          type: string
          nullable: true
        authenticationMethodId:
          maxLength: 35
          minLength: 0
          type: string
        name:
          minLength: 1
          type: string
        explanation:
          type: string
          nullable: true
      additionalProperties: false
    AuthenticationType:
      enum:
        - SMS_OTP
        - CHIP_OTP
        - PHOTO_OTP
        - PUSH_OTP
        - SMTP_OTP
      type: string
    AuthorisationConfirmation:
      required:
        - confirmationCode
      type: object
      properties:
        confirmationCode:
          minLength: 1
          type: string
          description: Confirmation Code as retrieved by the TPP from the redirect based SCA process.
      additionalProperties: { }
      description: Content of the body of an authorisation confirmation request
    AuthorisationConfirmationResponse:
      type: object
      properties:
        scaStatus:
          $ref: '#/components/schemas/ScaStatusAuthorisationConfirmation'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: A list of hyperlinks.
          nullable: true
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Text to be displayed to the PSU
          nullable: true
      additionalProperties: false
      description: Authorization Process Confirmation Response
    AuthorisationsResponse:
      required:
        - authorisationIds
      type: object
      properties:
        authorisationIds:
          type: array
          items:
            type: string
          description: Gets or Sets AuthorisationIds
      additionalProperties: false
      description: An array of all authorisationIds.
    AvailableAccounts:
      enum:
        - allAccounts
        - allAccountsWithOwnerName
      type: string
      description: "Optional if supported by API provider.\r\nThe values \"allAccounts\" and \"allAccountsWithOwnerName\" are admitted.\r\nThe support of the \"allAccountsWithOwnerName\" value by the ASPSP is optional."
    Balance:
      required:
        - balanceAmount
      type: object
      properties:
        balanceAmount:
          $ref: '#/components/schemas/Amount'
        balanceType:
          $ref: '#/components/schemas/BalanceType'
        creditLimitIncluded:
          type: boolean
          description: 'A flag indicating if the credit limit of the corresponding account is included in the calculation of the balance, where applicable.'
          nullable: true
        lastChangeDateTime:
          type: string
          description: 'This data element might be used to indicate e.g. with the expected or booked balance that no action is known on the account, which is not yet booked.'
          format: date-time
          nullable: true
        referenceDate:
          type: string
          description: Indicates the date of the balance.
          format: date
          nullable: true
        lastCommittedTransaction:
          maxLength: 35
          minLength: 0
          type: string
          description: '''entryReference'' of the last committed transaction to support the TPP in identifying whether all  PSU transactions are already known.'
          nullable: true
      additionalProperties: false
      description: A single balance element.
    BalanceType:
      enum:
        - closingBooked
        - expected
        - openingBooked
        - interimAvailable
        - interimBooked
        - forwardAvailable
        - nonInvoiced
      type: string
      description: "<br>The following balance types are defined:\r\n<br>\r\n             *  \"closingBooked\":\r\n                    Balance of the account at the end of the pre-agreed account reporting period.\r\n                    It is the sum of the opening booked balance at the beginning of the period and all entries booked\r\n                    to the account during the pre-agreed account reporting period.\r\n                    For card-accounts, this is composed of:\r\n                        - invoiced, but not yet paid entries\r\n             *   \"expected\":\r\n                    Balance composed of booked entries and pending items known at the time of calculation,\r\n                    which projects the end of day balance if everything is booked on the account and no other entry is posted.\r\n                    For card accounts, this is composed of:\r\n                        - invoiced, but not yet paid entries\r\n                        - not yet invoiced but already booked entries and\r\n                        - pending items (not yet booked)\r\n                    For card-accounts: \\\"money to spend with the value of a pre-approved credit limit on the card account\\\"\r\n             *  \"openingBooked\":\r\n                    Book balance of the account at the beginning of the account reporting period.\r\n                    It always equals the closing book balance from the previous report.\r\n             *   \"interimAvailable\":\r\n                    Available balance calculated in the course of the account servicer's business day,\r\n                    at the time specified, and subject to further changes during the business day.\r\n                    The interim balance is calculated on the basis of booked credit and debit items during the calculation\r\n                    time/period specified.\r\n                    For card-accounts, this is composed of:\r\n                        - invoiced, but not yet paid entries\r\n                        - not yet invoiced but already booked entries\r\n                        - \\\"interimBooked\\\":\r\n                    Balance calculated in the course of the account servicer's business day, at the time specified,\r\n                    and subject to further changes during the business day.\r\n                    The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period\r\n                    specified.\r\n             *   \"forwardAvailable\":\r\n                    Forward available balance of money that is at the disposal of the account owner on the date specified.\r\n             *   \"nonInvoiced\":\r\n                    Only for card accounts, to be checked yet.\r\n            "
    BookingStatus:
      enum:
        - booked
        - pending
        - both
        - information
        - all
      type: string
      description: "Permitted codes are \"booked\", \"pending\",\r\n\"both\" and “information”.\r\n\"booked\" shall be supported by the\r\nASPSP.\r\nTo support the \"pending\" and \"both\" feature\r\nis optional for the ASPSP, Error code if not\r\nsupported in the online banking frontend. If\r\nsupported, \"both\" means to request\r\ntransaction reports of transaction of\r\nbookingStatus either \"pending\" or\r\n\"booked\".\r\nTo support the \"information\" feature is\r\noptional for the ASPSP. Currently the\r\nbooking status “information” only covers\r\nstanding orders. Error code if not\r\nsupported."
    BulkPaymentInitiationRequest:
      required:
        - payments
      type: object
      properties:
        batchBookingPreferred:
          type: boolean
          nullable: true
        requestedExecutionDate:
          type: string
          format: date
          nullable: true
        acceptorTransactionDateTime:
          type: string
          format: date-time
          nullable: true
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        paymentInformationId:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        payments:
          type: array
          items:
            $ref: '#/components/schemas/PaymentInitiationRequestBase'
      additionalProperties: { }
    CancellationsResponse:
      required:
        - cancellationIds
      type: object
      properties:
        cancellationIds:
          type: array
          items:
            type: string
      additionalProperties: false
    CardAccountByIdResponse:
      required:
        - cardAccount
      type: object
      properties:
        cardAccount:
          $ref: '#/components/schemas/CardAccountDetails'
      additionalProperties: false
      description: Card Account Data
    CardAccountDetails:
      required:
        - currency
        - maskedPan
      type: object
      properties:
        resourceId:
          type: string
          description: "This is the data element to be used in the path when retrieving data from a dedicated account.\r\nThis shall be filled, if addressable resource are created by the ASPSP on the /card-accounts endpoint."
          nullable: true
        maskedPan:
          maxLength: 35
          minLength: 0
          type: string
          description: "Primary Account Number (PAN) of the card in masked form.\r\nIn the context of a response to a \"/card-accounts\" endpoint, this is the PAN of the main card;\r\nin the context of a \"/cards\" endpoint, this identifies the specific card for that the information is presented.\r\nThis data element can be used in the body of the Consent Request Message for retrieving account access consent from this card.."
        currency:
          maxLength: 3
          minLength: 3
          pattern: '[A-Z]{3}'
          type: string
          description: ISO 4217 Alpha 3 currency code.
        debitAccounting:
          type: boolean
          description: "If true, the amounts of debits on the reports are quoted positive with the related consequence for balances.\r\nIf false, the amount of debits on the reports are quoted negative."
          nullable: true
        ownerName:
          maxLength: 140
          minLength: 0
          type: string
          description: " Name of the legal account owner. If there is more than one owner, then e.g. two names might be noted here.\r\nFor a corporate account, the corporate name is used for this attribute.Even if supported by the ASPSP,\r\nthe provision of this field might depend on the fact whether an explicit consent to this specific additional account information\r\nhas been given by the PSU."
          nullable: true
        name:
          maxLength: 70
          minLength: 0
          type: string
          description: "Name of the account, as assigned by the ASPSP,  in agreement with the account owner in order to\r\nprovide an additional means of identification of the account."
          nullable: true
        displayName:
          maxLength: 70
          minLength: 0
          type: string
          description: Name of the account as defined by the PSU within online channels.
          nullable: true
        product:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Product Name of the Bank for this card/card account, proprietary definition.'
          nullable: true
        status:
          $ref: '#/components/schemas/AccountStatus'
        usage:
          $ref: '#/components/schemas/AccountUsage'
        details:
          maxLength: 500
          minLength: 0
          type: string
          description: "Specifications that might be provided by the ASPSP:\r\n*characteristics of the account,\r\n*characteristics of the relevant card"
          nullable: true
        creditLimit:
          $ref: '#/components/schemas/Amount'
        balances:
          type: array
          items:
            $ref: '#/components/schemas/Balance'
          description: "The specific card account balances associated to this card / card account.\r\nIn the context of a response to a \"cards\" endpoint, each balance that indicates\r\nthat credit limit is included must respect all applicable credit limits relevant for this card ( cp. Section 6.6)"
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: "Links to the card account/card, which can be directly used for retrieving account information from this dedicated account. Links to \"balances\" and/or\r\n\"transactions\" These links are only supported, when the corresponding consent has been already granted."
          nullable: true
      additionalProperties: false
      description: Card account details.
    CardAccountReport:
      required:
        - _links
        - booked
      type: object
      properties:
        booked:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionDetails'
          description: Array of transaction details.
        pending:
          type: array
          items:
            $ref: '#/components/schemas/CardTransactionDetails'
          description: Gets or Sets Pending
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: Gets or Sets Links
      additionalProperties: false
      description: JSON based card account report.  This card account report contains transactions resulting from the query parameters.
    CardAccountsTransactionsResponse:
      type: object
      properties:
        cardAccount:
          $ref: '#/components/schemas/AccountReference'
        cardTransactions:
          $ref: '#/components/schemas/CardAccountReport'
        balances:
          type: array
          items:
            $ref: '#/components/schemas/Balance'
          description: "A list of balances regarding this account,\r\nwhich might be restricted to the current balance"
          nullable: true
      additionalProperties: false
      description: "Body of the JSON response for a successful read card account transaction list request.\r\nThis card account report contains transactions resulting from the query parameters."
    CardTransactionDetails:
      required:
        - transactionAmount
      type: object
      properties:
        cardTransactionId:
          maxLength: 35
          minLength: 0
          type: string
          description: Unique end to end identity.
          nullable: true
        terminalId:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Identification of the Terminal, where the card has been used.'
          nullable: true
        transactionDate:
          type: string
          description: Date of the actual card transaction.
          format: date
          nullable: true
        acceptorTransactionDateTime:
          type: string
          description: Timestamp of the actual card transaction within the acceptance system
          format: date-time
          nullable: true
        bookingDate:
          type: string
          description: The date when an entry is posted to an account on the ASPSPs books.
          format: date
          nullable: true
        transactionAmount:
          $ref: '#/components/schemas/Amount'
        currencyExchange:
          type: array
          items:
            $ref: '#/components/schemas/ForeignExchangeRate'
          description: 'For card accounts, this often is restricted by the ASPSP to use only one exchange rate'
          nullable: true
        originalAmount:
          $ref: '#/components/schemas/Amount'
        markupFee:
          $ref: '#/components/schemas/Amount'
        markupFeePercentage:
          type: string
          description: 'Percentage of the involved transaction fee in relation to the billing amount, e.g. "0.3" for 0,3%'
          nullable: true
        cardAcceptorId:
          maxLength: 35
          minLength: 0
          type: string
          description: Identification of the Card Acceptor (e.g. merchant) as given in the related card transaction.
          nullable: true
        cardAcceptorAddress:
          $ref: '#/components/schemas/Address'
        cardAcceptorPhone:
          pattern: '\+[0-9]{1,3}\-[0-9()+\-]{1,30}'
          type: string
          description: Merchant phone number
          nullable: true
        merchantCategoryCode:
          maxLength: 4
          minLength: 0
          type: string
          description: Merchant Category Code of the Card Acceptor as given in the related card transaction
          nullable: true
        maskedPAN:
          maxLength: 35
          minLength: 0
          type: string
          description: The masked PAN of the card used in the transaction.
          nullable: true
        transactionDetails:
          maxLength: 140
          minLength: 0
          type: string
          description: Additional details given for the related card transactions.
          nullable: true
        invoiced:
          type: boolean
          description: Flag indicating whether the underlying card transaction is already invoiced.
          nullable: true
        proprietaryBankTransactionCode:
          maxLength: 35
          minLength: 0
          type: string
          description: proprietary bank transaction code as used within a community or within an ASPSP e.g. for MT94x based transaction reports
          nullable: true
      additionalProperties: false
      description: Card transaction information.
    ChallengeData:
      type: object
      properties:
        image:
          type: string
          description: 'PNG data (max. 512 kilobyte) to be displayed to the PSU, Base64 encoding, cp. [RFC4648]. This attribute is used only, when PHOTO_OTP or CHIP_OTP is the selected SCA method.'
          format: byte
          nullable: true
        data:
          type: array
          items:
            type: string
          description: A collection of strings as challenge data.
          nullable: true
        imageLink:
          type: string
          description: A link where the ASPSP will provides the challenge image for the TPP.
          nullable: true
        otpMaxLength:
          type: integer
          description: The maximal length for the OTP to be typed in by the PSU.
          format: int32
          nullable: true
        otpFormat:
          $ref: '#/components/schemas/OtpFormat'
        additionalInformation:
          type: string
          description: Additional explanation for the PSU to explain e.g. fallback mechanism for the chosen SCA method. The TPP is obliged to show this to the PSU.
          nullable: true
      additionalProperties: false
      description: It is contained in addition to the data element 'chosenScaMethod' if challenge data is needed for SCA. In rare cases this attribute is also used in the context of the 'startAuthorisationWithPsuAuthentication' link.
    ChargeBearer:
      enum:
        - CRED
        - DEBT
        - SHAR
        - SLEV
      type: string
    ConsentStatus:
      enum:
        - received
        - rejected
        - valid
        - revokedByPsu
        - expired
        - terminatedByTpp
        - partiallyAuthorised
      type: string
      description: "This is the overall lifecycle status of the consent. Valid values are:\r\n* 'received': The consent data have been received and are technically correct. The data is not authorized yet.\r\n* 'rejected': The consent data have been rejected e.g. since no successful authorization has taken place.\r\n* 'valid': The consent is accepted and valid for GET account data calls and others as specified in the consent object.\r\n* 'revokedByPsu': The consent has been revoked by the PSU towards the ASPSP.\r\n* 'expired': The consent expired.\r\n* 'terminatedByTpp': The corresponding TPP has terminated the consent by applying the DELETE method to the consent resource.\r\n* 'partiallyAuthorised': The consent is due to a multi-level authorization, some but not all mandated authorizations have been performed yet.\r\nThe ASPSP might add further codes. These codes then shall be contained in the ASPSP's documentation of the XS2A interface  and has to be added to this API definition as well."
    CreateConsentRequestBody:
      required:
        - access
        - combinedServiceIndicator
        - frequencyPerDay
        - recurringIndicator
      type: object
      properties:
        access:
          $ref: '#/components/schemas/AccountAccess'
        recurringIndicator:
          type: boolean
          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.'
        validUntil:
          type: string
          description: "This parameter is defining a valid until date (including the mentioned date)\r\nfor the requested consent. The content is the local ASPSP date in ISO-Date format, e.g. 2017-10-30."
          format: date
        frequencyPerDay:
          type: integer
          description: "This field indicates the requested maximum frequency for an access without PSU involvement per day. For a one-off access, this attribute is set to \"1\".\r\nThe frequency needs to be greater equal to one.\r\nIf not otherwise agreed bilaterally between TPP and ASPSP, the frequency is less equal to 4."
          format: int32
        combinedServiceIndicator:
          type: boolean
          description: "If 'true' indicates that a payment initiation service will be addressed in the same 'session'.\r\nკომბინირებული სერვისები წინამდებარე დოკუმენტის ამ ვერსიის მიზნებისათვის, აუცილებელია,\r\ncombinedServiceIndicator ველში მიეთითოს მნიშვნელობა false,\r\nვინაიდან გადახდის ინიცირების მომსახურება ამ ვერსიაში განსაზღვრული არ არის."
      additionalProperties: { }
      description: Content of the body of a consent request.
    CreateConsentResponse:
      type: object
      properties:
        consentStatus:
          $ref: '#/components/schemas/ConsentStatus'
        consentId:
          type: string
          description: Gets or Sets ConsentId
          nullable: true
        scaMethods:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationObject'
          description: Gets or Sets ScaMethods
          nullable: true
        chosenScaMethod:
          $ref: '#/components/schemas/AuthenticationObject'
        challengeData:
          $ref: '#/components/schemas/ChallengeData'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: Gets or Sets Links
          nullable: true
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Text to be displayed to the PSU
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a successful consent request.
    DayOfExecution:
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
        - '7'
        - '8'
        - '9'
        - '10'
        - '11'
        - '12'
        - '13'
        - '14'
        - '15'
        - '16'
        - '17'
        - '18'
        - '19'
        - '20'
        - '21'
        - '22'
        - '23'
        - '24'
        - '25'
        - '26'
        - '27'
        - '28'
        - '29'
        - '30'
        - '31'
      type: string
    EntryDetailsElement:
      required:
        - transactionAmount
      type: object
      properties:
        endToEndId:
          maxLength: 35
          minLength: 0
          type: string
          description: Unique end to end identity.
          nullable: true
        mandateId:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Identification of Mandates, e.g. a SEPA Mandate ID.'
          nullable: true
        checkId:
          maxLength: 35
          minLength: 0
          type: string
          description: Identification of a Cheque.
          nullable: true
        creditorId:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Identification of Creditors, e.g. a SEPA Creditor ID.'
          nullable: true
        transactionAmount:
          $ref: '#/components/schemas/Amount'
        currencyExchange:
          type: array
          items:
            $ref: '#/components/schemas/ForeignExchangeRate'
          description: Array of exchange rates.
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          description: Name of the creditor if a "Debited" transaction
          nullable: true
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}'
          type: string
          description: Creditor Agent BIC
          nullable: true
        ultimateCreditor:
          maxLength: 70
          minLength: 0
          type: string
          description: Ultimate creditor.
          nullable: true
        debtorName:
          maxLength: 70
          minLength: 0
          type: string
          description: Debtor Name
          nullable: true
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        debtorAgent:
          pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}'
          type: string
          description: BIC
          nullable: true
        ultimateDebtor:
          maxLength: 70
          minLength: 0
          type: string
          description: Ultimate Debtor
          nullable: true
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          description: "Unstructured remittance information.\r\nდანიშნულება"
          nullable: true
        remittanceInformationUnstructuredArray:
          type: array
          items:
            type: string
          description: Might be used by the ASPSP to transport additional transaction related information to the PSU
          nullable: true
        remittanceInformationStructured:
          maxLength: 140
          minLength: 0
          type: string
          description: Structured remittance information Max
          nullable: true
        remittanceInformationStructuredArray:
          type: array
          items:
            $ref: '#/components/schemas/RemittanceInformationStructured'
          description: Gets or Sets RemittanceInformationStructuredArray
          nullable: true
        purposeCode:
          $ref: '#/components/schemas/PurposeCode'
      additionalProperties: false
    Error400:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode400'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode400AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error401:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode401'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode401AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error403:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode403'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode403AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error404:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode404'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode404AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error405:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode405'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode405AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error406:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode406'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode406AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error408:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode408'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode408AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error409:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode409'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode409AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error415:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode415'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode415AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error429:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          $ref: '#/components/schemas/MessageCode429'
        additionalErrors:
          type: array
          items:
            $ref: '#/components/schemas/MessageCode429AdditionalError'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error500:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    Error503:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: { }
    ExecutionRule:
      enum:
        - following
        - preceding
      type: string
    ExternalCashAccountType1Code:
      enum:
        - CACC
        - CARD
        - CASH
        - CHAR
        - CISH
        - COMM
        - CPAC
        - LLSV
        - LOAN
        - MGLD
        - MOMA
        - NREX
        - ODFT
        - ONDP
        - OTHR
        - SACC
        - SLRY
        - SVGS
        - TAXE
        - TRAN
        - TRAS
      type: string
    ForeignExchangeRate:
      required:
        - exchangeRate
        - sourceCurrency
        - targetCurrency
        - unitCurrency
      type: object
      properties:
        sourceCurrency:
          minLength: 1
          pattern: '[A-Z]{3}'
          type: string
          description: Currency from which an amount is to be converted in a currency conversion.
        exchangeRate:
          minLength: 1
          type: string
          description: Factor used to convert an amount from one currency into another. This reflects the price at which one currency was bought with another currency.
        unitCurrency:
          minLength: 1
          type: string
          description: "Currency in which the rate of exchange is expressed in a currency exchange.\r\nIn the example 1EUR = xxxCUR, the unit currency is EUR."
        targetCurrency:
          minLength: 1
          type: string
          description: Currency into which an amount is to be converted in a currency conversion.
        quotationDate:
          type: string
          description: Date at which an exchange rate is quoted
          format: date
        contractIdentification:
          type: string
          description: Unique identification to unambiguously identify the foreign exchange contract.
          nullable: true
      additionalProperties: false
      description: Exchange Rate.
    FrequencyCode:
      enum:
        - Daily
        - Weekly
        - EveryTwoWeeks
        - Monthly
        - EveryTwoMonths
        - Quarterly
        - SemiAnnual
        - Annual
        - MonthlyVariable
      type: string
    GetAccountListResponse:
      type: object
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/AccountDetails'
          description: Gets or Sets Accounts
          nullable: true
      additionalProperties: false
      description: List of accounts with details.
    GetBalancesResponse:
      type: object
      properties:
        account:
          $ref: '#/components/schemas/AccountReference'
        balances:
          type: array
          items:
            $ref: '#/components/schemas/Balance'
          description: 'A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance.'
          nullable: true
      additionalProperties: false
      description: Body of the response for a successful read balance for an account request.
    GetCardAccountBalancesResponse:
      required:
        - balances
      type: object
      properties:
        cardAccount:
          $ref: '#/components/schemas/AccountReference'
        balances:
          type: array
          items:
            $ref: '#/components/schemas/Balance'
          description: "A list of balances regarding this account, e.g.\r\nthe current balance, the last booked balance. The list might be restricted to the current balance."
      additionalProperties: false
      description: Body of the response for a successful read balance for a card account request.
    GetCardAccountListResponse:
      required:
        - cardAccounts
      type: object
      properties:
        cardAccounts:
          type: array
          items:
            $ref: '#/components/schemas/CardAccountDetails'
          description: List of card accounts with details.
      additionalProperties: false
      description: Card Account Details
    GetConsentInformationResponse:
      type: object
      properties:
        access:
          $ref: '#/components/schemas/AccountAccess'
        recurringIndicator:
          type: boolean
          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.'
        validUntil:
          type: string
          description: "This parameter is defining a valid until date (including the mentioned date)\r\nfor the requested consent. The content is the local ASPSP date in ISO-Date format, e.g. 2017-10-30.\r\nFuture dates might get adjusted by ASPSP.\r\nIf a maximal available date is requested, a date in far future is to be used: \"9999-12-31\".\r\nIn both cases the consent object to be retrieved by the get consent request will contain the adjusted date."
          format: date
        frequencyPerDay:
          type: integer
          description: "This field indicates the requested maximum frequency for an access without PSU involvement per day. For a one-off access, this attribute is set to \"1\".\r\nThe frequency needs to be greater equal to one.\r\nIf not otherwise agreed bilaterally between TPP and ASPSP, the frequency is less equal to 4."
          format: int32
        lastActionDate:
          type: string
          description: "This date is containing the date of the last action on the consent object either through the XS2A interface\r\nor the PSU/ASPSP interface having an impact on the status"
          format: date
        consentStatus:
          $ref: '#/components/schemas/ConsentStatus'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: "A list of hyperlinks to be recognized by the TPP.\r\n\"account\" and/or \"cardAccount\","
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a successful get consent request.
    GetConsentStatusResponse:
      type: object
      properties:
        consentStatus:
          $ref: '#/components/schemas/ConsentStatus'
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Text to be displayed to the PSU
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a successful get status request for a consent.
    GetTransactionDetailsResponse:
      type: object
      properties:
        transactionsDetails:
          $ref: '#/components/schemas/TransactionDetails'
      additionalProperties: false
      description: Transaction Details Response
    GetTransactionListResponse:
      type: object
      properties:
        account:
          $ref: '#/components/schemas/AccountReference'
        transactions:
          $ref: '#/components/schemas/AccountReport'
        balances:
          type: array
          items:
            $ref: '#/components/schemas/Balance'
          description: 'A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance.'
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: "List of hyperlinks to be recognised by the TPP.\r\nType of links admitted in this response:\r\n\"download\": a link to a resource, where the transaction report might be downloaded from in case where transaction reports have a huge size.\r\nRemark: This feature shall only be used where camt-data is requested which has a huge size."
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a successful read transaction list request. This account report contains transactions resulting from the query parameters.
    HrefType:
      required:
        - href
      type: object
      properties:
        href:
          minLength: 1
          type: string
      additionalProperties: false
    MessageCode2XX:
      enum:
        - WARNING
      type: string
    MessageCode400:
      enum:
        - FORMAT_ERROR
        - PARAMETER_NOT_CONSISTENT
        - PARAMETER_NOT_SUPPORTED
        - SERVICE_INVALID
        - RESOURCE_UNKNOWN
        - RESOURCE_EXPIRED
        - RESOURCE_BLOCKED
        - TIMESTAMP_INVALID
        - PERIOD_INVALID
        - SCA_METHOD_UNKNOWN
        - SCA_INVALID
        - CONSENT_UNKNOWN
        - SESSIONS_NOT_SUPPORTED
        - PAYMENT_FAILED
        - EXECUTION_DATE_INVALID
      type: string
    MessageCode400AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode400'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode401:
      enum:
        - CERTIFICATE_INVALID
        - ROLE_INVALID
        - CERTIFICATE_EXPIRED
        - CERTIFICATE_BLOCKED
        - CERTIFICATE_REVOKED
        - CERTIFICATE_MISSING
        - SIGNATURE_INVALID
        - SIGNATURE_MISSING
        - CORPORATE_ID_INVALID
        - PSU_CREDENTIALS_INVALID
        - CONSENT_INVALID
        - CONSENT_EXPIRED
        - TOKEN_UNKNOWN
        - TOKEN_INVALID
        - TOKEN_EXPIRED
        - REQUIRED_KID_MISSING
      type: string
    MessageCode401AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode401'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode403:
      enum:
        - CONSENT_UNKNOWN
        - SERVICE_BLOCKED
        - RESOURCE_UNKNOWN
        - RESOURCE_EXPIRED
        - PRODUCT_INVALID
      type: string
    MessageCode403AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode403'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode404:
      enum:
        - RESOURCE_UNKNOWN
        - PRODUCT_UNKNOWN
      type: string
    MessageCode404AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode404'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode405:
      enum:
        - SERVICE_INVALID
        - CANCELLATION_INVALID
      type: string
    MessageCode405AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode405'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode406:
      enum:
        - REQUESTED_FORMATS_INVALID
      type: string
    MessageCode406AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode406'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode408:
      enum:
        - REQUEST_TIMEOUT
      type: string
    MessageCode408AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode408'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode409:
      enum:
        - STATUS_INVALID
      type: string
    MessageCode409AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode409'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode415:
      enum:
        - UNSUPPORTED_MEDIA_TYPE
      type: string
    MessageCode415AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode415'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MessageCode429:
      enum:
        - ACCESS_EXCEEDED
      type: string
    MessageCode429AdditionalError:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/MessageCode429'
        title:
          type: string
          nullable: true
        detail:
          type: string
          nullable: true
      additionalProperties: false
    MonthOfExecution:
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
        - '7'
        - '8'
        - '9'
        - '10'
        - '11'
        - '12'
      type: string
      description: "The format is following the regular expression \\d{1,2}. The array is restricted to 11 entries.\r\nThe values contained in the array entries shall all be different and the maximum value of one entry is 12.\r\nThis attribute is contained if and only if the frequency equals \"MonthlyVariable\".\r\nExample: An execution on January, April and October each year is addressed by [\"1\", \"4\", \"10\"]."
    OrganizationIdentification:
      type: object
      properties:
        others:
          type: array
          items:
            $ref: '#/components/schemas/OtherIdentification'
          nullable: true
      additionalProperties: { }
    OtherIdentification:
      required:
        - identification
      type: object
      properties:
        identification:
          maxLength: 35
          minLength: 0
          type: string
      additionalProperties: { }
    OtpFormat:
      enum:
        - characters
        - integer
      type: string
    PartyIdentification:
      type: object
      properties:
        organisationId:
          $ref: '#/components/schemas/OrganizationIdentification'
        privateId:
          $ref: '#/components/schemas/PrivateIdentification'
      additionalProperties: { }
    PaymentInitiationCancelResponse:
      type: object
      properties:
        transactionStatus:
          $ref: '#/components/schemas/TransactionStatus'
        scaMethods:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationObject'
          nullable: true
        chosenScaMethod:
          $ref: '#/components/schemas/AuthenticationObject'
        challengeData:
          $ref: '#/components/schemas/ChallengeData'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
      additionalProperties: false
    PaymentInitiationRequestBase:
      required:
        - creditorAccount
        - instructedAmount
      type: object
      properties:
        endToEndIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        instructionIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        debtorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        debtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        ultimateDebtor:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        ultimateDebtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        instructedAmount:
          $ref: '#/components/schemas/Amount'
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          type: string
          nullable: true
        creditorAgentName:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        creditorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        creditorAddress:
          $ref: '#/components/schemas/Address'
        chargeBearer:
          $ref: '#/components/schemas/ChargeBearer'
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        remittanceInformationUnstructuredArray:
          type: array
          items:
            type: string
          description: "Array of unstructured remittance information.\r\n* Remark:\r\n  remittanceInformationUnstructuredArray[\r\n example: List [ \"Ref Number Merchant\", \"Some Other Text\" ]\r\n Array of unstructured remittance information.\r\n remittanceInformationUnstructured string\r\n maxLength: 140\r\n example: Ref Number Merchant\r\n Unstructured remittance information"
          nullable: true
        additionalInformation:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        instructionPriority:
          $ref: '#/components/schemas/PriorityCode'
      additionalProperties: { }
    PaymentInitiationRequestResponse:
      type: object
      properties:
        transactionStatus:
          $ref: '#/components/schemas/TransactionStatus'
        paymentId:
          type: string
          nullable: true
        transactionFees:
          $ref: '#/components/schemas/Amount'
        currencyConversionFee:
          $ref: '#/components/schemas/Amount'
        estimatedTotalAmount:
          $ref: '#/components/schemas/Amount'
        estimatedInterbankSettlementAmount:
          $ref: '#/components/schemas/Amount'
        scaMethods:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationObject'
          nullable: true
        chosenScaMethod:
          $ref: '#/components/schemas/AuthenticationObject'
        challengeData:
          $ref: '#/components/schemas/ChallengeData'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: A list of hyperlinks to be recognized by the TPP.
          nullable: true
        psuMessage:
          type: string
          nullable: true
        tppMessages:
          type: array
          items:
            $ref: '#/components/schemas/TppMessage'
          nullable: true
      additionalProperties: false
    PaymentInitiationStatusResponse:
      type: object
      properties:
        transactionStatus:
          $ref: '#/components/schemas/TransactionStatus'
        fundsAvailable:
          type: boolean
          nullable: true
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          nullable: true
      additionalProperties: false
    PaymentProductType:
      enum:
        - aspsp
        - domestic
        - foreign
      type: string
    PeriodicPaymentInitiationRequest:
      required:
        - creditorAccount
        - frequency
        - instructedAmount
      type: object
      properties:
        endToEndIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        instructionIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        debtorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        debtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        ultimateDebtor:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        ultimateDebtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        instructedAmount:
          $ref: '#/components/schemas/Amount'
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          type: string
          nullable: true
        creditorAgentName:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        creditorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        creditorAddress:
          $ref: '#/components/schemas/Address'
        chargeBearer:
          $ref: '#/components/schemas/ChargeBearer'
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        remittanceInformationUnstructuredArray:
          type: array
          items:
            type: string
          description: "Array of unstructured remittance information.\r\n* Remark:\r\n  remittanceInformationUnstructuredArray[\r\n example: List [ \"Ref Number Merchant\", \"Some Other Text\" ]\r\n Array of unstructured remittance information.\r\n remittanceInformationUnstructured string\r\n maxLength: 140\r\n example: Ref Number Merchant\r\n Unstructured remittance information"
          nullable: true
        additionalInformation:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        instructionPriority:
          $ref: '#/components/schemas/PriorityCode'
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        requestedExecutionDate:
          type: string
          format: date
          nullable: true
        startDate:
          type: string
          format: date
        executionRule:
          $ref: '#/components/schemas/ExecutionRule'
        endDate:
          type: string
          format: date
          nullable: true
        frequency:
          $ref: '#/components/schemas/FrequencyCode'
        dayOfExecution:
          $ref: '#/components/schemas/DayOfExecution'
        monthsOfExecution:
          type: array
          items:
            $ref: '#/components/schemas/MonthOfExecution'
          nullable: true
      additionalProperties: { }
    PeriodicPaymentInitiationWithStatusResponse:
      required:
        - creditorAccount
        - debtorAccount
        - debtorIdentification
        - debtorName
        - instructedAmount
        - startDate
      type: object
      properties:
        transactionStatus:
          $ref: '#/components/schemas/TransactionStatus'
        endToEndIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        debtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        debtorName:
          minLength: 1
          type: string
        instructedAmount:
          $ref: '#/components/schemas/Amount'
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          type: string
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        creditorAddress:
          $ref: '#/components/schemas/Address'
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        startDate:
          type: string
          format: date
        endDate:
          type: string
          format: date
          nullable: true
        executionRule:
          $ref: '#/components/schemas/ExecutionRule'
        frequency:
          $ref: '#/components/schemas/FrequencyCode'
        dayOfExecution:
          $ref: '#/components/schemas/DayOfExecution'
        monthsOfExecution:
          type: array
          items:
            $ref: '#/components/schemas/MonthOfExecution'
          nullable: true
      additionalProperties: false
    PriorityCode:
      enum:
        - NORM
        - HIGH
      type: string
    PrivateIdentification:
      required:
        - others
      type: object
      properties:
        others:
          type: array
          items:
            $ref: '#/components/schemas/OtherIdentification'
      additionalProperties: { }
    PsuData:
      type: object
      properties:
        password:
          type: string
          description: Password
          nullable: true
        encryptedPassword:
          type: string
          description: Encrypted password
          nullable: true
        additionalPassword:
          type: string
          description: Additional password in plaintext.
          nullable: true
        additionalEncryptedPassword:
          type: string
          description: Additional encrypted password.
          nullable: true
      additionalProperties: { }
      description: PSU Data for Update PSU authentication.
    PurposeCode:
      enum:
        - BKDF
        - BKFE
        - BKFM
        - BKIP
        - BKPP
        - CBLK
        - CDCB
        - CDCD
        - CDCS
        - CDDP
        - CDOC
        - CDQC
        - ETUP
        - FCOL
        - MTUP
        - ACCT
        - CASH
        - COLL
        - CSDB
        - DEPT
        - INTC
        - LIMA
        - NETT
        - BFWD
        - CCIR
        - CCPC
        - CCPM
        - CCSM
        - CRDS
        - CRPR
        - CRSP
        - CRTL
        - EQPT
        - EQUS
        - EXPT
        - EXTD
        - FIXI
        - FWBC
        - FWCC
        - FWSB
        - FWSC
        - MARG
        - MBSB
        - MBSC
        - MGCC
        - MGSC
        - OCCC
        - OPBC
        - OPCC
        - OPSB
        - OPSC
        - OPTN
        - OTCD
        - REPO
        - RPBC
        - RPCC
        - RPSB
        - RPSC
        - RVPO
        - SBSC
        - SCIE
        - SCIR
        - SCRP
        - SHBC
        - SHCC
        - SHSL
        - SLEB
        - SLOA
        - SWBC
        - SWCC
        - SWPT
        - SWSB
        - SWSC
        - TBAS
        - TBBC
        - TBCC
        - TRCP
        - AGRT
        - AREN
        - BEXP
        - BOCE
        - COMC
        - CPYR
        - GDDS
        - GDSV
        - GSCB
        - LICF
        - MP2B
        - POPE
        - ROYA
        - SCVE
        - SERV
        - SUBS
        - SUPP
        - TRAD
        - CHAR
        - COMT
        - MP2P
        - ECPG
        - ECPR
        - ECPU
        - EPAY
        - CLPR
        - COMP
        - DBTC
        - GOVI
        - HLRP
        - HLST
        - INPC
        - INPR
        - INSC
        - INSU
        - INTE
        - LBRI
        - LIFI
        - LOAN
        - LOAR
        - PENO
        - PPTI
        - RELG
        - RINP
        - TRFD
        - FORW
        - FXNT
        - ADMG
        - ADVA
        - BCDM
        - BCFG
        - BLDM
        - BNET
        - CBFF
        - CBFR
        - CCRD
        - CDBL
        - CFEE
        - CGDD
        - CORT
        - COST
        - CPKC
        - DCRD
        - DSMT
        - DVPM
        - EDUC
        - FACT
        - FAND
        - FCPM
        - FEES
        - GOVT
        - ICCP
        - IDCP
        - IHRP
        - INSM
        - IVPT
        - MCDM
        - MCFG
        - MSVC
        - NOWS
        - OCDM
        - OCFG
        - OFEE
        - OTHR
        - PADD
        - PTSP
        - RCKE
        - RCPT
        - REBT
        - REFU
        - RENT
        - REOD
        - RIMB
        - RPNT
        - RRBN
        - RVPM
        - SLPI
        - SPLT
        - STDY
        - TBAN
        - TBIL
        - TCSC
        - TELI
        - TMPG
        - TPRI
        - TPRP
        - TRNC
        - TRVC
        - WEBI
        - ANNI
        - CAFI
        - CFDI
        - CMDT
        - DERI
        - DIVD
        - FREX
        - HEDG
        - INVS
        - PRME
        - SAVG
        - SECU
        - SEPI
        - TREA
        - UNIT
        - FNET
        - FUTR
        - ANTS
        - CVCF
        - DMEQ
        - DNTS
        - HLTC
        - HLTI
        - HSPC
        - ICRF
        - LTCF
        - MAFC
        - MARF
        - MDCS
        - VIEW
        - CDEP
        - SWFP
        - SWPP
        - SWRS
        - SWUF
        - ADCS
        - AEMP
        - ALLW
        - ALMY
        - BBSC
        - BECH
        - BENE
        - BONU
        - CCHD
        - COMM
        - CSLP
        - GFRP
        - GVEA
        - GVEB
        - GVEC
        - GVED
        - GWLT
        - HREC
        - PAYR
        - PEFC
        - PENS
        - PRCP
        - RHBS
        - SALA
        - SSBE
        - LBIN
        - LCOL
        - LFEE
        - LMEQ
        - LMFI
        - LMRK
        - LREB
        - LREV
        - LSFL
        - ESTX
        - FWLV
        - GSTX
        - HSTX
        - INTX
        - NITX
        - PTXP
        - RDTX
        - TAXS
        - VATX
        - WHLD
        - TAXR
        - B112
        - BR12
        - TLRF
        - TLRR
        - AIRB
        - BUSB
        - FERB
        - RLWY
        - TRPT
        - CBTV
        - ELEC
        - ENRG
        - GASB
        - NWCH
        - NWCM
        - OTLC
        - PHON
        - UBIL
        - WTER
      type: string
      description: ExternalPurpose1Code from ISO 20022.  Values from ISO 20022 External Code List ExternalCodeSets_1Q2018 June 2018.
    ReadAccountDetailsResponse:
      type: object
      properties:
        account:
          $ref: '#/components/schemas/AccountDetails'
      additionalProperties: false
      description: Json body response for read account details
    RemittanceInformationStructured:
      required:
        - reference
      type: object
      properties:
        reference:
          maxLength: 35
          minLength: 0
          type: string
          description: Gets or Sets Reference
        referenceType:
          maxLength: 35
          minLength: 0
          type: string
          description: Gets or Sets ReferenceType
          nullable: true
        referenceIssuer:
          maxLength: 35
          minLength: 0
          type: string
          description: Gets or Sets ReferenceIssuer
          nullable: true
      additionalProperties: false
      description: Structured remittance information.
    ScaStatus:
      enum:
        - received
        - psuIdentified
        - psuAuthenticated
        - scaMethodSelected
        - started
        - unconfirmed
        - finalised
        - failed
        - exempted
      type: string
      description: "This data element is containing information about the status of the SCA method applied. The following codes are defined for this data type.\r\n* 'received': An authorisation or cancellation-authorisation resource has been created successfully.\r\n* 'psuIdentified': The PSU related to the authorisation or cancellation-authorisation resource has been identified.\r\n* 'psuAuthenticated': The PSU related to the authorisation or cancellation-authorisation resource has been identified and authenticated e.g. by a password or by an access token.\r\n* 'scaMethodSelected': The PSU/TPP has selected the related SCA routine. If the SCA method is chosen implicitly since only one SCA method is available, then this is the first status to be reported instead of 'received'.\r\n* 'unconfirmed': SCA is technically successfully finalised by the PSU, but the authorisation resource needs a confirmation command by the TPP yet.\r\n* 'started': The addressed SCA routine has been started.\r\n* 'finalised': The SCA routine has been finalised successfully (including a potential confirmation command). This is a final status of the authorisation resource.\r\n* 'failed': The SCA routine failed. This is a final status of the authorisation resource.\r\n* 'exempted': SCA was exempted for the related transaction, the related authorisation is successful. This is a final status of the authorisation resource."
    ScaStatusAuthorisationConfirmation:
      enum:
        - finalised
        - failed
      type: string
      description: 'This data element is containing information about the status of the SCA method in an authorisation confirmation response.   The following codes are defined for this data type.    * ''finalised'': if the transaction authorisation and confirmation was successfule.   * ''failed'': if the transaction authorisation or confirmation was not successful.'
    ScaStatusResponse:
      type: object
      properties:
        scaStatus:
          $ref: '#/components/schemas/ScaStatus'
        psuMessage:
          type: string
          description: Text to be displayed to the PSU.
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          nullable: true
        tppMessages:
          type: array
          items:
            $ref: '#/components/schemas/TppMessage'
          description: Messages to the TPP on operational issues.
          nullable: true
      additionalProperties: false
      description: Body of the JSON response with SCA Status.
    SelectPsuAuthenticationMethod:
      required:
        - authenticationMethodId
      type: object
      properties:
        authenticationMethodId:
          maxLength: 35
          minLength: 0
          type: string
          description: An identification provided by the ASPSP for the later identification of the authentication method selection
      additionalProperties: { }
      description: Content of the body of a Select PSU authentication method request
    SelectPsuAuthenticationMethodResponse:
      type: object
      properties:
        transactionFees:
          $ref: '#/components/schemas/Amount'
        currencyConversionFees:
          $ref: '#/components/schemas/Amount'
        estimatedTotalAmount:
          $ref: '#/components/schemas/Amount'
        estimatedInterbankSettlementAmount:
          $ref: '#/components/schemas/Amount'
        chosenScaMethod:
          $ref: '#/components/schemas/AuthenticationObject'
        challengeData:
          $ref: '#/components/schemas/ChallengeData'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: " A list of hyperlinks to be recognised by the TPP. Might be contained, if several authentication methods are available for the PSU. Type of links admitted in this response:\r\n'updateAdditionalPsuAuthentication': The link to the payment initiation or account information resource, which needs to be updated by an additional PSU password.\r\nThis link is only contained in rare cases, where such additional passwords are needed for PSU authentications.\r\n'updateAdditionalEncryptedPsuAuthentication': The link to the payment initiation or account information resource,\r\nwhich needs to be updated by an additional encrypted PSU password.This link is only contained in rare cases,\r\nwhere such additional passwords are needed for PSU authentications.\r\n selectAuthenticationMethod: This is a link to a resource, where the TPP can select the applicable second factor authentication methods for the PSU,\r\n if there were several available authentication methods. This link is only contained, if the PSU is already identified or authenticated with the first\r\n relevant factor or alternatively an access token, if SCA is required and if the PSU has a choice between different authentication methods.\r\n If this link is contained, then there is also the data element 'scaMethods' contained in the response body.\r\n'authoriseTransaction': The link to the resource, where the \"Transaction authorisation request\" is sent to. This is the link to the resource which will authorise the transaction by checking the SCA authentication data within the Embedded SCA approach.\r\n'scaStatus': The link to retrieve the scaStatus of the corresponding authorisation sub-resource."
          nullable: true
        scaStatus:
          $ref: '#/components/schemas/ScaStatus'
        psuMessage:
          type: string
          description: Text to be displayed to the PSU
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a successful select PSU authentication method request.
    SinglePaymentInitiationRequest:
      required:
        - creditorAccount
        - instructedAmount
      type: object
      properties:
        endToEndIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        instructionIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        debtorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        debtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        ultimateDebtor:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        ultimateDebtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        instructedAmount:
          $ref: '#/components/schemas/Amount'
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          type: string
          nullable: true
        creditorAgentName:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        creditorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        creditorAddress:
          $ref: '#/components/schemas/Address'
        chargeBearer:
          $ref: '#/components/schemas/ChargeBearer'
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        remittanceInformationUnstructuredArray:
          type: array
          items:
            type: string
          description: "Array of unstructured remittance information.\r\n* Remark:\r\n  remittanceInformationUnstructuredArray[\r\n example: List [ \"Ref Number Merchant\", \"Some Other Text\" ]\r\n Array of unstructured remittance information.\r\n remittanceInformationUnstructured string\r\n maxLength: 140\r\n example: Ref Number Merchant\r\n Unstructured remittance information"
          nullable: true
        additionalInformation:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
        instructionPriority:
          $ref: '#/components/schemas/PriorityCode'
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        requestedExecutionDate:
          type: string
          format: date
          nullable: true
      additionalProperties: { }
    SinglePaymentInitiationWithStatusResponse:
      required:
        - creditorAccount
        - debtorAccount
        - debtorIdentification
        - debtorName
        - instructedAmount
      type: object
      properties:
        transactionStatus:
          $ref: '#/components/schemas/TransactionStatus'
        endToEndIdentification:
          maxLength: 35
          minLength: 0
          type: string
          nullable: true
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        debtorIdentification:
          $ref: '#/components/schemas/PartyIdentification'
        debtorName:
          minLength: 1
          type: string
        instructedAmount:
          $ref: '#/components/schemas/Amount'
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          type: string
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          nullable: true
        creditorAddress:
          $ref: '#/components/schemas/Address'
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          nullable: true
      additionalProperties: false
    StandingOrderDetails:
      type: object
      properties:
        startDate:
          type: string
          description: The first applicable day of execution starting from this date is the first payment
          format: date
        frequency:
          $ref: '#/components/schemas/FrequencyCode'
        endDate:
          type: string
          description: 'The last applicable day of execution. If not given, it is an infinite standing order.'
          format: date
          nullable: true
        executionRule:
          $ref: '#/components/schemas/ExecutionRule'
        withinAMonthFlag:
          type: boolean
          description: "This element is only used in case of frequency equals 'Monthly'.\r\nIf this element equals false it has no effect.\r\nIf this element equals true, then the execution rule is overruled if the day of execution would fall into a different month using the execution rule.\r\nExample: executionRule equals 'preceding', dayOfExecution equals '02' and the second of a month is a Sunday.\r\nIn this case, the transaction date would be on the last day of the month before.\r\nThis would be overruled if withinAMonthFlag equals true and the payment is processed on Monday the third of the Month.\r\nRemark: This attribute is rarely supported in the market."
          nullable: true
        monthsOfExecution:
          uniqueItems: true
          type: array
          items:
            $ref: '#/components/schemas/MonthOfExecution'
          description: "The format is following the regular expression \\d{1,2}.\r\nThe array is restricted to 11 entries.\r\nThe values contained in the array entries shall all be different and the maximum value of one entry is 12.\r\nThis attribute is contained if and only if the frequency equals \"MonthlyVariable\".\r\nExample: An execution on January, April and October each year is addressed by [\"1\", \"4\", \"10\"]."
          nullable: true
        multiplicator:
          type: integer
          description: "This is multiplying the given frequency resulting the exact frequency, e.g. Frequency=\r\nweekly and multiplicator 3 means every 3 weeks.\r\nRemark: This attribute is rarely supported in the market."
          format: int32
          nullable: true
        dayOfExecution:
          $ref: '#/components/schemas/DayOfExecution'
        limitAmount:
          $ref: '#/components/schemas/Amount'
      additionalProperties: false
      description: Details of underlying standing orders.
    StartConsentAuthorisationResponse:
      type: object
      properties:
        scaStatus:
          $ref: '#/components/schemas/ScaStatus'
        authorisationId:
          type: string
          description: Resource identification of the related SCA.
          nullable: true
        scaMethods:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationObject'
          description: "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods.\r\nDepending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified\r\nwith the first relevant factor, or if an access token is transported.\r\nIf this data element is contained, then there is also a hyperlink of type 'startAuthorisationWithAuthenticationMethodSelection' contained in the response body.\r\nThese methods shall be presented towards the PSU for selection by the TPP."
          nullable: true
        chosenScaMethod:
          $ref: '#/components/schemas/AuthenticationObject'
        challengeData:
          $ref: '#/components/schemas/ChallengeData'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: "A list of hyperlinks to be recognised by the TPP. The actual hyperlinks used in the response depend on the dynamical decisions of the ASPSP when processing the request.\r\n Remark: All links can be relative or full links, to be decided by the ASPSP.\r\n  Type of links admitted in this response, (further links might be added for ASPSP defined extensions):\r\n'scaRedirect': In case of an SCA Redirect Approach, the ASPSP is transmitting the link to which to redirect the PSU browser.\r\n'scaOAuth': In case of a SCA OAuth2 Approach, the ASPSP is transmitting the URI where the configuration of the Authorisation Server can be retrieved.The configuration follows the OAuth 2.0 Authorisation Server Metadata specification.\r\n'confirmation': Might be added by the ASPSP if either the \"scaRedirect\" or \"scaOAuth\" hyperlink is returned in the same response message. This hyperlink defines the URL to the resource which needs to be updated with\r\n    a confirmation code as retrieved after the plain redirect authentication process with the ASPSP authentication server or\r\n   an access token as retrieved by submitting an authorization code after the integrated OAuth based authentication process with the ASPSP authentication server.\r\n'updatePsuIdentification': The link to the authorisation or cancellation authorisation sub-resource, where PSU identification data needs to be uploaded.\r\n'startAuthorisationWithPsuAuthentication': The link to the authorisation or cancellation authorisation sub-resource, where PSU authentication data needs to be uploaded.\r\n'startAuthorisationWithEncryptedPsuAuthentication': Same as startAuthorisationWithPsuAuthentication where the authentication data need to be encrypted on application layer in uploading.\r\n'selectAuthenticationMethod': The link to the authorisation or cancellation authorisation sub-resource, where the selected authentication method needs to be uploaded.This link is contained under exactly the same conditions as the data element 'scaMethods'.\r\n'authoriseTransaction': The link to the authorisation or cancellation authorisation sub-resource, where the authorisation data has to be uploaded, e.g.the TOP received by SMS.\r\n'scaStatus': The link to retrieve the scaStatus of the corresponding authorisation sub-resource."
          nullable: true
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Text to be displayed to the PSU
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a Start SCA authorisation request.
    StartConsentAuthorizationRequestBody:
      type: object
      properties:
        updatePsuAuthentication:
          $ref: '#/components/schemas/UpdatePsuAuthentication'
        selectPsuAuthenticationMethod:
          $ref: '#/components/schemas/SelectPsuAuthenticationMethod'
        transactionAuthorisation:
          $ref: '#/components/schemas/TransactionAuthorization'
      additionalProperties: { }
      description: Content of the body of a Select PSU authentication method request
    TppMessage:
      type: object
      properties:
        category:
          $ref: '#/components/schemas/TppMessageCategory'
        code:
          $ref: '#/components/schemas/MessageCode2XX'
        path:
          type: string
          nullable: true
        text:
          type: string
          nullable: true
      additionalProperties: false
    TppMessageCategory:
      enum:
        - ERROR
        - WARNING
      type: string
    TransactionAuthorization:
      required:
        - scaAuthenticationData
      type: object
      properties:
        scaAuthenticationData:
          minLength: 1
          type: string
          description: 'SCA authentication data, depending on the chosen authentication method. If the data is binary, then it is base64 encoded'
      additionalProperties: { }
      description: Content of the body of a transaction authorisation request
    TransactionDetails:
      required:
        - transactionAmount
      type: object
      properties:
        transactionId:
          type: string
          description: "Can be used as access-ID in the API, where more details on an transaction is offered.\r\nIf this data attribute is provided this shows that the AIS can get access on more details about this transaction using the GET Transaction Details\r\nRequest as defined in Section 6.5.5  page 294"
          nullable: true
        entryReference:
          maxLength: 35
          minLength: 0
          type: string
          description: "Is the identification of the transaction as used e.g. for reference for delta function on application level.\r\nThe same identification as for example used within camt.05x messages."
          nullable: true
        endToEndId:
          maxLength: 35
          minLength: 0
          type: string
          description: Unique end to end identity.
          nullable: true
        batchIndicator:
          type: boolean
          description: 'If this indicator equals true, then the related entry is a batch entry.'
          nullable: true
        batchNumberOfTransactions:
          type: integer
          description: Shall be used if and only if the batchIndicator is contained and equals true.
          format: int32
          nullable: true
        mandateId:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Identification of Mandates, e.g. a SEPA Mandate ID.'
          nullable: true
        checkId:
          maxLength: 35
          minLength: 0
          type: string
          description: Identification of a Cheque.
          nullable: true
        creditorId:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Identification of Creditors, e.g. a SEPA Creditor ID.'
          nullable: true
        bookingDate:
          type: string
          description: The date when an entry is posted to an account on the ASPSPs books.
          format: date
          nullable: true
        valueDate:
          type: string
          description: The Date at which assets become available to the account owner in case of a credit.
          format: date
          nullable: true
        transactionAmount:
          $ref: '#/components/schemas/Amount'
        currencyExchange:
          type: array
          items:
            $ref: '#/components/schemas/ForeignExchangeRate'
          description: Array of exchange rates.
          nullable: true
        creditorName:
          maxLength: 70
          minLength: 0
          type: string
          description: Name of the creditor if a "Debited" transaction
          nullable: true
        creditorAccount:
          $ref: '#/components/schemas/AccountReference'
        creditorAgent:
          pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}'
          type: string
          description: Creditor Agent BIC
          nullable: true
        ultimateCreditor:
          maxLength: 70
          minLength: 0
          type: string
          description: Ultimate creditor.
          nullable: true
        debtorName:
          maxLength: 70
          minLength: 0
          type: string
          description: Debtor Name
          nullable: true
        debtorAccount:
          $ref: '#/components/schemas/AccountReference'
        debtorAgent:
          pattern: '[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}'
          type: string
          description: BIC
          nullable: true
        ultimateDebtor:
          maxLength: 70
          minLength: 0
          type: string
          description: Ultimate Debtor
          nullable: true
        remittanceInformationUnstructured:
          maxLength: 140
          minLength: 0
          type: string
          description: "Unstructured remittance information.\r\nდანიშნულება"
          nullable: true
        remittanceInformationUnstructuredArray:
          type: array
          items:
            type: string
          description: Might be used by the ASPSP to transport additional transaction related information to the PSU
          nullable: true
        remittanceInformationStructured:
          maxLength: 140
          minLength: 0
          type: string
          description: Structured remittance information Max
          nullable: true
        remittanceInformationStructuredArray:
          type: array
          items:
            $ref: '#/components/schemas/RemittanceInformationStructured'
          description: Gets or Sets RemittanceInformationStructuredArray
          nullable: true
        entryDetails:
          type: array
          items:
            $ref: '#/components/schemas/EntryDetailsElement'
          description: Might be used by the ASPSP to transport details about transactions within a batch.
          nullable: true
        additionalInformation:
          maxLength: 500
          minLength: 0
          type: string
          description: Might be used by the ASPSP to transport additional transaction related information to the PSU
          nullable: true
        additionalInformationStructured:
          $ref: '#/components/schemas/AdditionalInformationStructured'
        purposeCode:
          $ref: '#/components/schemas/PurposeCode'
        bankTransactionCode:
          type: string
          description: "Bank transaction code as used by the ASPSP and using the sub elements of this structured code defined by ISO 20022.\r\nThis code type is concatenating the three ISO20022 Codes\r\nDomain Code,\r\nFamily Code, and\r\nSubFamily Code by hyphens, resulting in 'DomainCode'-'FamilyCode'-'SubFamilyCode'. For standing order reports the following codes are applicable:\r\n* \"PMNT-ICDT-STDO\" for credit transfers,\r\n* \"PMNT-IRCT-STDO\" for instant credit transfers\r\n* \"PMNT-ICDT-XBST\" for cross-border credit transfers\r\n* \"PMNT-IRCT-XBST\" for cross-border real time credit transfers and\r\n* \"PMNT-MCOP-OTHR\" for specific standing orders which have a dynamical amount to move left funds e.g. on month end to a saving account"
          nullable: true
        proprietaryBankTransactionCode:
          maxLength: 35
          minLength: 0
          type: string
          description: Proprietary bank transaction code as used within a community or within an ASPSP e.g. for MT94x based transaction reports.
          nullable: true
        balanceAfterTransaction:
          $ref: '#/components/schemas/Balance'
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: Gets or Sets Links
          nullable: true
      additionalProperties: false
      description: Transaction details.
    TransactionStatus:
      enum:
        - ACCC
        - ACCP
        - ACSC
        - ACSP
        - ACTC
        - ACWC
        - ACWP
        - RCVD
        - PDNG
        - RJCT
        - CANC
        - ACFC
        - PATC
        - PART
      type: string
    UpdateConsentsPsuDataRequest:
      type: object
      properties:
        updatePsuAuthentication:
          $ref: '#/components/schemas/UpdatePsuAuthentication'
        selectPsuAuthenticationMethod:
          $ref: '#/components/schemas/SelectPsuAuthenticationMethod'
        transactionAuthorisation:
          $ref: '#/components/schemas/TransactionAuthorization'
        authorisationConfirmation:
          $ref: '#/components/schemas/AuthorisationConfirmation'
      additionalProperties: { }
      description: Authorisation confirmation request body for the redirect approach
    UpdateConsentsPsuDataResponse:
      type: object
      properties:
        updatePsuIdenticationResponse:
          $ref: '#/components/schemas/UpdatePsuIdenticationResponse'
        updatePsuAuthenticationResponse:
          $ref: '#/components/schemas/UpdatePsuAuthenticationResponse'
        selectPsuAuthenticationMethodResponse:
          $ref: '#/components/schemas/SelectPsuAuthenticationMethodResponse'
        scaStatusResponse:
          $ref: '#/components/schemas/ScaStatusResponse'
        authorisationConfirmationResponse:
          $ref: '#/components/schemas/AuthorisationConfirmationResponse'
      additionalProperties: false
      description: Content of the body of a Update Consents Psu Data method request
    UpdatePsuAuthentication:
      required:
        - psuData
      type: object
      properties:
        psuData:
          $ref: '#/components/schemas/PsuData'
      additionalProperties: { }
      description: "Content of the body of a Update PSU authentication request\r\nPassword sub field is used."
    UpdatePsuAuthenticationResponse:
      type: object
      properties:
        transactionFees:
          $ref: '#/components/schemas/Amount'
        currencyConversionFees:
          $ref: '#/components/schemas/Amount'
        estimatedTotalAmount:
          $ref: '#/components/schemas/Amount'
        estimatedInterbankSettlementAmount:
          $ref: '#/components/schemas/Amount'
        chosenScaMethod:
          $ref: '#/components/schemas/AuthenticationObject'
        challengeData:
          $ref: '#/components/schemas/ChallengeData'
        scaMethods:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationObject'
          description: "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods.\r\nDepending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor, or if an access token is transported.\r\nIf this data element is contained, then there is also a hyperlink of type 'startAuthorisationWithAuthenticationMethodSelection' contained in the response body.\r\nThese methods shall be presented towards the PSU for selection by the TPP."
          nullable: true
        _links:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: "A list of hyperlinks to be recognised by the TPP. Might be contained, if several authentication methods are available for the PSU. Type of links admitted in this response:\r\n* 'updateAdditionalPsuAuthentication': The link to the payment initiation or account information resource, which needs to be updated by an additional PSU password.\r\nThis link is only contained in rare cases, where such additional passwords are needed for PSU authentications.\r\n* 'updateAdditionalEncryptedPsuAuthentication': The link to the payment initiation or account information resource, which needs to be updated by an additional encrypted PSU password.\r\nThis link is only contained in rare cases, where such additional passwords are needed for PSU authentications.\r\n* selectAuthenticationMethod: This is a link to a resource, where the TPP can select the applicable second factor authentication methods for the PSU,\r\nif there were several available authentication methods. This link is only contained, if the PSU is already identified or authenticated with the first\r\nrelevant factor or alternatively an access token, if SCA is required and if the PSU has a choice between different authentication methods.\r\nIf this link is contained, then there is also the data element 'scaMethods' contained in the response body.\r\n* 'authoriseTransaction': The link to the resource, where the \"Transaction authorisation request\" is sent to.\r\nThis is the link to the resource which will authorise the transaction by checking the SCA authentication data within the Embedded SCA approach.\r\n* 'scaStatus': The link to retrieve the scaStatus of the corresponding authorisation sub-resource."
          nullable: true
        scaStatus:
          $ref: '#/components/schemas/ScaStatus'
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Text to be displayed to the PSU
          nullable: true
        authorisationId:
          type: string
          description: Resource identification of the related SCA
          nullable: true
      additionalProperties: false
      description: Psu Authentication Update Response
    UpdatePsuIdenticationResponse:
      type: object
      properties:
        transactionFees:
          $ref: '#/components/schemas/Amount'
        currencyConversionFees:
          $ref: '#/components/schemas/Amount'
        estimatedTotalAmount:
          $ref: '#/components/schemas/Amount'
        estimatedInterbankSettlementAmount:
          $ref: '#/components/schemas/Amount'
        scaMethods:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationObject'
          description: "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods.\r\nDepending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor,\r\nor if an access token is transported.\r\nIf this data element is contained, then there is also a hyperlink of type 'startAuthorisationWithAuthenticationMethodSelection' contained in the response body.\r\nThese methods shall be presented towards the PSU for selection by the TPP."
          nullable: true
        _linksUpdatePsuIdentification:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/HrefType'
          description: A list of hyperlinks
          nullable: true
        scaStatus:
          $ref: '#/components/schemas/ScaStatus'
        psuMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Text to be displayed to the PSU
          nullable: true
      additionalProperties: false
      description: Body of the JSON response for a successful update PSU identification request.
  securitySchemes:
    Bearer:
      type: apiKey
      description: Please Enter Authentication Token
      name: Authorization
      in: header