---
title: "Integração do 3DS no HUB (legado)"
url: "https://devcenter.stone.com.br/legacy-integracao-3ds-hub"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~SW50ZWdyYcOnw6NvIGRvIDNEUyBubyBIVUIgKGxlZ2Fkbyk,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktaW50ZWdyYWNhby0zZHMtaHViIg,s_7SVbTAWPsnqkq-lI.png"
---

# Integração do 3DS no HUB

Documentação Pagar.me v5 — referência histórica.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Índice](#índice)

1.  [Visão Geral](#vis%C3%A3o-geral)
2.  [Como habilitar o 3DS para o cliente](#como-habilitar-o-3ds-para-o-cliente)
3.  [Como solicitar o Token](#como-solicitar-o-token)
4.  [Continuação da integração](#continua%C3%A7%C3%A3o-da-integra%C3%A7%C3%A3o)

## [Visão Geral](#visão-geral)

O fluxo de 3DS via [HUB](https://docs.pagar.me/docs/hub-1) se diferencia do fluxo padrão da empresa apenas na etapa de solicitação do JWT.  
Os demais passos podem utilizar o 3ds-js (3ds-nx) e seguir o fluxo normal descrito no [https://docs.pagar.me/docs/manual-integracao-3ds](https://docs.pagar.me/docs/manual-integracao-3ds).

## [Como habilitar o 3DS para o cliente](#como-habilitar-o-3ds-para-o-cliente)

-   Verifique com o time comercial se o seu parceiro já está integrado ao 3DS;
-   Se sim, solicite o seu cadastro ao time comercial;
-   Autorize o APP a realizar a solicitação do Token JWT, ativando as permissões do aplicativo no Hub:
    -   Obter um Token de autenticação do 3DS
    -   Obter um Token de autenticação do 3DS Sandbox

![](https://files.readme.io/f22b349f6fc2c1dd51334720b66217eb9a4607028cb96e74be853c78e3708db7-image.png)

## [Como solicitar o Token](#como-solicitar-o-token)

Após o cadastro e a autorização serem feitos, é possível fazer a requisição para obter o token que será utilizado para consumir a biblioteca do 3DS.

### [Endpoint](#endpoint)

Deverá ser feita uma requisição **POST** para seguinte URL:

```text
https://hubapi.pagar.me/v2/management/tds-token
```

### [Headers](#headers)

O Header deve conter os seguintes campos:

```http
Authorization: Bearer {ACCESS_TOKEN_DO_HUB}
X-Hub-Environment: {live | test}
Content-Type: application/json
```

| Header            | Descrição                                   |
| :---------------- | :------------------------------------------ |
| Authorization     | Access Token do Hub no formato Bearer       |
| X-Hub-Environment | Ambiente da requisição (live ou test)       |
| Content-Type      | Tipo do conteúdo enviado (application/json) |

### [Body da Requisição](#body-da-requisição)

Enviar o campo `merchant_id` contendo a `accountId` do cliente:

```json
{
  "merchant_id": "acc_"
}
```

### [Observações importantes](#observações-importantes)

A requisição deve ocorrer no back-end, pois utiliza o Access Token do Hub.  
O retorno será um JWT (este, sim, pode ser repassado ao front-end).  
O JWT tem tempo de vida de 20 segundos.

## [Continuação da integração](#continuação-da-integração)

Após obter o JWT, siga o fluxo padrão da documentação do [https://docs.pagar.me/docs/manual-integracao-3ds](https://docs.pagar.me/docs/manual-integracao-3ds) , utilizando a biblioteca `3ds-nx-js`.

---

**Jornada: [3DS e tokenização](https://devcenter.stone.com.br/legacy-3ds)**  
Etapa 3 de 6

[**Etapa anterior**Manual de integração 3DS](https://devcenter.stone.com.br/legacy-manual-integracao-3ds)[**Próxima etapa**Migração 3DS: versões](https://devcenter.stone.com.br/legacy-migracao-3ds-versoes)

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.