SDK Barte para Captura Segura de Dados de Cartão

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 https://api-barte.com/v2/sdk/access-token

Headers:

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

Resposta:

{
  "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 NPM

npm install barte-sdk-web

Via Script HTML

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

---

4. Utilização do SDK

Exemplo de implementação:

const sdk = new BarteSDK({
  accessToken: "eyJhbGciOiJIUzI1NiJ9..."
});

try {
  const result = await sdk.cardToken({
    cardHolderName: "JOSE DAS NEVES TEST",
    cardCVV: "220",
    cardExpiryDate: "12/2025",
    cardNumber: "5383638854440891",
    buyerUuid: "751f9b5b-7185-465e-a8e4-b958d3b36006"
  });

  console.log(result);
} catch (error) {
  console.error(error);
}

---

Observações importantes

🔸 buyerUuid é obrigatória e deve representar o comprador. 🔸 Os dados sensíveis não passam pelos seus servidores, são enviados apenas ao SDK para a tokenização. 🔸 A resposta do método cardToken() retorna um tokenId, que pode ser utilizado em transações futuras.

---