---
title: "Overview da Autenticação (Stone Online)"
url: "https://devcenter.stone.com.br/legacy-stone-online-overview-da-autenticacao"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~T3ZlcnZpZXcgZGEgQXV0ZW50aWNhw6fDo28gKFN0b25lIE9ubGluZSk,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktc3RvbmUtb25saW5lLW92ZXJ2aWV3LWRhLWF1dGVudGljYWNhbyI,s_NV8c4IoTX8N-XYsK.png"
---

# Overview da Autenticação

Documentação legada · Autenticação

Documentação legada do Stone Online

Esta página descreve a **API Stone Online** (versão legada). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

A autenticação para o Stone Online 4.0 está amplamente ligada com o modelo de negócio do integrador à nossa API.

## [Gateways](#gateways)

Caso o seu modelo de negócio seja um Gateway será necessário que o lojista responsável pela afiliação Stone faça a geração de uma chave transacional. Isso é necessário para garantir a autorização explícita do lojista à sua integração.

**Como gerar as credenciais (SecretKey)?**

O processo de geração de credenciais está detalhado [aqui](https://online.stone.com.br/docs/gerando-a-secret-key-stone) . O cliente terá acesso as chaves do ambiente de produção:

Exemplo de prefixo da \*\*SecretKey \*\*de Produção: `sk_xxxxxx`

**Como utilizar a SecretKey?**

Para se autenticar conosco você deve enviar a SecretKey no \*\*Header \*\*`Authorization`, seguindo o padrão da [HTTP Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication), seguindo conforme abaixo:

**username:** SecretKey em Basic Auth  
**password:** vazio

**Basic Auth**

```javascript
var fs = require('fs');
const request = require("request");

var authorization = 'Basic '+ Buffer.from("sk_xxxxxx:").toString('base64');

console.log(authorization);
```

Caso você seja um emissor de transações ou seja, transacione como uma **subadquirente** e seu cliente não possua uma afiliação própria com a Stone, você deve entrar em contato com o nosso time de parcerias para desenvolvimento da sua integração.

## [Subadquirentes](#subadquirentes)

Para utilizar nossa API, como subadquirente, é necessário realizar a autenticação através de um token de acesso. Este token é gerado pelo nosso Identity Provider (IDP) e identifica unicamente cada cliente (StoneCode).

### [Como funciona](#como-funciona)

**Obtenção das credenciais:** Entre em contato com seu comercial para solicitar as credenciais de acesso.

\*\*Geração do token: \*\*Utilize as credenciais fornecidas para gerar um token de acesso através do nosso IDP de acordo com o [guia](https://devcenter.stone.com.br/apis/stone-online-legacy/docs).

**Envio do token:** Inclua o token em cada requisição à API, no cabeçalho da requisição

O token possui um tempo de validade. Após expirar, será necessário gerar um novo token.

Mantenha suas credenciais de acesso em segurança e siga as melhores práticas de segurança para proteger o token de acesso.

---

**Jornada: [Estrutura e autenticação da API](https://devcenter.stone.com.br/legacy-stone-online-aviso)**  
Etapa 4 de 4

[**Etapa anterior**Ambientes](https://devcenter.stone.com.br/legacy-stone-online-ambientes)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.