Receive and reuse extracted ID names after a failed Qualified Electronic Signature (QES) attempt

Available from July 21

When a Qualified Electronic Signature (QES) attempt fails due to a mismatch between the Signer’s provided name and the name extracted from their ID document, you will now be able to retrieve the extracted names and reuse them to retry the identification.

Here’s how it works:

• When the identification fails, you will continue to receive the webhook **signer.identification_failed** (link to API reference) as is already the case.
• In the case of a first name or last name error, and after the Signer clicks on the consent button to share the extracted information, you'll receive the signer.identification_blocked (link to API reference) webhook containing the extracted first name (expected_first_name) and last name (expected_last_name).
• Use the Unblock Signer endpoint (link to API reference):
  POST /signature_requests/{signatureRequestId}/signers/{signerId}/unblock_identification. It's possible to use this endpoint without any update on the Signer's names just to unblock the Signer (but the Signer will risk triggering the same error again due to a mismatch of first name and/or last name).
• Update the Signer with the extracted names using the dedicated endpoint (link to API reference):
  PATCH /signature_requests/{signatureRequestId}/signers/{signerId}

⚠️ Please note: Once this feature goes live on July 21. For our existing customers, we will wait for your approval before giving you access to the feature, to avoid blocked Signers without the possibility of unblocking them with the right correction.

For more details, refer to our dedicated guide section (link to guide).