Saltar al contingut principal
Cada canvi en l’estat o en les dades de perfil d’una entitat User o Business emet un webhook perquè el teu sistema pugui reaccionar en temps real. Fes servir els webhooks d’entitat per sincronitzar dades de perfil, propagar bloquejos a altres sistemes o activar fluxos de compliment posteriors.

​
Catàleg d’esdeveniments

activity.created s’accepta a subscribed_events i el cobreix el provador Try Webhook, però Didit actualment no l’envia per al trànsit en entorn de producció. No construeixis una rèplica de la cronologia a partir d’ell.
Didit també emet esdeveniments de sessió, de transacció i de sessió d’empresa que fan referència a camps d’entitat. Consulta:

​
Estructura dels payloads

Els payloads dels webhooks d’entitat són plans: no hi ha cap envoltori data ni cap clau event. Llegeix webhook_type per encaminar l’esdeveniment.

​
user.status.updated / business.status.updated

S’activa a cada canvi d’estat. El payload conté status i previous_status. No indica el motiu del canvi d’estat: si necessites la causa, obre l’entitat a la consola.

​
user.data.updated / business.data.updated

S’activa quan canvien els camps de perfil. changed_fields enumera els camps que han canviat i changes conté el valor previous i el valor current de cadascun.
Els camps que poden aparèixer en changed_fields són:
  • User: vendor_data, display_name, full_name, date_of_birth, metadata, portrait_image, issuing_states, approved_emails, approved_phones, features, session_count, approved_count, declined_count, in_review_count, first_session_at, last_session_at.
  • Business: vendor_data, display_name, metadata, legal_name, registration_number, country_code, session_count, approved_count, declined_count, in_review_count, features, first_session_at, last_session_at.
Fes servir changed_fields i changes per sincronitzar només els camps que han canviat.

​
Lliurament, reintents i signatura

Tots els webhooks d’entitat segueixen el contracte de lliurament estàndard:
  • Signat amb HMAC-SHA256 a la capçalera X-Signature-V2 (recomanat), amb el secret_shared_key de la destinació. També s’envien X-Signature i la capçalera obsoleta X-Signature-Simple, juntament amb X-Timestamp.
  • Reintentat fins a 2 vegades, després d’aproximadament 1 minut i d’aproximadament 4 minuts, quan el teu endpoint respon amb 5xx o 404, quan té un timeout o quan no es pot connectar. La referència de webhooks inclou la política completa.
  • Idempotent: cada webhook té un event_id únic al payload; desduplica’l pel teu costat.
Consulta Referència de webhooks per configurar la destinació i veure exemples de codi per verificar la signatura.

​
Subscripció

Subscriu-te als esdeveniments d’entitat en una destinació de webhook mitjançant la Management API o la Business Console:

​
Següents passos

Referència de webhooks

Destinacions, signatures, reintents i verificació.

Crear destinació

Registra un nou endpoint de webhook.

Operacions d'usuari

Canvis que activen els webhooks d’usuari.
Darrera modificació el 7 de novembre del 2026