Checkify
JavaScript SDKv1.0.4

Início rápido de 5 minutos

Adicione o Checkify ao seu site com um único ID de acesso e um tipo de solicitação. Nenhuma configuração manual do iniciador é necessária.

1. Crie um site e copie seu ID de acesso.

No aplicativo Checkify ou no painel de controle empresarial, crie um site digital e registre o domínio onde seu conteúdo incorporado será executado. O Checkify provisiona automaticamente um Passe por site (por exemplo, chk_live_...).

Para testes em ambiente de sandbox, use um Passe de teste ( chk_test_...) de um ambiente de teste.

2. Adicione o trecho de código incorporado

Cole isto na sua página. Substitua YOUR_PASS_ID e escolha um tipo de solicitação.

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div
  data-checkify-pass="YOUR_PASS_ID"
  data-checkify-request="human"
  data-checkify-text="Verify with Checkify"
></div>

3. Anexe um formulário (opcional)

Para formulários de login, cadastro, finalização de compra ou contato, deixe que o SDK lide com o botão, o campo de token oculto e o estado de envio.

<form id="signup-form">
  <input type="email" name="email" required>
  <input type="hidden" id="checkify_token" name="checkify_token">
  <div id="checkify-button"></div>
  <button id="submit" type="button">Create account</button>
</form>

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<script>
  Checkify.bindForm('#signup-form', {
    passId: 'YOUR_PASS_ID',
    requestType: 'human',
    buttonTarget: '#checkify-button',
    submitButton: '#submit',
    hiddenInput: '#checkify_token'
  });
</script>

4. Verifique no seu backend

O navegador recebe apenas um token. Sempre verifique no servidor antes de permitir a ação protegida.

Use a chave do seu site API e ligue POST /v1/qr/results/verify com o request_id do campo oculto (embeds legados ainda podem enviar o token de pesquisa). Veja o guia de verificação do servidor. Para eventos do navegador e URLs de retorno, consulte o incorporar referência APIpara eventos e tratamento de URLs de retorno.

Tipos de solicitação

Tipo de solicitação Reivindicação do servidor (required_claims) Uso típico
humanverificado por humanosRedução de bots/spam
age_over_13idade_acima_de_13Conteúdo para maiores de 13 anos ou restrições no estilo COPPA.
age_over_16idade_acima_de_16Conteúdo para maiores de 16 anos ou regras regionais de idade
age_over_18idade_maior_18Conteúdo para maiores de 18 anos ou finalização da compra
age_over_21idade_acima_de_21Produtos para maiores de 21 anos (bebidas alcoólicas dos EUA, etc.)
age_over_25idade_acima_de_25Limiares de idade mais elevados

Use esses tipos de requisição em seu embed (data-checkify-request ou Checkify.bindForm). No seu servidor, verifique com a declaração correspondente em required_claims.

Ligação de domínio

A incorporação só funciona em domínios registrados no seu site Checkify. A verificação opcional de DNS/metadados/arquivos aumenta a segurança para o seu negócio, mas não é obrigatória para que a incorporação funcione em um domínio registrado.