> 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:
Figura 1 - Menu de integração painel do Seller
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.
Figura 2 - Criação ou obtenção de uma chave de API
## 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 | |
| Sandbox | |
**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
```
### 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.
---
# 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, and the optional `goal` query parameter:
```
GET https://docs.barte.com/sdks/sdk-web/readme.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
