Processo de Integração

Informações sobre as fases do processo de Integração.

---

Para incorporar com sucesso a API do Hubpontos, você deve aderir às seguintes fases:

Integração

Durante esta etapa, você pode desenvolver sua solução de produto em nosso ambiente de preparação, onde você pode validar casos de uso, entender e validar comportamentos e testar toda a comunicação com nossas APIs, preparando seu ambiente para receber e lidar com os respectivos retornos.

Informação

Nossa equipe de especialistas estará ao seu lado durante todo o processo de integração, fornecendo todas as informações complementares necessárias para garantir uma implementação tranquila e bem-sucedida em nossa plataforma.

Revisão

Após terminar de desenvolver e testar com nossas APIs, e se sentir confortável em passar para a fase de produção, você precisará compartilhar evidências do que foi integrado e testado no staging com a equipe de On-boarding.

Este material será revisado para que possamos validar seu processo de integração, garantindo a funcionalidade do que você está implementando.

Produção

Ao final da fase de revisão, você receberá nosso OK e as chaves para seu ambiente de produção para iniciar sua operação.

Nossa equipe de On-boarding o auxiliará no início de sua fase de produção para garantir a assertividade e a funcionalidade de sua nova operação e o apoiará em quaisquer ajustes que possam ocorrer.

Monitoraremos e daremos suporte de perto à sua operação.

Onde usar?

O sistema permite dois tipos de integração:

Acesso das APIs

• Cadastro de usuários
• Status de usuários e pontos
• Catálogo de Produtos
• Solicitação de Produto

Login automático

Objetivo: Essa integração tem como objetivo fazer o carregamento da Loja do Hubpontos dentro do sistema ou aplicativo do cliente sem a necessidade do usuário fazer o login.

Onde usar: Essa integração pode ser usada como um acesso a loja dentro da plataforma do cliente sem que o usuário tenha que fazer login na nossa plataforma.

Exemplo: O "cliente A" já tem uma plataforma própria e com isso seu próprio login, o que o cliente precisa: dentro do seu app, site ou plataforma ele chama uma URL nossa e com isso o usuário precisa fazer um novo login e consegue visualizar nossa loja de produtos.

Observação

Para gerar a chave de API para acesso das integrações favor clicar aqui

Como funciona?

Para fazer a integração é necessário seguir as etapas abaixo:

• Gerar a Chave de API
• Fazer a criptografia dos dados
• Fazer internamento do sistema do cliente a chamada da URL da forma abaixo

Como fazer criptografia dos dados enviados na URL

Algoritmo: aes-256-cbc

Exemplo: Telefone: 11982630461 Senha: jSWvCwrz4vGg9S1xxBEcKZAHhJYftFPu

Entrada: Telefone = 11983631461 Obs.: Pode ser usado o e-mail também como identificador no lugar do telefone Saída: algoritmo aes-256-cbc = fd782c8fcc44e3d540ba30302f0f9afa

Código de encrypt e decrypt key = cryptoJs.enc.Utf8.parse('jSWvCwrz4vGg9S1xxBEcKZAHhJYftFPu') iv = cryptoJs.enc.Hex.parse('00000000000000000000000000000000')

 encrypt(plaintext: string): string {
    const encrypted = cryptoJs.AES.encrypt(plaintext, this.key, {
      iv: this.iv,
      mode: cryptoJs.mode.CBC,
      padding: cryptoJs.pad.Pkcs7,
    })

    return encrypted.ciphertext.toString(cryptoJs.enc.Hex)
  }

  decrypt(encryptedText: string): string {
    const encryptedHexStr = cryptoJs.enc.Hex.parse(encryptedText)
    const encryptedBase64Str = cryptoJs.enc.Base64.stringify(encryptedHexStr)

    const decrypted = cryptoJs.AES.decrypt(encryptedBase64Str, this.key, {
      iv: this.iv,
      mode: cryptoJs.mode.CBC,
      padding: cryptoJs.pad.Pkcs7,
    })

    return decrypted.toString(cryptoJs.enc.Utf8)
  }

Exemplo de chamada da URL

https://<<Loja do Cliente>>.hubpontos.com.br/auth/<<Token Gerado>>/<<CPF ou e-mail cliente>>

Essa URL deve ser chamada com esse formato e com isso o usuário será automaticamente logado na Loja.