Saltar al contingut principal
Afegeix la verificació d’identitat de Didit i el control d’edat a la teva botiga de Shopify en qüestió de minuts. L’aplicació Didit Verify de Shopify instal·la un bloc de tema que pots col·locar a qualsevol pàgina (el compte, el pagament o pàgines d’aterratge personalitzades) i crea sessions de verificació des del servidor: la teva clau d’API es manté dins de l’aplicació integrada i mai no s’exposa a la part pública de la botiga. Els resultats de la verificació apareixen directament a la pestanya Verificacions del panell d’administració de Shopify, sense necessitat d’un sistema de backend separat, i també estan disponibles mitjançant webhooks i l’API de Didit per als comerciants que gestionen el seu propi sistema de backend. No cal que iniciïs sessió a la Didit Business Console per accedir a les dades de verificació recollides a través de Shopify.

​
Requisits previs

  • Una botiga de Shopify (de qualsevol pla)
  • Un compte de Didit Console amb almenys un flux de treball

​
Pas 1: Instal·la l’aplicació

  1. Obre l’enllaç d’instal·lació: https://admin.shopify.com/oauth/install?client_id=cafa0d15227fb59bd47470b23eae7469
  2. Selecciona la teva botiga (si en tens més d’una)
  3. Fes clic a Instal·la per afegir l’aplicació a la teva botiga
L’aplicació sol·licita un únic àmbit de permís: read_customers. S’utilitza per precompletar i contrastar les dades només quan Permet el preompliment aprovat pel client està activat i el client que ha iniciat sessió selecciona la casella de selecció opcional per compartir les dades.

​
Pas 2: Configura les credencials de Didit

Després de la instal·lació, Didit Verify s’obre dins del panell d’administració de Shopify. Utilitza Configuració per connectar l’aplicació al teu compte de Didit.

​
Obtén la clau d’API

  1. Inicia sessió a la Didit Business Console
  2. Ves a API i webhooks a la barra lateral esquerra
  3. Copia la teva clau d’API
Com obtenir la clau d'API des de la Didit Business Console
  1. Enganxa la clau d’API al camp Clau d’API de Didit de les preferències de Shopify

