É 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.
- Ter realizado o procedimento de criação do Customers;
- Possuir acesso ao Swagger.
| Card |
|---|
| label | Tokenização do cartão de crédito |
|---|
|
| Deck of Cards |
|---|
| | Card |
|---|
| label | Endpoint Payment-Token |
|---|
| 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 | Bloco de código |
|---|
| language | yml |
|---|
| title | POST payment-token |
|---|
| {
"customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" //Id gerado na criação do Customers
} |
Parâmetros de Saída | Bloco de código |
|---|
| language | yml |
|---|
| title | RESPONSE Payment-Token |
|---|
| {
"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 | Bloco de código |
|---|
| language | yml |
|---|
| title | GET Payment-Token |
|---|
| https://recorrencia.totvs.app/api/v1/payment-token/payment-token/341b5962-2023-45c7-932f-ac836e34f477 |
Parâmetros de Saída | Bloco de código |
|---|
| language | yml |
|---|
| title | RESPONSE Payment-Token |
|---|
| {
"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
} |
| Aviso |
|---|
| 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" 
|
Acesso a tela: API Subscrição com dados de pagamento.
|
|
