Pular para o conteúdo principal
Este guia fornece um processo detalhado, passo a passo, para integrar os Campos Inteligentes ao seu sistema de pagamento. Ao final, você poderá coletar informações de pagamento com segurança diretamente em seu site, enquanto a Localpayment gerencia os dados confidenciais.

Pré-requisitos

Certifique-se de ter estes componentes essenciais à mão:

Chaves de API

Obtenha suas chaves de autenticação no ambiente de Stage (teste) ou de Produção.

Código do cliente

Seu identificador exclusivo de comerciante, encontrado no Business Portal da Localpayment.

Configuração do backend

Um endpoint do servidor pronto para receber tokens de pagamento e processar transações.

Etapas de integração

  1. Inclua o SDK de Campos Inteligentes

Escolha o ambiente apropriado para sua integração:
Utilize esta ferramenta para desenvolvimento e testes com pagamentos simulados:
Dica
Sempre teste sua integração minuciosamente no ambiente de teste antes de entrar em produção.

  1. Inicialize o SDK

Inicialize o SDK com suas credenciais assim que o script for carregado:
Parâmetros de configuração:

  1. Criar uma sessão segura

Estabeleça uma conexão segura com os servidores da Localpayment:
Nota de segurançaA sessão estabelece canais de comunicação criptografados para todos os dados de pagamento.

  1. Configurar Formulário de Pagamento

Crie a estrutura HTML para o seu formulário de pagamento:

  1. Criar e configurar campos de pagamento

Inicialize os campos de pagamento seguros e integre-os ao seu formulário:
Use o método mount() para renderizar o iframe seguro dentro do contêiner especificado. Passe uma string de seletor CSS que identifique o elemento DOM de destino (por exemplo, #pan-container). Tipos e características dos campos:

  1. Lidar com eventos de campo e validação

Ouça os eventos de cada campo para atualizar sua interface de usuário e acompanhar o status de validação:

  1. Processar Submissão de Pagamento

Recupere os dados da sessão e o ID da sessão:

  1. Consolidar sessão e obter token

Crie uma requisição POST para o endpoint Consolidate, enviando o sessionId e os dados do titular do cartão:
Ambientes:
  • Stage:
  • Produção:
Resposta esperada da consolidação:

  1. Processar Pagamento

Crie um novo Payin e use o parâmetro token em vez das informações do titular do cartão. O token representa o método de pagamento de forma segura, sem expor dados confidenciais.

Recursos e próximos passos

Maximize o sucesso da sua integração com estes recursos essenciais.

Integração de Webhook

Configure notificações em tempo real para atualizações do status das transações.

Relatórios do Business Portal

Acesse análises detalhadas, ferramentas de geração de relatórios e recursos de conciliação.

Monitoramento de transações

Aprenda a consultar o status das transações e a implementar um rastreamento abrangente.

Referência da API

Documentação completa dos endpoints com exemplos interativos.

Dica profissionalSempre teste seu fluxo de trabalho em nosso ambiente de sandbox antes de implantá-lo em produção. Isso garante que o tratamento de erros, o processamento de webhooks e o rastreamento de status funcionem corretamente em todos os cenários.

Precisa de ajuda?Entre em contato com nossa equipe de suporte caso encontre algum problema ou precise de ajuda com a integração.

Última modificação em 10 de novembro de 2026