É um recurso amplamente utilizado no e-commerce para agilizar o processo de compra, sem 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 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, API Customer;
- 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.
|
|