> For the complete documentation index, see [llms.txt](https://docs.barte.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.barte.com/sdks/sdk-web/readme.md).

# Instalar SDK

## Visão Geral

O SDK Barte permite que sellers capturem dados de cartão de forma segura no checkout, sem que essas informações sensíveis passem pelos seus servidores.

A tokenização dos dados reduz significativamente o escopo de PCI Compliance e protege o comprador.

***

## 1. API Token

Antes de utilizar o SDK, é necessário obter o API Token do Seller. Para isso, acesse o painel do Seller da Barte (área logada) e siga as instruções abaixo:

Acesse o menu lateral e clique na opção "Integração" conforme a imagem a seguir:

<figure><img src="https://1150314297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3bRh9TXBFT63kV1frNxK%2Fuploads%2Fy6C6fXBUY11yDQi0S6uU%2Fimage.png?alt=media&amp;token=f9f8d240-02d5-4a02-af26-ec2c82430ceb" alt=""><figcaption><p>Figura 1 - Menu de integração painel do Seller</p></figcaption></figure>

Na seção "Chaves API" crie um novo token, conforme imagem abaixo (opção 1), ou copie uma chave já existente (opção 2). Caso a chave já criada não esteja visível, exiba-a e a opção de copiar será mostrada.

<figure><img src="https://1150314297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3bRh9TXBFT63kV1frNxK%2Fuploads%2FYHVdRI64mylkrOJWiIgX%2Fimage.png?alt=media&amp;token=c6b5990c-da54-4af6-9048-f79036ebe5fa" alt=""><figcaption><p>Figura 2 - Criação ou obtenção de uma chave de API</p></figcaption></figure>

## 2. Obter Access Token para o SDK

Utilize o api token obtido no passo anterior para obter o `accessToken`, que será utilizado na inicialização do SDK.

**Endpoint:**

```
GET /v2/sdk/access-token
```

| Ambiente | URL base                        |
| -------- | ------------------------------- |
| Produção | <https://api.barte.com>         |
| Sandbox  | <https://sandbox-api.barte.com> |

**Headers:**

```http
"X-Token-Api": {{token_obtido_anteriormente}}
```

**Resposta:**

```json
{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9..."
}
```

**Observação:**

O token gerado possui uma expiração de 15 minutos.

***

## 3. Instalação do SDK

Você pode instalar o SDK de duas maneiras.

### Via Script HTML

```html
<script src="https://sdk-client.barte.com/sdk.min.js"></script>
```

### Via NPM

```bash
npm install barte-sdk-web
```

O mesmo pacote atende todos os ambientes. Quem escolhe o ambiente é a opção `environment` do construtor, descrita na seção seguinte.

***

## 4. Ambientes

A opção `environment` do construtor define o ambiente por inteiro: tanto as URLs de API que o SDK consulta quanto a página segura de captura de dados do cartão. Quando ela não é informada, o padrão é `production`.

Para homologar em sandbox, basta `environment: "sandbox"` com um `accessToken` criado em sandbox.

**Versões anteriores à 1.2.0**

Até a versão 1.1.3, a opção `environment` trocava apenas as URLs de API, e a página de captura vinha sempre do host de onde o SDK tinha sido carregado. Se você usa o pacote do npm preso a uma versão anterior, atualize para a 1.2.0 ou carregue o script a partir de `https://sandbox-sdk-client.barte.com/sdk.min.js` para homologar em sandbox.

***

## 5. Domínios autorizados

A página segura de captura de dados do cartão só carrega dentro de sites com domínio autorizado pela Barte. Em um site fora dessa lista, o formulário de cartão não aparece e a tokenização não acontece.

Para autorizar um domínio, envie ao seu contato na Barte ou ao nosso suporte o endereço das páginas onde o checkout é exibido, por exemplo `https://loja.seudominio.com.br`. Faça isso antes de publicar a integração e sempre que o checkout passar a aparecer em um domínio novo.

**Desenvolvimento e homologação**

Em produção, endereços locais (`localhost`, `127.0.0.1` ou IPs da rede interna) não são aceitos. Para desenvolver, use o ambiente de sandbox (veja a seção Ambientes), que aceita `localhost`. Para homologar a partir de um domínio próprio de testes, peça a autorização desse domínio também no sandbox.

**Aplicativos com WebView**

Se o seu aplicativo exibe o checkout dentro de uma WebView, a página precisa ser carregada a partir de um endereço com domínio autorizado. Uma WebView que carrega o HTML diretamente, sem um endereço de origem (base URL), não é reconhecida, e o formulário de cartão não carrega.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.barte.com/sdks/sdk-web/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
