> ## 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. # App KYC per a Shopify: verificació d'identitat i d'edat > App de Didit per a Shopify: verificació d'identitat i d'edat al checkout. Sense codi, des de $0.33 per KYC complet, $10 gratis/mes, sense contractes. 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](https://docs.didit.me/ca/integration/webhooks.md) i l'[API de Didit](https://docs.didit.me/ca/sessions-api/retrieve-session.md) 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](https://business.didit.me) 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](https://admin.shopify.com/oauth/install?client_id=cafa0d15227fb59bd47470b23eae7469)](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 > [!NOTE] > > 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](https://business.didit.me) 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](https://mintcdn.com/didit-0f962782/gKLcMCmiLycklBol/images/shopify-how-to-get-api-key.jpg?fit=max\&auto=format\&n=gKLcMCmiLycklBol\&q=85\&s=9027ca685cc296a400e78d320a566453) 4. 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](https://mintcdn.com/didit-0f962782/gKLcMCmiLycklBol/images/shopify-how-to-get-workflow-id.jpg?fit=max\&auto=format\&n=gKLcMCmiLycklBol\&q=85\&s=529dc681169efc0a6cdc96d6c0e0a605) 4. 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](https://mintcdn.com/didit-0f962782/gKLcMCmiLycklBol/images/shopify-settings-saved-successfuly.jpg?fit=max\&auto=format\&n=gKLcMCmiLycklBol\&q=85\&s=93dcf3469f902876ae831075da75a628) *** ### 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. > [!NOTE] > > 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](https://docs.didit.me/ca/integration/webhooks.md#forma-del-payload), 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/`](https://docs.didit.me/ca/sessions-api/retrieve-session) 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](https://business.didit.me), 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](https://docs.didit.me/ca/integration/webhooks.md) 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 ```bash theme={null} curl https://verification.didit.me/v3/session//decision/ \ -H "x-api-key: " ``` 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ó](https://docs.didit.me/ca/sessions-api/retrieve-session.md) 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): | Configuració | Descripció | | - | - | | **Clau d'API** | La teva clau d'API de Didit (obligatòria) | | **ID del flux de treball** | El flux de verificació que s'utilitzarà (obligatori) | | **Dades del proveïdor** | Com s'enllacen les sessions amb els usuaris a la teva Didit Console: **ID de client** (s'envia com a `shopify-`), **Correu electrònic del client**, **Botiga + ID de client** (s'envia com a `-`), o **Cap**. S'aplica només quan el client ha iniciat sessió. | | **URL de callback** | URL opcional on es redirigeix els usuaris després de la verificació. Didit afegeix `verificationSessionId` i `status` com a paràmetres de consulta. | | **Mètode de callback** | Quin dispositiu gestiona la redirecció: **Default (initiator)**, **Initiator**, **Completer** o **Totes dues** | | **Idioma** | Idioma de la interfície de verificació (detecció automàtica o un idioma concret) | | **Requerir inici de sessió del client** | Si està activat, només poden verificar-se els clients que han iniciat sessió | | **Permetre l'emplenament previ aprovat pel client** | Ofereix una casella opcional per compartir el nom, el correu electrònic, el telèfon i l'adreça del client que ha iniciat sessió, per a l'emplenament previ i les comprovacions d'identitat. Les dades només s'envien quan el client la selecciona. | | **Suprimir automàticament després de (dies)** | Tria durant quant de temps la botiga necessita els registres de verificació. El període seleccionat s'aplica als registres existents i als futurs d'aquesta botiga. La supressió és irreversible. | ### 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ó | Paràmetre | Descripció | | - | - | | **Mode** | **Flux de treball de l'aplicació** (recomanat) utilitza el flux de treball desat a la configuració de l'aplicació. **Flux de treball UniLink** utilitza un enllaç de flux de treball públic del compte de Didit connectat. Tots dos modes creen sessions associades a la botiga, amb resultats disponibles a l'aplicació. | | **URL d'UniLink** | Només s'utilitza en el mode UniLink. Fes servir un enllaç actiu del compte de Didit connectat a la configuració de l'aplicació. Els clients han d'iniciar sessió al compte de la seva botiga. | #### Visualització | Paràmetre | Descripció | | - | - | | **Mode de visualització** | **Modal**: obre la verificació en una finestra emergent superposada. **Incrustat**: mostra la verificació en línia sota el botó. | | **Mostra el botó de tancar** | Mostra/amaga el botó X per tancar la finestra modal de verificació | | **Diàleg de confirmació en sortir** | Demana als usuaris que confirmin abans de tancar la verificació | | **Tancament automàtic en completar-se** | Tanca automàticament la finestra modal quan la verificació es completa | | **Registre de depuració** | Activa els registres de la consola del navegador per resoldre problemes | #### Aparença del botó | Paràmetre | Descripció | | - | - | | **Text del botó** | Text que es mostra al botó (per defecte: "Verifica la teva identitat") | | **Text d'èxit** | Text que es mostra després d'una verificació satisfactòria (per defecte: "Identity Verified ✓") | | **Color de fons** | Color de fons del botó | | **Color del text** | Color del text del botó | | **Radi de la vora** | Arrodoniment de les cantonades del botó (0–50 px) | | **Farciment vertical** | Farciment superior/inferior (0–40 px) | | **Farciment horitzontal** | Farciment esquerre/dret (0–60 px) | | **Mida de la lletra** | Mida del text del botó (10–32 px) | *** ## 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/{id}/decision/](https://docs.didit.me/ca/sessions-api/retrieve-session.md) per obtenir el resultat de la verificació > [!NOTE] > > 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](https://business.didit.me) 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. > [card] [Correu electrònic](mailto:hello@didit.me) > > Envia'ns un correu a [hello@didit.me](mailto:hello@didit.me). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.