Plugin KYC WordPress: Verificação de idade no WooCommerce

​

Pré-requisitos

• WordPress 6.0 ou superior
• PHP 7.4 ou superior
• Uma conta na Didit Console

​

Passo 1: Obtenha as suas credenciais da Didit

1. Registe-se ou inicie sessão em business.didit.me
2. Aceda a API e Webhooks e copie a sua Chave de API
3. Aceda a Fluxos, crie ou selecione um fluxo e copie o ID do fluxo

​

Passo 2: Instale o plugin

1. Transfira didit-verify-0.3.4.zip a partir da versão 0.3.4
2. No painel de administração do WordPress, aceda a Plugins → Adicionar novo → Carregar plugin
3. Escolha o ficheiro ZIP transferido e clique em Instalar agora
4. Clique em Ativar

​

Passo 3: Configure o plugin

​

Escolha o seu modo

​

Configure as opções de sessão (apenas no modo API)

• Dados do fornecedor: associa cada verificação a um utilizador específico no seu painel da Didit, para que possa acompanhar quem se verificou. A predefinição é o ID de utilizador do WordPress (por exemplo, wp-42). Também pode escolher o e-mail do utilizador, um prefixo personalizado ou desativar esta opção.
• URL de retorno: uma página do seu site para onde os utilizadores são redirecionados após a verificação. A Didit acrescenta verificationSessionId e status como parâmetros de consulta.
• Método de retorno: indica qual o dispositivo que trata do redirecionamento: initiator (o dispositivo que iniciou), completer (o dispositivo que concluiu) ou both.
• Idioma: escolha entre 54 idiomas ou deixe a deteção automática pelo navegador.

​

Configure as opções de apresentação

• Modo de apresentação: Modal (sobreposição em pop-up) ou Incorporado (em linha na página)
• Botão de fechar: mostrar ou ocultar o botão X no modal
• Confirmação de saída: mostrar uma caixa de diálogo “Tem a certeza?” ao fechar
• Fecho automático: fechar automaticamente o modal quando a verificação for concluída
• Registo de depuração: registar os eventos do SDK na consola do navegador (para resolução de problemas)

​

Personalize o botão

• Texto do botão e texto de sucesso
• Cor de fundo e cor do texto
• Raio do canto, espaçamento interno e tamanho da fonte

​

Passo 4: Adicione a verificação ao seu site

​

Para lojas WooCommerce

1. Em Definições → Didit Verify → WooCommerce, marque Exigir verificação de identidade na finalização da compra
2. Escolha onde aparece a secção de verificação:
   • No topo da página de finalização da compra
   • Após os dados de faturação
   • Após as notas da encomenda
   • Antes de “Finalizar encomenda” (recomendado)
3. Opcionalmente, escolha um Âmbito de produtos: todos os produtos (predefinição), apenas os produtos selecionados ou todos os produtos exceto os selecionados. Marque os produtos com a caixa Verificação da Didit em Dados do produto → Avançado no editor de produtos. Um carrinho com pelo menos um produto que exija verificação obriga à verificação. O âmbito aplica-se tanto à finalização da compra como aos modos pós-compra.
4. Opcionalmente, edite o Título da Secção, a Mensagem de finalização da compra e a Mensagem pós-compra em Definições → Didit Verify → WooCommerce. Os campos vazios usam o texto predefinido.
5. Opcionalmente, ative Enviar dados de faturação para enviar automaticamente à Didit o nome, o e-mail, o telefone e a morada do cliente, para pré-preenchimento e validação cruzada.

​

Para qualquer página do WordPress

[didit_verify]

[didit_verify text="Verify Now" success_text="Done!"]

[didit_verify mode="embedded"]

​

Passo 5: Restringir conteúdo a utilizadores verificados (opcional)

[didit_gate]
This content is only visible to verified users.
[/didit_gate]

[didit_gate message="Please verify to continue."]Secret content here.[/didit_gate]

[didit_status]

​

Verificar o estado da verificação

​

Resolução de problemas

​

Segurança

1. Nonce CSRF: os pedidos têm de ter origem no seu site WordPress
2. Requisito de início de sessão: apenas utilizadores registados podem criar sessões (configurável)
3. Limitação de pedidos: 10 sessões por hora por utilizador, 3 por hora por IP para visitantes
4. Sanitização de dados de entrada: todos os campos estão incluídos numa lista de permissões e são sanitizados no servidor

​

Para programadores

​

Hooks PHP

// When a user completes verification
add_action('didit_verification_completed', function ($user_id, $session_id, $status) {
    // Update CRM, send email, grant access, etc.
}, 10, 3);

// When a user cancels verification
add_action('didit_verification_cancelled', function ($user_id, $session_id) {
    // Log cancellation
}, 10, 2);

// When a session is created server-side
add_action('didit_session_created', function ($url, $user_id, $vendor_data) {
    // Log, notify, etc.
}, 10, 3);

​

Evento JavaScript

document.addEventListener('didit:complete', function (e) {
    console.log('Result:', e.detail); // { type, session }
});

​

Verificar o estado da verificação em PHP

$is_verified = Didit_Verify::init()->is_user_verified($user_id);

​

Recursos

• Código-fonte do plugin (GitHub)
• Documentação da API da Didit
• Didit Console
• Referência da API Create Session