É um recurso amplamente utilizado no e-commerce para agilizar o processo de compra, sem comprometer a segurança dos dados do consumidor.
Como a tokenização funciona? A tokenização é um código gerado por algoritmos que substitui as informações sensíveis dos consumidores que estão armazenadas em uma base de dados.


Requisitos:

Para utilizar nossa API é necessário que você tenha familiaridade com a terminologia básica utilizada no desenvolvimento de web services REST. É possível desenvolver a integração com praticamente todas as linguagens de programação disponíveis no mercado. Abaixo seguem os nomes das entidades que serão mencionadas nessa documentação e suas especificações.


Esse método permite guardar as informações do cartão para que seja utilizado no processo de adesão.


Procedimento de criação da tokenização do cartão.


Parâmetros de Entrada

{
  "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" //Id gerado na criação do Customers
}

Parâmetros de Saída

{
    "id": "341b5962-2023-45c7-932f-ac836e34f477", //Id gerado pelo payment-token
    "status": "Received", //Status 
    "url": "{url: Página de tokenização}", //Rota para inserir os dados do cartão. 
    "date": "2023-02-10T13:41:51.5239409+00:00" //Data de geração.
}

Coletando o id para realizar a gravação do cartão. 

Parâmetros de Entrada

https://recorrencia.totvs.app/api/v1/payment-token/payment-token/341b5962-2023-45c7-932f-ac836e34f477

Parâmetros de Saída

{
    "id": "341b5962-2023-45c7-932f-ac836e34f477",
    "customerId": "021eb296-b80e-4c5e-bdfb-4131459b3704",
    "nickname": null,
    "lastFourDigits": null,
    "checkoutPageLink": "{url: Página de tokenização},
    "status": 2,
    "acquirer": 2,
    "message": "Gerado link para a Tokenização",
    "dateAdd": "2023-02-10T13:41:51.52394",
    "isActive": false
}

Armazene o Id, pois será utilizado no momento da realização da subscrição.
Nesse exemplo: "id": "341b5962-2023-45c7-932f-ac836e34f477"


Acessar o link informado no campo checkoutPageLink, em seguida realize o preenchimento dos campos e clique em "Guardar Cartão"


Para uma listagem completa da saída por favor verifique a documentação Swagger.

Acesso a tela: API Subscrição com dados de pagamento.