# C6 Bank

## **Visão Geral do Módulo**

A integração com o C6 Bank conecta o UpGestão à sua conta na plataforma para automatizar cobranças, recebimentos e conciliações bancárias por meio da API de pagamentos.

Você pode acessar todo o passo a passo para criar uma conta financeira [clicando aqui](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/configuracoes-da-conta/detalhes-da-conta/empresas#cobranca).

{% hint style="danger" %}
**IMPORTANTE:** Para integrações entre sistemas de pagamento, o campo "Integrador", é **OBRIGATÓRIO** e deve ser preenchido conforme a necessidade.
{% endhint %}

## **Obter chaves de acesso**

Para realizar operações no UpGestão é necessário configurar sua conta C6 Bank nas configurações da Empresa. Para obter as chaves de acesso necessárias e o certificado, deve-se efetuar o download do navegador do C6 Bank [clicando aqui](https://www.c6bank.com.br/web-banking/).

Após a instalação e autenticação no navegador, siga os passos do vídeo abaixo:

{% embed url="<https://www.youtube.com/watch?v=kTOFS7nmBfQ&feature=youtu.be>" %}

{% hint style="warning" %}
É importante lembrar que a integração com a API do C6 Bank só está disponível no Web Banking quando o cliente for:

* Pessoa Jurídica (padrão)
* Usuários com acesso de Administrador no aplicativo

Usuários que forem pessoa física, pessoa física com IE (Produtores Rurais) e MEI também podem ser correntistas do C6 Bank; no entanto, esses não terão acesso à integração com a API de geração de boleto e Pix do C6 Bank no momento.
{% endhint %}

***

{% hint style="warning" %}
IMPORTANTE: Embora os campos arquivo .crt, arquivo .key, Client ID, Client Secret e Chave Pix não sejam obrigatórios para o cadastro da conta bancária, todos estes dados são necessários para geração de boletos e PIX via C6 Bank. Estes dados podem ser obtidos ao baixar o [browser](https://www.c6bank.com.br/web-banking/) da C6 Bank.

Você pode entrar em contato com o SAC do C6 Bank a partir [desse link](https://www.c6bank.com.br/central-de-atendimento/).
{% endhint %}

{% hint style="info" %}
**GLOSÁRIO**

* **Arquivo .crt (Certificate File)**: Contém o **certificado digital** emitido por uma Autoridade Certificadora (CA). Ele autentica a identidade do servidor e estabelece uma conexão segura.
* **Arquivo .key (Private Key File)**: Contém a **chave privada** associada ao certificado. Essa chave é usada para descriptografar as informações recebidas e assinar as comunicações do servidor.
* **Client ID:** é um identificador público fornecido pelo provedor de serviços (banco, gateway de pagamento ou API). Usado para identificar a aplicação que está solicitando acesso à API.
* **Client Secret:** É uma chave privada associada ao **Client ID**, usada para autenticação segura. Funciona como uma senha que a aplicação usa para se identificar ao servidor da API. Deve ser protegida e não compartilhada, pois permite acesso à conta.
* **Chave Pix:** Identificador único usado para receber pagamentos via Pix. Pode ser um **CPF/CNPJ, e-mail, número de telefone ou chave aleatória**. Associada à conta bancária do usuário ou empresa para facilitar transferências sem precisar informar dados bancários completos.
  {% endhint %}

***

### Gerar Boleto C6 Bank

Para gerar um Boleto do C6, o usuário deve criar uma [Receita](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/modulos-do-upgestao/financeiro/receitas) no módulo [Financeiro](https://virtux-up-gestao.gitbook.io/virtux-up-gestao/modulos-do-upgestao/financeiro) e colocar os seguintes dados:

* Em "Conta Financeira" selecionar a opção "C6 Bank"
* Em "Forma de pagamento" selecionar a opção "Cobrança Boleto"

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FCoF8wcVpsMBWKgDsQGqN%2Fimage.png?alt=media&#x26;token=2c195638-1130-401a-99ca-aa0675076036" alt=""><figcaption><p>Receita utilizada como exemplo.</p></figcaption></figure>

Após preencher os demais dados da Receita, clique em "Opções (...)" > Gerar Cobrança".

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2F3b6YNnPyVIoezlGntuwb%2Fimage.png?alt=media&#x26;token=0369422c-647e-4bea-b800-76c2edabe496" alt=""><figcaption><p>Tela de cadastro/edição de Receita</p></figcaption></figure>

Caso o boleto seja gerado com sucesso, será exibida a seguinte mensagem: "Boleto gerado com sucesso".

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FfX1d0KRKuSqb3vneKJx7%2Fimage.png?alt=media&#x26;token=c7580482-4c72-4629-af8c-cedbc9fe498f" alt=""><figcaption><p>Tela de cadastro/edição de Receita</p></figcaption></figure>

Para acessar o boleto gerado, basta clicar em "Opções > Dados da Cobrança".

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2Fu4OVUiYZIYACPS5KIAbf%2Fimage.png?alt=media&#x26;token=391cd6df-4989-4cde-9c2f-1fe003997ffa" alt=""><figcaption><p>Tela de cadastro/edição de Receita</p></figcaption></figure>

É então exibida uma modal contendo os dados da cobrança, o código de barras para pagamento e as opções de cancelar e imprimir cobrança.

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2Fhz8ERGNnRjfcNI8bukUM%2Fimage.png?alt=media&#x26;token=19d5b847-39a0-483f-a4a2-5b110aa8fa73" alt=""><figcaption><p>Modal de dados da cobrança.</p></figcaption></figure>

Ao clicar no botão imprimir, será realizado o download do PDF para envio para o cliente ou para pagamento.

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FMtpsErTiaJNEFNoDXvpz%2Fimage.png?alt=media&#x26;token=223f0785-012c-4328-bf5c-9cec184edb9f" alt=""><figcaption><p>Boleto C6 Bank exemplo.</p></figcaption></figure>

### Gerar Pix C6 Bank

Para gerar um Pix do C6, o usuário deve registrar uma Venda e dentro do submenu Venda e colocar os seguintes dados:

* Em "Conta Financeira" selecionar a opção "C6 Bank"
* Em "Forma de pagamento" selecionar a opção "Cobrança Pix"

Após preencher os demais dados da Venda, clica em "Opções > Gerar Pix".

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2FZIjoRYI7Hz64obufmbua%2Fimage.png?alt=media&#x26;token=9ffe936a-3059-458e-bd32-33c187051002" alt=""><figcaption><p>Tela de cadastro/edição de Venda</p></figcaption></figure>

Após clicar nesta opção, é gerado o Pix para pagamento com os resumo dos dados da transação.

<figure><img src="https://1161857615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wn7EUWejKXd9iav0QSe%2Fuploads%2F2DcEbvucjzJqy5JwdcoB%2Fimage.png?alt=media&#x26;token=3172c32d-b508-4546-9d1f-b3172262944d" alt=""><figcaption><p>Modal de recebimento Pix</p></figcaption></figure>

Na modal o usuário consegue copiar o link de pagamento, compartilhar via mensagem WhatsApp ou compartilhar em outras redes sociais.
