> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Renvoi de livraison webhook : API Didit > Renvoyez à votre endpoint une livraison webhook passée, re-signée par Didit, et obtenez la nouvelle tentative avec le statut HTTP reçu. Prompt de l'API de renvoi des livraisons de destination de webhook Copier le prompt dans le presse-papiers \

\`Resend a past Didit webhook delivery to my endpoint through the Management API.

Endpoint:
POST https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/resend/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs webhooks: write and decisions: read. A key limited to some workflows or to approved sessions cannot use this endpoint.

Goal:
\- Recover webhooks my endpoint missed (for example during an outage) by sending them again once the endpoint is fixed.

Path parameters:
\- destination_uuid: the destination uuid from GET /v3/webhook/destinations/.
\- delivery_uuid: the uuid of the delivery to resend, from GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

Behavior:
\- No request body.
\- Didit takes the stored payload, sets a fresh timestamp, signs it again with the destination's current secret_shared_key (X-Signature, X-Signature-V2, X-Signature-Simple and X-Timestamp) and POSTs it to the URL the original delivery went to (request_url), even if the destination URL changed since or the destination is disabled.
\- event_id and the rest of the payload are unchanged, so deduplicate on event_id in my endpoint.
\- The call waits for my endpoint (up to 5 seconds) and returns 200 with the new delivery whatever my endpoint answered. Check response_status in the response: 2xx means accepted, 504 a timeout, 503 a connection failure.
\- One attempt only: a resend is not retried automatically. Every call sends again and creates a new delivery with its own uuid; the original delivery is unchanged.
\- The response is redacted like GET delivery for scoped keys (media URLs, session tokens and hosted links as null); my endpoint still receives the full payload.

Example call:
curl -X POST "https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/resend/" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 400: { "detail": "Invalid webhook data format", "code": "invalid_webhook_payload" } when the stored delivery cannot be signed again. Nothing is sent.
\- 401: { "detail": "This API key has expired." }
\- 403: { "detail": "You do not have permission to perform this action." }, { "detail": "This API key has no write access to webhooks." }, { "detail": "This API key has no read access to decisions." }, or the limited-key message.
\- 404: { "detail": "Webhook destination not found." } or { "detail": "Webhook delivery not found." }
\- 429: more than 300 write requests per minute with this key; wait for Retry-After.

Side effects:
\- My endpoint receives the webhook again, and a new delivery appears in the destination's deliveries and analytics.

For the full integration shape, see /integration/integration-prompt.`