​
Obtén l’ID del flux de treball

  1. A la Didit Business Console, ves a Fluxos de treball
  2. Selecciona el flux de treball que vols utilitzar (o crea’n un de nou)
  3. Copia l’ID del flux de treball (un UUID com xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
Com obtenir l'ID del flux de treball des de la Didit Business Console
  1. Enganxa l’ID del flux de treball al camp ID del flux de treball de Didit

​
Desa la configuració

Tria un període de conservació a Conservació de dades abans de desar. El període s’aplica a les verificacions existents i futures de la botiga, així que tria la durada que necessita la teva botiga. Fes clic a Desa la configuració. Hauries de veure un missatge d’èxit:
La configuració de Shopify s'ha desat correctament

​
Pas 3: Afegeix el botó de verificació al tema

  1. Al panell d’administració de Shopify, ves a Botiga en línia → Temes
  2. Fes clic a Personalitza al tema actiu
  3. Ves a la pàgina on vols el botó de verificació (per exemple, la pàgina del compte o una pàgina personalitzada)
  4. Fes clic a Afegir secció o a Afegeix un bloc
  5. Ves a la pestanya Aplicacions
  6. Selecciona Didit Verify
El botó de verificació apareixerà al tema. Pots arrossegar-lo per reposicionar-lo dins de la secció.

​
Accés a les dades de verificació

La revisió d’aplicacions de Shopify (requisit 5.1.5) exigeix que les dades recollides mitjançant un flux allotjat a Shopify siguin accessibles per al comerciant dins del context de l’administrador o de l’aplicació de Shopify, no només en un tauler extern. L’aplicació Didit Verify compleix aquest requisit de sèrie: no cal cap backend, receptor de webhooks ni interfície personalitzada.

​
La pestanya Verificacions (per defecte, sense codi)

Obre Aplicacions → Didit Verify → Verificacions a l’administrador de Shopify per veure totes les sessions de verificació recollides a través de la teva botiga: estat, client, país i marca de temps, limitades a la teva botiga. Selecciona una sessió per veure’n la visió general de la decisió, els camps d’identitat, les comprovacions de verificació individuals, les advertències i les evidències disponibles. Pots passar d’una pestanya a una altra, entre Configuració, Verificacions, Privadesa i Revisió humana, sense sortir de l’administrador de Shopify. En desar la configuració, aquestes pestanyes continuen disponibles.
La pestanya Verificacions només carrega dades quan obres l’aplicació des de l’administrador de Shopify. Si veus un missatge que et demana que tornis a obrir la pàgina, navega de nou a Aplicacions → Didit Verify des de la barra lateral de l’administrador de Shopify.
La Didit Business Console (business.didit.me) és una superfície d’administració independent per a la configuració (claus d’API, fluxos de treball, destinacions de webhooks). No indiquis als comerciants que l’utilitzin per veure les dades de verificació recollides a través de Shopify, perquè això no compleix el requisit d’accés a les dades de Shopify. La Console només és necessària per a la configuració inicial i per obtenir les credencials.

​
Per als comerciants que tenen backend propi (opcional)

Si tens un backend propi i vols una còpia de les dades de verificació allà, per exemple per activar la lògica d’execució de comandes, Didit també entrega els resultats mitjançant webhook i una API sota demanda, a més de la pestanya Verificacions anterior.
1

Sessió de verificació creada

L’aplicació de Shopify crea una sessió al servidor amb la teva clau d’API de Didit. El client completa el flux de verificació al bloc del tema (modal o incrustat).
2

Resultat enviat mitjançant webhook

Quan la sessió arriba a un estat final, Didit envia un webhook status.updated signat a la destinació que has configurat a la Didit Business Console, dins de API i Webhooks. El cos del webhook inclou l’objecte de decisió complet, el mateix esquema que retorna GET /v3/session/{id}/decision/, per als estats Approved, Declined, In Review i Abandoned. Altres estats finals (per exemple, Expired o Kyc Expired) envien el canvi d’estat sense payload de decisió; crida l’API per consultar l’estat de la sessió.
3

Obtenció sota demanda (opcional)

El teu backend també pot cridar GET /v3/session/{sessionId}/decision/ en qualsevol moment per obtenir el payload complet de la decisió (camps d’identitat, prova de vida, AML, coincidència facial, etc.).

​
Configuració de webhooks per a Shopify

  1. A la Didit Business Console, navega a API i Webhooks → Webhooks
  2. Crea una destinació de webhook que apunti al teu endpoint de backend (HTTPS, accessible públicament)
  3. Subscriu-te com a mínim als esdeveniments status.updated i data.updated
  4. Guarda el secret_shared_key retornat per verificar les signatures HMAC-SHA256 dels webhooks entrants
Consulta la guia de Webhooks per conèixer el contracte complet, els exemples de verificació de signatures en Node.js, Python i PHP, i el comportament de reintents.

​
Obtenció de la decisió d’una sessió via API

La resposta inclou session_kind, status i totes les matrius de funcionalitats (id_verifications, liveness_checks, face_matches, aml_screenings, etc.). Consulta Obtenir la sessió per veure l’esquema complet de la resposta i la referència de camps.

​
Opcions de configuració

​
Configuració de la pàgina de preferències

Aquesta configuració es configura a les preferències de l’aplicació (accessibles des de Aplicacions → Didit Verify a l’administrador de Shopify):

​
Opcions de privadesa del client

El bloc de la botiga ofereix una casella opcional per compartir les dades del compte per a l’emplenament previ i les comprovacions d’identitat. Si no la marques, el client pot introduir les dades ell mateix. Sota Opcions de verificació, un client que ha iniciat sessió pot sol·licitar una revisió humana o retirar el consentiment i sol·licitar la supressió de les seves dades de verificació. La revisió humana atura la verificació automàtica i afegeix una sol·licitud a Aplicacions → Didit Verify → Revisió humana. Contacta amb el client i acorda una alternativa adequada abans de completar aquesta sol·licitud. Completar una sol·licitud de revisió humana no aprova cap verificació ni cap compra. La retirada atura immediatament l’enllaç de verificació existent i impedeix noves verificacions mentre la supressió està en curs. La botiga confirma la recepció de la sol·licitud; no afirma que la supressió ja s’hagi completat.

​
Fulfilir sol·licituds de privadesa

Obre Aplicacions → Didit Verify → Privadesa per fer el seguiment de les exportacions de clients i de les sol·licituds de supressió rebudes de Shopify o de la botiga en línia.
  • Exportació de client: Descarrega el ZIP preparat, lliura’l mitjançant el teu procés segur d’atenció al client i, després, selecciona He lliurat aquesta exportació.
  • Supressió de client: La sol·licitud continua en curs fins que s’hagin suprimit els registres de verificació associats a la botiga del client, els fitxers pujats i les sol·licituds de revisió manual.
  • Cal atenció: Segueix les instruccions de la sol·licitud per resoldre un ID de client que falti o contacta amb l’assistència de Didit quan un perfil inclogui dades d’una altra botiga o finalitat.
Les exportacions contenen els registres de verificació, els fitxers pujats i les sol·licituds de revisió manual associats a la botiga i al client que ho ha sol·licitat. Les descàrregues temporals caduquen als set dies; si cal, fes servir Reintentar després de resoldre per preparar una descàrrega nova. Una exportació descarregada s’ha de gestionar segons els teus propis procediments d’atenció al client i de protecció de dades. Defineix el període de conservació a Configuració → Conservació de dades. Les dades de verificació més antigues se suprimeixen automàticament; les verificacions més recents continuen disponibles. La conservació a nivell d’aplicació existent continua aplicant-se quan no s’ha seleccionat un període específic per a la botiga. Revisa Privadesa per detectar qualsevol sol·licitud de conservació que necessiti atenció. Quan una sol·licitud de supressió mostri Eliminada, la supressió és irreversible i el material eliminat ja no està disponible. Els crèdits consumits i les entrades de llista de bloqueig gestionades per separat no es veuen afectats.

​
Configuració del bloc del tema

Aquests paràmetres es configuren a l’editor de temes de Shopify quan selecciones el bloc de Didit Verify:

​
Connexió

​
Visualització

​
Aparença del botó

​
Configuració recomanada

Per a la majoria de botigues, recomanem:
  • Mode: Flux de treball de l’aplicació (utilitza el flux de treball desat a la configuració de l’aplicació)
  • Mode de visualització: Modal (funciona a qualsevol lloc, sense problemes de disposició)
  • Requerir l’inici de sessió del client: Activat (vincula la verificació als comptes dels clients)
  • Permetre el precompletat aprovat pel client: Activat (els clients trien si comparteixen les dades de la seva botiga)

​
Proves

  1. Previsualitza el teu tema o visita la teva botiga
  2. Navega fins a la pàgina amb el botó de Didit Verify
  3. Fes clic a Verifica la teva identitat
  4. Completa el flux de verificació
  5. Revisa el teu backend per veure el lliurament del webhook, o crida GET /v3/session//decision/ per obtenir el resultat de la verificació
El sandbox és gratuït (cada aplicació de sandbox pot crear 500 sessions de prova cada 24 hores), així que pots provar el flux complet sense cap cost. En mode producció, el pla gratuït inclou $10 de crèdit al mes.

​
Resolució de problemes

​
El botó no fa res en fer-hi clic

  • Assegura’t d’haver desat la clau d’API i l’ID del flux de treball a les preferències
  • Comprova que l’ID del flux de treball pertany a la mateixa aplicació que la teva clau d’API
  • Activa Registre de depuració a la configuració del bloc i revisa la consola del navegador per detectar errors

​
Error «Les credencials de Didit no estan configurades»

  • L’aplicació no té cap clau d’API o ID de flux de treball desat per a aquesta botiga. Obre Aplicacions → Didit Verify, omple els dos camps i fes clic a Desa la configuració

​
«Has d’iniciar sessió per verificar la teva identitat»

  • Requerir l’inici de sessió del client està activat (per defecte). El client ha d’iniciar sessió primer al compte de la seva botiga; si necessites verificació per a usuaris sense compte, desactiva aquest paràmetre a les preferències de l’aplicació

​
La configuració no es desa

  • «La validació de la clau d’API ha fallat»: torna a copiar la clau d’API des de la Didit Business Console i assegura’t que no hi hagi espais addicionals
  • «Aquest flux de treball no pertany a la teva aplicació»: l’ID del flux de treball pertany a una aplicació de Didit diferent de la teva clau d’API; copia tots dos des de la mateixa aplicació

​
Assistència (24/7)

El nostre equip està disponible per ajudar-te a posar-ho en marxa.

Correu electrònic

Envia’ns un correu a hello@didit.me.
Darrera modificació el 7 de novembre del 2026