> For the complete documentation index, see [llms.txt](https://ajuda.pdvlegal.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.pdvlegal.com.br/integracoes/byp.md).

# BYP

O **BYP** transforma o celular do cliente em um canal de compra integrado ao **PDV Legal**.

Com ele, o cliente acessa a loja pelo smartphone, monta o carrinho e finaliza a compra no próprio app.

{% hint style="success" %}
**Principais vantagens**

* reduz a dependência de hardware dedicado
* simplifica a jornada de compra no celular
* mantém a operação integrada 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**

* ative o módulo **BYP** no licenciamento
* garanta que os produtos já estejam cadastrados corretamente
* acesse o painel em <https://api.beepayapp.com.br/login>
* use como login o e-mail cadastrado na ativação
* use como senha os 6 primeiros dígitos do CPF ou CNPJ
  {% endhint %}

### 1. Ativar e configurar o BYP

#### Ativar o módulo e preparar produtos

{% stepper %}
{% step %}

### Ativar 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 %}

### Configurar os produtos na 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 %}

### Atualizar 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. Configurar a loja

{% stepper %}
{% step %}

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

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

{% step %}

### Ajustar o logotipo

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

{% step %}

### Preencher 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. Configurar pagamentos com Asaas

{% 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 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 %}

### Ativar as 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. Gerar o QR Code da loja

{% 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. Entender a jornada do cliente

{% stepper %}
{% step %}

### Abrir a 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 %}

### Iniciar a compra

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

{% step %}

### Ler os produtos

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

{% step %}

### Revisar o carrinho

Os produtos adicionados são exibidos no carrinho.

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

{% step %}

### Finalizar a compra

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

{% step %}

### Escolher a forma de 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. Configurar automação de portas

{% stepper %}
{% step %}

### Ativar a integraçã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 %}

### Cadastrar 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 %}

### Editar dispositivos

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

Revise os campos de identificação, status e restrição de idade. Depois, clique em **Salvar**.

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

{% endstep %}
{% endstepper %}

***

### 7. Solicitar e ativar POS Única

O BYP também permite operar com POS pelo parceiro **Única**.

{% hint style="warning" %}
**Antes de solicitar a POS**

* O CNPJ usado na Única deve ser o mesmo da licença do **BYP**.
* Você pode validar esse CNPJ em **Perfil Mercado**.
* A **POS Única Max** aceita débito, crédito, Pix e vouchers.
  {% endhint %}

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

#### 7.1 Solicitar a primeira POS

{% 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 %}

***

#### 7.2 Ativar a POS no BYP

{% 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>

***

#### 7.3 Cadastrar a maquininha

{% 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>

***

#### 7.4 Ajustar formas de pagamento da 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.

#### 7.5 Solicitar POS adicionais

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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.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.