Manual de integração 3DS no HUB

Índice

1. Visão Geral
2. Como habilitar o 3DS para o cliente
3. Como solicitar o Token
4. Continuação da integração

Visão Geral

O fluxo de 3DS via HUB 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.

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

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

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

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

Headers

O Header deve conter os seguintes campos:

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

Body da Requisição

Enviar o campo merchant_id contendo a accountId do cliente:

{
  "merchant_id": "acc_"
}

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

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