---
title: "Start e-signing authorization process"
method: PATCH
path: "/v1/persons/{person_id}/identifications/{id}/authorize"
tags: ["Person identifications"]
---

# Start e-signing authorization process

`PATCH /v1/persons/{person_id}/identifications/{id}/authorize`

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 `authorization_required` status.

## Path parameters

- `person_id` string, required — The unique ID of the person resource created for a customer.
- `id` string, required — The unique ID of the identification resource created for a customer.

## Response `200`

The QES process has been triggered. The customer must confirm by entering the received SMS OTP.

- SolarisServerDecoratorsStartEsigningProcessResponse
  - `id` string — The unique ID of the identification resource.
  - `reference` string — A reference supplied by the identification provider.
  - `url` string — The URL returned from FinTechSystem to which you must redirect the customer for the bank account login and payment authorization.
  - `status` 'aborted' | 'authorization_required' | 'confirmation_required' | 'confirmed' | 'created' | 'canceled' | 'expired' | 'failed' | 'identification_data_required' | 'pending' | 'pending_successful' | 'pending_failed' | 'processed' | 'rejected' | 'successful' | 'signed' — The current status of the identification. **Note** The status value depends on the identification method, check the [KYC guides](https://docs.solarisgroup.com/guides/kyc) for more information.
  - `completed_at` string — Date and time when the identification process was completed.
  - `method` 'bank' | 'bank_id' | 'fourthline' | 'idnow' | 'manual' | 'postident' — The identification method to use for the person identification.
  - `proof_of_address_type` 'BANK_ACCOUNT_STATEMENT' | 'CERTIFICATE_OF_REGISTRATION' | 'ELECTRICITY_BILL' | 'GAS_BILL' | 'HEATING_BILL' | 'INTERNET_BILL' | 'TELEPHONE_BILL' | 'WATER_BILL', nullable — The type of document submitted by the customer as a proof of address. This field is **mandatory** if the customer's identification document does not include their address.
  - `proof_of_address_issued_at` string, date, nullable — The date when the proof of address document was issued. This field is **mandatory** 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 `bank` or `bank_id`.
  - `terms_and_conditions_signed_at` string, nullable — The date and time from when the customer signed Swisscom's terms and conditions.
  - `authorization_expires_at` string, nullable — The date and time by which the authorization for the end customer must be requested.
  - `confirmation_expires_at` string, nullable — The date and time by which the customer must input the OTP sent to their mobile number for the QES process.
  - `current_reference_token` string
  - `estimated_waiting_time` string — (IDnow only) Estimated waiting time until an agent is available.

## Other responses

- `400` — An error occurred on the client side.
- `403` — You are not authorized to perform this action.
- `500` — Internal server error.
- `default` — Unexpected error

---

[API](https://skmtc.net/solarisgroup/apis/customer-identification-kyc.md) · [All operations](https://skmtc.net/solarisgroup/apis/customer-identification-kyc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/customer-identification-kyc/revisions/c481fa2414f9/schema)