\
Coller dans > [!WARNING] > > Chaque appel renvoie à nouveau le webhook. Rendez votre endpoint idempotent sur `event_id` avant de renvoyer en masse, et ne renvoyez que les livraisons dont `response_status` vaut `null` ou est supérieur ou égal à `400`.Un renvoi part vers l'URL utilisée par la livraison d'origine. Si vous avez déplacé la destination vers une nouvelle URL, les anciennes livraisons pointent toujours vers l'ancienne. Recherchez les livraisons à renvoyer avec [Lister les livraisons de destination de webhook](https://docs.didit.me/fr/management-api/webhook/list-deliveries.md), et consultez le [guide des webhooks](https://docs.didit.me/fr/integration/webhooks.md) pour la vérification de signature. ## OpenAPI ````yaml fr/openapi-25.json POST /v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/resend/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/webhook/destinations/{destination_uuid}/deliveries/{delivery_uuid}/resend/: post: tags: - Webhook summary: Renvoyer la livraison vers la destination de webhook description: "Renvoyez une livraison passée, par exemple après une indisponibilité de votre endpoint. Didit prend le payload stocké, lui attribue un nouveau `timestamp`, le signe à nouveau avec le `secret_shared_key` actuel de la destination (`X-Signature`, `X-Signature-V2`, `X-Signature-Simple` et `X-Timestamp`) et l'envoie à l'URL `request_url` de la livraison, même si l'URL de la destination a changé depuis ou si la destination est désactivée. `event_id` et le reste du payload sont inchangés, vous devez donc dédupliquer sur `event_id`. L'appel attend votre endpoint jusqu'à 5 secondes et renvoie la nouvelle livraison avec `200` quelle que soit la réponse de votre endpoint\_: lisez `response_status`. Un renvoi n'est pas réessayé automatiquement, chaque appel effectue un nouvel envoi et crée une nouvelle livraison, et la requête n'a pas de corps. Une clé API restreinte nécessite `webhooks: write` et `decisions: read`\_; une clé limitée à certains workflows ou aux sessions approuvées ne peut pas utiliser cet endpoint." operationId: resend_webhook_destination_delivery parameters: - name: destination_uuid in: path required: true description: UUID de la destination à laquelle la livraison a été envoyée. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: delivery_uuid in: path required: true description: >- UUID de la livraison à renvoyer : le `uuid` d'une entrée renvoyée par `GET /v3/webhook/destinations/{destination_uuid}/deliveries/`. schema: type: string format: uuid example: 66666666-7777-8888-9999-000000000001 responses: '200': description: >- La nouvelle livraison, déjà tentée. `response_status` est ce que votre endpoint a répondu cette fois-ci (`504` délai d'expiration, `503` échec de connexion). La livraison d'origine reste inchangée. content: application/json: schema: $ref: '#/components/schemas/WebhookDestinationDeliveryDetail' examples: Accepted on resend: value: uuid: 66666666-7777-8888-9999-000000000004 session_id: 22222222-3333-4444-5555-666666666666 request_url: https://yourapp.com/webhooks/didit response_status: 200 response_time_ms: 151 status: In Progress webhook_type: status.updated created_at: '2026-10-16T14:05:42.330981Z' request_header: >- {"Content-Type": "application/json", "X-Signature": "b8eb1e376517ee0cad8ba98ff7f8fd35fc72eca231000963a96a335f82328835", "X-Signature-V2": "9efd2ce9ed1303e1d05273ef9608a59363ed9789a05253db4748b3e8e50cb109", "X-Signature-Simple": "bf3a9dc04b2c20ab539203b0cd5cca2a10f630bf62d8feb6d68d82af80f64774", "X-Timestamp": "1792159542", "User-Agent": "DiditWebhook/2.0 +https://didit.me"} request_body: >- {"application_id":"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee","created_at":1792056057,"environment":"live","event_id":"33333333-4444-5555-6666-777777777777","sandbox_scenario":null,"session_id":"22222222-3333-4444-5555-666666666666","status":"In Progress","timestamp":1792159542,"vendor_data":"user-123","webhook_type":"status.updated","workflow_id":"44444444-5555-6666-7777-888888888888","workflow_version":3} '400': description: >- La livraison enregistrée n'a pas pu être signée de nouveau. Rien n'est envoyé. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. code: type: string description: >- Code d'erreur stable lisible par machine. Effectuez vos branchements sur cette valeur, pas sur `detail`. examples: Unsignable delivery: value: detail: Invalid webhook data format code: invalid_webhook_payload '401': description: >- La clé API a expiré : elle a été créée avec une date d'expiration qui est dépassée. Une clé incorrecte ou révoquée reçoit également un code `401` ; une clé manquante reçoit un code `403`. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Expired key: value: detail: This API key has expired. '403': description: >- La requête n'est pas autorisée. Un en-tête `x-api-key` manquant, invalide ou révoqué renvoie `You do not have permission to perform this action.` Une clé avec restriction de portée sans l'accès requis par cet endpoint renvoie un message indiquant l'accès manquant, et une clé utilisée en dehors de sa liste d'autorisation d'adresses IP renvoie `This API key can't be used from this IP address.` Une clé limitée à certains workflows ou à des sessions approuvées renvoie `This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint.` content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Missing or invalid key: value: detail: You do not have permission to perform this action. Scoped key without webhooks write: value: detail: This API key has no write access to webhooks. Scoped key without decisions read: value: detail: This API key has no read access to decisions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. Outside the IP allowlist: value: detail: This API key can't be used from this IP address. '404': description: >- La destination n'existe pas pour l'application ou a été supprimée, ou la livraison n'existe pas, appartient à une autre destination, ou n'est plus disponible. content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Destination not found: value: detail: Webhook destination not found. Delivery not found: value: detail: Webhook delivery not found. '429': description: >- Limite de débit dépassée : plus de 300 requêtes d'écriture (POST, PATCH, PUT, DELETE) dans la fenêtre actuelle d'une minute pour cette clé API. Attendez `Retry-After` secondes avant de réessayer. headers: Retry-After: description: Secondes à attendre avant de réessayer. schema: type: integer minimum: 1 example: 30 X-RateLimit-Limit: description: Requêtes autorisées dans la fenêtre d'une minute (300). schema: type: integer example: 300 X-RateLimit-Remaining: description: Requêtes restantes dans la fenêtre actuelle. schema: type: integer example: 0 X-RateLimit-Reset: description: >- Temps Unix (en secondes) auquel la fenêtre actuelle se réinitialise. schema: type: integer example: 1792056120 X-RateLimit-Scope: description: Nom du budget qui a été dépassé. schema: type: string example: generic-write content: application/json: schema: type: object properties: detail: type: string description: Message d'erreur lisible par l'humain. examples: Throttled: value: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/resend/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.webhooks.destinations.resend_delivery( "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.webhooks.destinations.resendDelivery( "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001", ); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Webhooks.Destinations.ResendDelivery(ctx, \"11111111-2222-3333-4444-555555555555\", \"66666666-7777-8888-9999-000000000001\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.webhooks().destinations().resendDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001"); System.out.println(result); - lang: php label: PHP source: >- webhooks->destinations->resendDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.webhooks.destinations.resend_delivery( "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Webhooks.Destinations.ResendDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: WebhookDestinationDeliveryDetail: type: object description: >- Une tentative de livraison vers une destination de webhook, avec exactement les en-têtes et le corps de requête envoyés par Didit. required: - uuid - session_id - request_url - response_status - response_time_ms - status - webhook_type - created_at - request_header - request_body properties: uuid: type: string format: uuid description: >- ID de livraison, pour les appels de consultation détaillée et de renvoi. session_id: type: string format: uuid nullable: true description: >- Session de vérification d'utilisateur concernée par l'événement. `null` pour les événements de session d'entreprise, ainsi que pour les événements utilisateur, entreprise, de transaction, de Travel Rule et de workflow. request_url: type: string format: uri nullable: true description: "URL à laquelle la livraison a été envoyée\_: l'URL de la destination au moment où l'événement a été généré." response_status: type: integer nullable: true description: >- Code d'état HTTP renvoyé par votre endpoint. `null` tant que la livraison est en file d'attente et n'a pas encore été tentée. Lorsqu'aucune réponse HTTP n'a été reçue, Didit enregistre son propre statut : `504` lorsque votre endpoint n'a pas répondu dans un délai de 5 secondes, `503` en cas d'échec de connexion, `400` lorsque l'URL a été rejetée car non sécurisée (par exemple une adresse privée ou interne), et `404` pour toute autre erreur de requête. Un code supérieur ou égal à `400` est considéré comme une livraison échouée. response_time_ms: type: integer nullable: true minimum: 0 description: >- Durée de la tentative, en millisecondes. `null` tant que la livraison est dans la file d'attente. status: type: string nullable: true description: >- Statut signalé par l'événement lors de sa génération : le statut de la session pour les événements de session (par exemple `Approved` ou `In Review`), le statut de la personne ou de l'entreprise pour les événements utilisateur et entreprise, et le statut de la transaction pour les événements de transaction. `null` pour les événements ne comportant aucun statut. webhook_type: $ref: '#/components/schemas/WebhookEvent' created_at: type: string format: date-time description: Date et heure de création de la livraison. request_header: type: string description: >- Texte JSON (une chaîne de caractères) des en-têtes de requête envoyés par Didit : `Content-Type`, `X-Signature`, `X-Signature-V2`, `X-Signature-Simple`, `X-Timestamp` et `User-Agent`. Analysez-le avec un parseur JSON. Il contient les signatures, jamais le secret de signature. request_body: type: string description: >- Texte JSON (une chaîne de caractères) du payload exact envoyé par Didit, clés triées, comprenant `event_id` et `timestamp`. Analysez-le avec un parseur JSON ; voir [Format du payload](https://docs.didit.me/fr/integration/webhooks#structure-du-payload). Pour une clé restreinte sans `media: read`, les URL de médias qu'il contient sont `null` ; sans `sessions: write`, les tokens de session et les liens de vérification hébergés sont `null`. Un corps modifié de cette manière ne correspond plus à ses signatures. Didit n'enregistre pas le corps de réponse renvoyé par votre endpoint. WebhookEvent: type: string description: >- Nom d'événement webhook pris en charge. Utilisez ces chaînes exactes dans `subscribed_events` ; les valeurs non prises en charge sont rejetées. enum: - status.updated - data.updated - user.status.updated - user.data.updated - business.status.updated - business.data.updated - activity.created - transaction.created - transaction.status.updated - travel_rule.status.updated - workflow.compliance_changed - transaction_rule_suggestions.created - auth.signup - auth.login - auth.login_failed - auth.password_reset_requested - auth.password_reset_completed - auth.mfa_changed - auth.new_device - auth.account_locked - investigator.report.ready - investigator.decision.automated - investigator.decision.overridden - investigator.decision.contested - investigator.question.raised - investigator.automation.paused - investigator.rfi.answered - investigator.rfi.overdue - investigator.drift.detected - investigator.sla.breached - investigator.qa.failed - investigator.external.report.ready securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.