# Start e-signing authorization process

This method begins the authorization process for a person identification via BankIdent. When called, it triggers a Swisscom iframe and it also prompts Swisscom to send an SMS OTP to the customer. Call this endpoint when an identification reaches the  status.

Endpoint: PATCH /v1/persons/{person_id}/identifications/{id}/authorize
Version: 1.0

## Path parameters:

  - `person_id` (string, required)
    The unique ID of the person resource created for a customer.
    Example: "dc1a6812a14f6cc338cd084208535bcdcper"

  - `id` (string, required)
    The unique ID of the identification resource created for a customer.
    Example: "6dc54352d6793a892e0702850d07b831cidt"

## Response 200 fields (application/json):

  - `id` (string)
    The unique ID of the identification resource.
    Example: "a7a57dadfcc83117b5c3b72f4113be25cidt"

  - `reference` (string)
    A reference supplied by the identification provider.
    Example: "null"

  - `url` (string)
    The URL returned from FinTechSystem to which you must redirect the customer for the bank account login and payment authorization.
    Example: "https://fts-payment-initiation-wizard.solaris-sandbox.de/index.html?wizard_session_key=bfo5r16AMLlt6ZEX9Oh3JUWIkTelorupBwzIlJRR&interface_id=da05"

  - `status` (string)
    The current status of the identification.  The status value depends on the identification method, check the [KYC guides](https://docs.solarisgroup.com/guides/kyc) for more information.
    Enum: "aborted", "authorization_required", "confirmation_required", "confirmed", "created", "canceled", "expired", "failed", "identification_data_required", "pending", "pending_successful", "pending_failed", "processed", "rejected", "successful", "signed"

  - `completed_at` (string)
    Date and time when the identification process was completed.
    Example: "null"

  - `method` (string)
    The identification method to use for the person identification.
    Enum: "bank", "bank_id", "fourthline", "idnow", "manual", "postident"

  - `proof_of_address_type` (string,null)
    The type of document submitted by the customer as a proof of address. This field is  if the customer's identification document does not include their address.
    Enum: "BANK_ACCOUNT_STATEMENT", "CERTIFICATE_OF_REGISTRATION", "ELECTRICITY_BILL", "GAS_BILL", "HEATING_BILL", "INTERNET_BILL", "TELEPHONE_BILL", "WATER_BILL"

  - `proof_of_address_issued_at` (string,null)
    The date when the proof of address document was issued. This field is  if the customer's identification document does not include their address.

  - `iban` (string)
    The customer's IBAN. This field is mandatory if the identification method is  or .
    Example: "DE11110101010100000020"

  - `terms_and_conditions_signed_at` (string,null)
    The date and time from when the customer signed Swisscom's terms and conditions.
    Example: "2020-07-07T11:36:29.000Z"

  - `authorization_expires_at` (string,null)
    The date and time by which the authorization for the end customer must be requested.
    Example: "2022-08-11T08:38:21.000Z"

  - `confirmation_expires_at` (string,null)
    The date and time by which the customer must input the OTP sent to their mobile number for the QES process.
    Example: "2022-08-11T08:37:23.000Z"

  - `current_reference_token` (string)
    Example: "1234-5678"

  - `estimated_waiting_time` (string)
    (IDnow only) Estimated waiting time until an agent is available.
    Example: "null"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."