Pular para o conteúdo principal
A tokenização com Localpayment oferece uma maneira segura de lidar com informações de cartão, reduzindo seus riscos de segurança e simplificando transações futuras.

Como funciona

O processo envolve estas etapas principais:
  1. Coleta de informações do cartão: As informações do cartão são coletadas com segurança por meio de um formulário em seu aplicativo e, em seguida, transmitidas para a API Localpayment.
  2. Geração de token: O Localpayment armazena com segurança as informações do cartão e gera um token único e irreversível que representa os dados do cartão. Esse token é retornado na resposta da API.
  3. Uso do cartão tokenizado: Para pagamentos subsequentes com cartão, você enviará a propriedade card.token em vez dos dados reais do cartão do cliente.

Antes de começar

Antes de tokenizar um cartão, certifique-se de ter concluído o seguinte:

Credenciais da API

Credenciais de API e token de acesso válidos para autenticação.

Configuração da conta

Configuração adequada da conta para o país de destino e verificação da empresa.

Lista branca de IPs

Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.

Endpoint do webhook

Configure um URL de webhook para receber notificações de pagamento.

Métodos de tokenização

Existem dois métodos disponíveis para tokenizar um cartão:

Opção 1: Endpoint para tokenização de cartões

Você pode tokenizar com segurança as informações do cartão para uso futuro por meio de um endpoint dedicado. Para tokenizar um cartão, envie uma requisição POST para o endpoint Tokenize Card com os seguintes parâmetros:

Exemplo de solicitação

curl

Exemplo de resposta bem-sucedida

Em resposta, a API retorna o token do cartão:

Campos de resposta principais

Opção 2: Tokenização do cartão durante o pagamento

A Localpayment permite que os comerciantes tokenizem cartões durante o processamento do pagamento incluindo o parâmetro save nas requisições de pagamento. Essa abordagem simplificada permite processar uma transação e armazenar os dados do cartão em uma única chamada de API. Para tokenizar um cartão, envie uma requisição POST para o endpoint Criar Payin e inclua a propriedade card.save definida como true na sua requisição de Payin.

Exemplo de solicitação

curl

Exemplo de resposta bem-sucedida

Em resposta, a API retorna o token do cartão:

Campos de resposta principais


Usando Cartões Tokenizados

Para usar um cartão tokenizado em um pagamento, inclua o card.token na sua requisição de pagamento.

Exemplo de solicitação com token

curl

Obtenha informações sobre o cartão

Após a tokenização de um cartão, você pode recuperar seus detalhes usando a API Localpayment. Isso permite exibir os métodos de pagamento armazenados aos clientes, mantendo a conformidade com o PCI. Para obter as informações do cartão, envie uma requisição GET para o endpoint Get Card Details, incluindo o token do cartão como parâmetro de consulta.

Exemplo de solicitação

curl

Exemplo de resposta bem-sucedida

Em resposta, a API retorna os dados do cartão:

Excluir um cartão tokenizado

Remova permanentemente os tokens de cartão armazenados por meio de um endpoint de API dedicado. Essa ação irreversível ajuda a manter a conformidade com as regulamentações de privacidade de dados e permite o gerenciamento adequado do ciclo de vida do cartão. Para excluir um cartão tokenizado, envie uma requisição DELETE para o endpoint Delete Tokenized Card, incluindo o token do cartão como parâmetro de consulta.

Exemplo de solicitação

curl

Exemplo de resposta bem-sucedida

Uma exclusão bem-sucedida normalmente retornará um objeto JSON vazio:

Próximos passos

Agora que você tokenizou um cartão com sucesso, pode usar o token gerado para processamento seguro em todos os serviços de pagamento da Localpayment:

Pagamentos únicos

Utilize o token para processar pagamentos únicos e imediatos.

Assinaturas

Configure ciclos de faturamento recorrentes automatizados usando o cartão tokenizado.

Parcelas

Ofereça opções de pagamento parcelado aos seus clientes usando o cartão tokenizado.

3D Secure

Aprimore a segurança dos pagamentos com cartão tokenizado com a autenticação 3D Secure.
Última modificação em 10 de novembro de 2026