Follow Electronic Seal status
The Electronic Seal has a very simple lifecycle, and consists of a few statuses for which Webhooks can be sent. Webhooks are the best way to know when to download Sealed documents or retrieve Audit Trail.
Electronic Seal's statuses
Status summary
Status | Details |
---|---|
pending | Seal creation request received, processing will start shortly |
processing | Seal is being processed |
done | Seal processed successfully |
error | Seal processing failed |
Electronic Seal flow
Use Webhooks to monitor status changes
Webhooks are the best option to monitor a Seal status as you can be alerted as soon as an event occurs about the Electronic Seal. This mechanism is detailed in this dedicated section.
You can be notified of status changes by listening to these events :
Event | Description |
---|---|
electronic_seal.done | Seal processed successfully |
electronic_seal.error | Seal processing failed |
Here is a sample payload for a Webhook event related to an Electronic Seal:
{
"event_id": "f8f5f331-0e45-455f-91be-eba052a71649",
"event_name": "electronic_seal.done",
"event_time": "1705921843",
"subscription_id": "ID_OF_WEBHOOK_SUBSCRIPTION",
"subscription_description": "My Webhook description",
"sandbox": false,
"data": {
"electronic_seal": {
"id": "d4c48987-35c8-414c-b98f-7dc74f448052",
"status": "done",
"signature_level": "electronic_signature",
"created_at": "2024-01-22T11:10:36+00:00",
"external_id": null,
"timestamp": false,
"document_id": "6378e829-41bb-42d5-87dc-d5d2f2f24b4c",
"image_id": "f91ba743-e61d-462a-8616-3d77e2d1bfc8"
}
}
}
Updated 6 months ago