Principais benefícios
Integração flexível e segura para a marca
Mantenha a consistência da marca com iframes personalizáveis que se incorporam perfeitamente ao seu checkout. Evite redirecionamentos de página e garanta uma jornada fluida, sem comprometer a experiência do usuário
Implementação rápida
Implante métodos de pagamento locais e internacionais sem precisar criar ou manter uma infraestrutura de frontend complexa. Nosso iframe permite que você entre no ar em minutos, acelerando os esforços de expansão e reduzindo a dependência de engenharia.
Menores custos de manutenção
Como o iframe é hospedado e mantido pela Localpayment, você se beneficia de atualizações contínuas sem nenhum impacto na sua implantação.
Conformidade e gestão de riscos simplificadas
Mantenha os dados sensíveis de pagamento fora dos seus servidores e reduza o seu escopo PCI. Com o iframe, os comerciantes transferem para a Localpayment tanto a responsabilidade de segurança quanto a responsabilidade de conformidade.
Casos de uso
A solução de Iframe incorporado se adapta a praticamente qualquer cenário de pagamento. Estas são as implementações mais comuns:- E-commerce e varejo: Processe compras online sem formulários de pagamento personalizados.
- Setor de serviços: Cobre taxas de serviços profissionais e consultorias.
- Eventos e entretenimento: Casas de show que vendem ingressos para eventos.
- Organizações sem fins lucrativos e comunidades: Instituições de caridade que recebem doações online.
Processo de integração
Etapa 1: Gerar as chaves do Iframe
Etapa 1: Gerar as chaves do Iframe
O que você fará: Crie chaves de iframe no seu Business Portal da Localpayment para autenticar a sua integração.Importante: Armazene sua chave privada com segurança no seu servidor - nunca a exponha em código do lado do cliente. Sua chave pública pode ser usada com segurança em aplicações de frontend.Recursos: Siga nosso Tutorial de chaves do Iframe para obter instruções passo a passo.
Etapa 2: Criar a sessão de pagamento
Etapa 2: Criar a sessão de pagamento
O que acontece: Gere um token de sessão seguro fazendo uma requisição do lado do servidor ao nosso endpoint da API.Endpoint:
POST https://api.stage.localpayment.com/bff/webcheckout/createsessionParâmetros obrigatórios:bodyMessage- Os dados da sua solicitação de pagamento (mesmo formato da API de Payin)signature- Assinatura RSA da sua mensagem de corpopublicKey- Sua chave pública do iframe
redirectUrl para o seu iframe.Etapa 3: Incorporar o Iframe
Etapa 3: Incorporar o Iframe
O que você fará: Defina a URL de origem do iframe usando o
redirectUrl da resposta da sua sessão.Implementação: Basta atribuir o redirectUrl ao atributo src do seu iframe, e a interface de checkout será carregada dentro da sua página.Resultado: Os usuários podem concluir o pagamento sem sair do seu site.Confirmações por método de pagamento
Entender o que acontece após o envio do pagamento ajuda você a definir as expectativas corretas dos usuários:Confirmação instantânea
Cartões de crédito e débito
- Confirmação imediata do pagamento
- Processamento da transação em tempo real
- Notificação instantânea de sucesso/falha
Instruções de pagamento
Transferência bancária
- Instruções de pagamento detalhadas
- Números de referência fornecidos
- Prazos de pagamento especificados
Implementação de segurança
Geração da assinatura RSA
Todas as requisições devem incluir uma assinatura RSA válida por segurança. Veja como gerar uma:Melhores práticas
- Processamento no servidor: Sempre crie sessões e assinaturas no seu backend.
- Gerenciamento de chaves: Armazene as chaves privadas com segurança e faça a rotação delas regularmente.
- Somente HTTPS: Garanta que toda a comunicação ocorra por conexões seguras.
- Validação de entrada: Valide todos os dados de pagamento antes de enviá-los à nossa API.
Exemplo de implementação
Baixe nosso exemplo completo de integração para ver como todas as peças funcionam em conjunto:Exemplo completo de integração do Iframe
Precisa de ajuda?Entre em contato com nossa equipe de suporte caso encontre algum problema ou precise de ajuda com a integração.

