# BYP, o que preciso saber?

O **BYP** é uma ferramenta de **autoatendimento** que reduz a necessidade de equipamentos físicos. Ele permite que os clientes **acessem sua loja via smartphone**, adicionem produtos ao carrinho e finalizem suas compras diretamente no dispositivo móvel.

{% hint style="success" %}
**Vantagens do BYP:**

✔ Elimina a dependência de hardware especializado.

✔ Facilita compras online através de um sistema simples.

✔ Totalmente integrado ao Cloud e ao Delivery Legal.
{% endhint %}

{% hint style="info" %}
**O PDV Legal Fast agora se chama BYP.**

Se você pesquisou pelo nome antigo, use este manual normalmente.
{% endhint %}

{% hint style="danger" %}

### **Pré-requisitos:** <a href="#prrequisitos" id="prrequisitos"></a>

* Ter o **módulo BYP** ativado no licenciamento.
* Garantir que os produtos estão **cadastrados corretamente** no sistema.

🔗 **Acesse o BYP:** <http://pdvlegalfast.beepayapp.com.br/login>

➡ **Login:** E-mail cadastrado na ativação.

➡ **Senha:** 6 primeiros dígitos do CPF ou CNPJ (alterável após o primeiro acesso).
{% endhint %}

## Como configurar o BYP? <a href="#configuraodopdvlegalfast" id="configuraodopdvlegalfast"></a>

### 1. Ativação e Configuração de Produtos e Preços <a href="#id-1ativaoeconfiguraodeprodutosepreos" id="id-1ativaoeconfiguraodeprodutosepreos"></a>

{% stepper %}
{% step %}

### **Ative o Módulo:**

