action openbankingproject_start_consent_authorisation {
  label: "Start the authorisation process for a consent"
  description: "Create an authorisation sub-resource and start the authorisation process of a consent.\nThe message might in addition transmit authentication and authorisation related data.\n\nhis method is iterated n times for a n times SCA authorisation in a\ncorporate context, each creating an own authorisation sub-endpoint for\nthe corresponding PSU authorising the consent.\n\nThe ASPSP might make the usage of this access method unnecessary,\nsince the related authorisation resource will be automatically created by\nthe ASPSP after the submission of the consent data with the first POST consents call.\n\nThe start authorisation process is a process which is needed for creating a new authorisation\nor cancellation sub-resource.\n\nThis applies in the following scenarios:\n\n  * The ASPSP has indicated with an 'startAuthorisation' hyperlink in the preceding Payment \n    initiation response that an explicit start of the authorisation process is needed by the TPP. \n    The 'startAuthorisation' hyperlink can transport more information about data which needs to be \n    uploaded by using the extended forms:\n    * 'startAuthorisationWithPsuIdentfication', \n    * 'startAuthorisationWithPsuAuthentication' \n    * 'startAuthorisationWithEncryptedPsuAuthentication'\n    * 'startAuthorisationWithAuthentciationMethodSelection'\n  * The related payment initiation cannot yet be executed since a multilevel SCA is mandated.\n  * The ASPSP has indicated with an 'startAuthorisation' hyperlink in the preceding \n    payment cancellation response that an explicit start of the authorisation process is needed by the TPP. \n    The 'startAuthorisation' hyperlink can transport more information about data which needs to be uploaded \n    by using the extended forms as indicated above.\n  * The related payment cancellation request cannot be applied yet since a multilevel SCA is mandate for\n    executing the cancellation.\n  * The signing basket needs to be authorised yet.\n"
  provider: openbankingproject
  method: POST
  path: "/v1/consents/{consentId}/authorisations"
  encoding: json
  input: {
    type: "object"
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}