Como funciona
O processo envolve estas etapas principais:- 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.
- 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.
- Uso do cartão tokenizado: Para pagamentos subsequentes com cartão, você enviará a propriedade
card.tokenem 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çãoPOST 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âmetrosave 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 ocard.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çãoGET 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çãoDELETE 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.

