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
- Inclua o SDK de Campos Inteligentes
Escolha o ambiente apropriado para sua integração:
- Stage (Testes)
- Produção (Ao Vivo)
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.
Sempre teste sua integração minuciosamente no ambiente de teste antes de entrar em produção.
- Inicialize o SDK
Inicialize o SDK com suas credenciais assim que o script for carregado:
- 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.
- Configurar Formulário de Pagamento
Crie a estrutura HTML para o seu formulário de pagamento:
- Criar e configurar campos de pagamento
Inicialize os campos de pagamento seguros e integre-os ao seu formulário:
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:
- 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:
- Processar Submissão de Pagamento
Recupere os dados da sessão e o ID da sessão:
- 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:
- 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.