1. Entre no [**Portal OEM**](https://oem.tabletcloud.com.br/login.aspx?ReturnUrl=%2f) e selecione a licença do cliente.
2. Procure e clique em "**BYP**"
3. Clique em "**Gravar Licenciamento**"

Após a ativação, anote o login, senha e link de acesso ao painel de controle do BYP, disponíveis ao lado da opção "**BYP**".
{% endstep %}

{% step %}

### **Configure os Produtos no Retaguarda:**

* **Essencial:** Todas as configurações de produtos (nome, unidade de estoque, código EAN, preço, grupo e foto) devem ser feitas **exclusivamente no sistema de retaguarda**. O painel do BYP reflete essas informações.
* **Unidade de Estoque:** Utilize "UN" (Unidade) ou "KG" (Quilograma) para exibição correta no aplicativo.
* **Disponibilidade no Aplicativo:** Produtos sem preço, inativos ou pausados não aparecerão no aplicativo.
  {% endstep %}

{% step %}

### **Atualize os Produtos no Aplicativo:**

* **Automática:** Os produtos são atualizados automaticamente a cada hora. Alterações de preço são refletidas a cada 5 minutos.
* **Manual:** Para forçar a atualização, acesse o painel do BYP > **Perfil Mercado** > **Buscar Produtos ERP** e **Buscar Preços ERP**. Verifique a data/hora em "Atualizado em" para confirmar.

<figure><img src="/files/WJoa6gCEPOa2aUxM4UFU" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### 2. Configuração da Loja (Logotipo e Informações) <a href="#id-2configuraodalojalogotipoeinformaes" id="id-2configuraodalojalogotipoeinformaes"></a>

{% stepper %}
{% step %}

### Acesse o painel do BYP > **Perfil Mercado**.

🔗 <http://pdvlegalfast.beepayapp.com.br/>
{% endstep %}

{% step %}

### **Logotipo:**

* Clique em "Selecionar Logo" e escolha uma imagem em formato .JPG ou .PNG.
  {% endstep %}

{% step %}

### **E-mail e Telefone:**

* Preencha os campos com as informações de contato da loja.
* Clique em **Salvar**.

<figure><img src="/files/Z188fOoZfXIF5CpOuyOy" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### 3. Configuração de Pagamentos (Asaas) <a href="#id-3configuraodepagamentosassas" id="id-3configuraodepagamentosassas"></a>

{% hint style="info" %}
O BYP permite habilitar pagamentos via **cartão de crédito e PIX diretamente pelo aplicativo**, utilizando a plataforma **Asaas** como adquirente (Consulte o nosso time comercial para valores e taxas).
{% endhint %}

{% stepper %}
{% step %}

### **Ative o Módulo Asaas:**

* Entre no [**Portal OEM**](https://oem.tabletcloud.com.br/login.aspx?ReturnUrl=%2f) e selecione a licença do cliente.
* Procure e clique em "**BYP**"
* Clique em "**Gravar Licenciamento**"

<figure><img src="/files/57ld4yeA6DZacGad23Jo" alt=""><figcaption></figcaption></figure>

Após a ativação, você receberá um e-mail com as informações de acesso à sua conta Asaas (use o mesmo e-mail da retaguarda).
{% endstep %}

{% step %}

### **Configuração da Conta Asaas:**

* Acesse o ambiente Asaas e complete o cadastro, enviando a documentação necessária.
* Cadastre uma chave PIX aleatória no sistema Asaas.
* Gere uma API Key: **Perfil** > **Configurações** > **Integração** > **Gerar API Key**.
* Copie a API Key gerada.
  {% endstep %}

{% step %}

### **Configuração no BYP:**

No painel do BYP, role a tela até encontrar os campos de configuração da plataforma de pagamento:

* **Plataforma de Pagamento:** ASAAS
* **Modo:** PROD
* **Shop ID:** (deixe em branco)
* **Chave de Produção:** (cole a API Key do Asaas)
* **Chave de Teste:** (cole a API Key do Asaas)

<figure><img src="/files/tUP3XhiapbRs9mTcAwGY" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Ativação das Formas de Pagamento:**

* No painel do BYP, acesse **Formas de Pagamento**.
* Ative as seguintes opções:
  * **Pagamento Via Caixa Expresso**
  * **Pagamento Via Aplicativo**
* **Formas de Pagamento Vendas:** Cartão de Crédito, Saldo, Saldo + Cartão de Crédito, PIX Pelo App.
* **Formas de Pagamento Recarga:** Cartão de Crédito, PIX Pelo App.
* Clique em **Salvar**.

<figure><img src="/files/KBWPQ4QaHtXMgyo2Wy4I" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### 4. Geração do QR Code da Loja <a href="#id-4geraodoqrcodedaloja" id="id-4geraodoqrcodedaloja"></a>

{% stepper %}
{% step %}
No painel do BYP, acesse **Produtos**.
{% endstep %}

{% step %}
Copie o número exibido no campo **PDV**.
{% endstep %}

{% step %}
Acesse um gerador de QR Code online (ex: QR Code Tiger, QR Stuff).
{% endstep %}

{% step %}
Selecione a opção "Texto" e cole o número copiado.
{% endstep %}

{% step %}
Gere e baixe o QR Code em formato .PNG.
{% endstep %}

{% step %}
Compartilhe o QR Code com os clientes para acesso à loja no aplicativo.

<figure><img src="/files/x5fKk7WprgKwL6STfPqg" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### 5. Interface do Usuário no Aplicativo <a href="#id-5interfacedousurionoaplicativo" id="id-5interfacedousurionoaplicativo"></a>

{% stepper %}
{% step %}

### **Tela Inicial:**

Após ler o QR Code, o usuário verá a tela inicial da loja.

<figure><img src="/files/XSd45EhFfraOwHpT6Fch" alt="" width="181"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Início da Compra:**

O usuário clica em "Iniciar Compra".
{% endstep %}

{% step %}

### **Leitura de Produtos:**

O usuário lê os códigos de barra dos produtos desejados.
{% endstep %}

{% step %}

### **Carrinho:**

Os produtos adicionados são exibidos no carrinho.

<figure><img src="/files/x5l9Sc3aQJtewquUKuDi" alt="" width="181"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Finalização:**

O usuário clica em "Finalizar Compra" para prosseguir para o pagamento.
{% endstep %}

{% step %}

### **Pagamento:**

O usuário escolhe a forma de pagamento configurada (cartão, saldo, PIX).

<figure><img src="/files/qbW0etfcWhK28Cewu6FK" alt="" width="182"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 6. Automação de Portas (IGOPASS) <a href="#id-6automaodeportasigopass" id="id-6automaodeportasigopass"></a>

{% stepper %}
{% step %}

### **Ativação:**

* No painel do BYP, acesse **Automações de Portas**.
* Marque a opção **Ativo**.
* Selecione **Igopass**.
* Preencha os campos:
  * **Cliente ID:** `Om5cJloFUTOnmS5IZfmptJr5DZ82`
  * **Cliente Chave:** `KgPlUEDlxYQ1eXutdrAO`
* Clique em **Salvar**.
  {% endstep %}

{% step %}

### **Cadastro de Dispositivos:**

* Clique em **Novo Dispositivo**.
* Preencha os campos:
  * **Nome do Dispositivo:** (ex: "Porta de Entrada")
  * **Código:** (código fornecido pelo parceiro IGOPASS ou lido do QR Code do dispositivo)
  * **PDV:** (selecione a loja)
  * **Para Maiores de 18 anos:** (Sim/Não)
  * **Ativo:** (Sim/Não)
* Clique em **Salvar**.
  {% endstep %}

{% step %}

### **Edição de Dispositivos:**

Para editar um dispositivo cadastrado, clique no ícone de lápis (editar).

1. **Ativação:** No painel do BYP, acesse **Automações de Portas**.
   * Marque a opção **Ativo**.
   * Selecione **Igopass**.
   * Preencha os campos:
     * **Cliente ID:** `Om5cJloFUTOnmS5IZfmptJr5DZ82`
     * **Cliente Chave:** `KgPlUEDlxYQ1eXutdrAO`
   * Clique em **Salvar**.
2. **Cadastro de Dispositivos:**
   * Clique em **Novo Dispositivo**.
   * Preencha os campos:
     * **Nome do Dispositivo:** (ex: "Porta de Entrada")
     * **Código:** (código fornecido pelo parceiro IGOPASS ou lido do QR Code do dispositivo)
     * **PDV:** (selecione a loja)
     * **Para Maiores de 18 anos:** (Sim/Não)
     * **Ativo:** (Sim/Não)
   * Clique em **Salvar**.
3. **Edição de Dispositivos:** Para editar um dispositivo cadastrado, clique no ícone de lápis (editar).

   <figure><img src="/files/3WyXva3bSJA4eNv3HnO4" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

***

## Processo de Solicitação da POS Única

O BYP permite habilitar o uso de POS (Point of Sale - maquininha de cartão) pelo aplicativo, utilizando o parceiro Única.

{% hint style="warning" %}
**Observações Importantes:**

* O CNPJ solicitante na Única deve ser o **mesmo CNPJ** utilizado para abrir a licença do BYP.
* Para verificar o CNPJ no sistema, acesse o campo **Perfil Mercado** no painel do BYP.
* A POS Única Max aceita as seguintes formas de pagamento: Débito, Crédito, PIX e Vouchers. O acionamento destas formas na maquininha deve ser tratado diretamente com a Única durante a contratação.
  {% endhint %}

<figure><img src="/files/eAIvSL99hbuuH6uoxLHU" alt=""><figcaption></figcaption></figure>

### 1. **Primeira Solicitação da POS Única** <a href="#id-71processodesolicitaodaposnica" id="id-71processodesolicitaodaposnica"></a>

{% stepper %}
{% step %}

### **Solicitação da Adquirência**

* **Opção 1: Trazer Adquirência Própria:** O cliente pode utilizar sua adquirente atual, informando o número lógico e as taxas negociadas.
* **Opção 2: Solicitar Adquirência Stone via Beepay:**
  1. Envie um e-mail para `rita@beepayapp.com.br` com os seguintes dados:
     * CNPJ;
     * CPF do responsável;
     * Sócio - Nome completo do responsável;
     * Sócio - Data de nascimento do responsável;
     * Sócio - Ocupação e Renda mensal do responsável;
     * Sócio – Celular;
     * E-mail para acesso;
     * Endereço completo com CEP;
     * Dados bancários para recebimento (banco / agência e dígito / conta e dígito / tipo de conta).
  2. Aguarde o retorno por e-mail da Stone com os dados necessários para prosseguir.
     {% endstep %}

{% step %}

### **Envio dos Dados da Adquirência para Única**

* Compile os seguintes dados da adquirência do cliente:
  * CNPJ;
  * Nome do Cliente;
  * Número lógico;
  * Códigos enviados pela adquirente.
* Envie estas informações para os seguintes e-mails:
  * `tgv@martins.com.br`
  * `parcerias.simtech@martins.com.br`
  * `jacqueline.santarem@martins.com.br`
  * `fabio@beepayapp.com.br`
  * `rita@beepayapp.com.br`
    {% endstep %}

{% step %}

### **Preenchimento do Formulário Única**

* Acesse e responda o formulário no link: [Formulário Única](https://simtech.martins.com.br/SIMTECH.CONTRATO/Paginas/Questionarios/Ind%20ex?35%20)
* **Orientações para preenchimento:**
  * **Perguntas 1, 2, 3, 4 e 5:** Informações sobre o cliente solicitante.
  * **Pergunta 6 (CNPJ Parceiro):** `28.019.720/0001-18`
  * **Pergunta 7 (Nome Parceiro):** `Beepay`
  * **Pergunta 8, 9 e 10:** Dados de quem está solicitando (se for uma franquia, colocar o nome da franquia entre parênteses ao lado do seu nome).
  * **Pergunta 11 (Modelo POS):** Selecionar `UNICAMAX`.
  * **Pergunta 12 (Quantidade):** Número de máquinas desejadas.
  * **Pergunta 13:** Informações adicionais (se houver).
  * **Pergunta 14:** (Não responder).
  * **Pergunta 15 (Código Promocional):** `68475`
  * **Pergunta 16:** Será preenchido automaticamente.

{% hint style="info" %}
Após estes procedimentos, a Única encaminhará a demanda a um consultor regional, que entrará em contato com o lojista para negociar taxas e mensalidades (valor padrão informado: R$ 99,00 - o valor pode sofrer alterações, consulte o nosso time comercial).
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 2. Ativando a POS da Única no BYP <a href="#id-72ativandoaposdanicanosistemapdvlegalfast" id="id-72ativandoaposdanicanosistemapdvlegalfast"></a>

{% stepper %}
{% step %}
Acesse o ambiente do BYP.
{% endstep %}

{% step %}
Vá para o campo **POS**.
{% endstep %}

{% step %}
Clique em **Registrar estabelecimento**.
{% endstep %}

{% step %}
No campo **Plataforma pagamento físico**, selecione **Única**.

* O CNPJ do lojista será carregado automaticamente. **Confira se é o mesmo CNPJ** utilizado na solicitação da maquininha com a Única.
  {% endstep %}

{% step %}
No campo **Selecione o modo**, clique em **Produção**.
{% endstep %}

{% step %}
Salve as configurações.
{% endstep %}
{% endstepper %}

<figure><img src="/files/AKxur7Mc4D1lZhO93fl0" alt=""><figcaption></figcaption></figure>

***

### **3. Configurando a Maquininha no BYP**

{% stepper %}
{% step %}
Ainda na aba **POS**, clique no submenu **Maquininha**.
{% endstep %}

{% step %}
Ao abrir a nova janela, clique em **Novo POS**.
{% endstep %}

{% step %}
Preencha os seguintes campos:

* **SERIAL:** Colocar o número de série da POS (apenas a numeração). Este número geralmente se encontra na base de carregamento ou abaixo da bateria (remova-a da POS). O lojista que recebeu a POS deverá fornecer este número (costuma ter a sigla "NS" antes do número).

<figure><img src="/files/iRk1KtL09fmlThSVgE1R" alt=""><figcaption></figcaption></figure>

* **Tipo:** Selecionar a opção `UnicaMax`.
* **PDV:** Selecionar a qual loja a sua POS ficará vinculada (nome da loja). Esta informação também deverá ser repassada pelo lojista.
* **Status:** Selecionar a opção `Ativado`.
  {% endstep %}

{% step %}
Clique em **Salvar**.
{% endstep %}
{% endstepper %}

<figure><img src="/files/RcNjqsrhc88YJoijK9sq" alt=""><figcaption></figcaption></figure>

***

### 4. **Configurações Adicionais de Formas de Pagamento para POS**

{% stepper %}
{% step %}
Clique na aba **Formas de Pagamento**.
{% endstep %}

{% step %}
Ative a opção **Pagamento Via Caixa Expresso** (caso não esteja ativada).
{% endstep %}

{% step %}
Marque a opção **Maquininha Conciliada**.
{% endstep %}

{% step %}
Dentro do campo **Plataforma de pagamento POS**, selecione `UnicaMax`.
{% endstep %}

{% step %}
Clique em **Salvar**.
{% endstep %}
{% endstepper %}

<figure><img src="/files/2I21juJbMcFSKWhA6RWu" alt=""><figcaption></figcaption></figure>

Após estas configurações, solicite ao lojista que reinicie a POS.

### 5. **Solicitação de POS Adicionais (2ª Solicitação em diante)**

Caso o lojista necessite de mais máquinas POS para o mesmo CNPJ ou para outras lojas:

* Envie a solicitação por e-mail para:
  * `tgv@martins.com.br`
  * `parcerias.simtech@martins.com.br`
  * `jacqueline.santarem@martins.com.br`
  * `rita@beepayapp.com.br`
* Com os seguintes dados:
  * CNPJ;
  * Nome do Cliente;
  * Quantidade de máquinas.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.pdvlegal.com.br/integracoes/byp-o-que-preciso-saber.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.