Tokenizar
POST
/card/tokenize
Quando os dados do cartão são enviados para a tokenização, a API gera um identificador único (A rota recebe os dados necessários para identificar e validar o cartão e retorna um Os dados enviados para a tokenização incluem:
O campo Esse campo não altera nem representa a validade do cartão. Ele determina por quanto tempo o Após a tokenização, a API retorna um O Um cartão tokenizado pode ser excluído utilizando a rota Para excluir a tokenização, basta enviar o
cardId) que poderá ser utilizado posteriormente para processar pagamentos sem precisar enviar novamente os dados completos do cartão.💳 Tokenização do Cartão
cardId.🔒 O
cardId funciona como o identificador do cartão tokenizado e pode ser utilizado posteriormente na rota de processamento de pagamento.📝 Dados do Cartão
name → Nome utilizado para identificar o cartão.holderName → Nome impresso no cartão.expirationDate → Data de validade do cartão.number → Número do cartão.securityCode → Código de segurança do cartão.tokenizeExpiration
tokenizeExpiration é opcional e define o período de validade da tokenização.cardId permanecerá válido para utilização.⏳ A validade definida em
tokenizeExpiration controla exclusivamente a expiração da tokenização. A validade original do cartão continua sendo definida pelo campo expirationDate.🔐 Resultado da Tokenização
cardId.✅ O
cardId deve ser armazenado pelo sistema para utilização em futuras transações, enquanto a tokenização estiver válida.cardId pode ser enviado posteriormente na rota de processamento de pagamento no lugar dos dados completos do cartão.🗑️ Exclusão do Cartão
/card/delete.cardId correspondente.⚠️ Importante: após a exclusão, o
cardId não deverá mais ser utilizado para processar pagamentos.📌 Regras
- Os dados do cartão são enviados para gerar um
cardId. - O
cardIdidentifica o cartão tokenizado. - O
tokenizeExpirationé opcional. tokenizeExpirationdefine exclusivamente a validade da tokenização.tokenizeExpirationnão altera a validade do cartão.- A validade do cartão é informada através do campo
expirationDate. - O
cardIdpode ser utilizado posteriormente para processar pagamentos enquanto a tokenização estiver válida. - Não é necessário enviar novamente os dados completos do cartão ao utilizar um
cardId. - A tokenização pode ser excluída através da rota
/card/delete. - A exclusão é realizada informando o
cardId.
Requisição
Parâmetros Bodyapplication/jsonNecessário
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/card/tokenize' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Cartão Teste",
"holderName": "Nome impresso no cartão",
"expirationDate": "25/30",
"number": "000000000000000",
"securityCode": "0000"
}'Response Response Example
{
"success": true,
"message": "Cartão tokenizado com sucesso",
"cardId": "00000000-0000-0000-0000-000000000000"
}Modificado em 2026-09-03 18:23:35