Pular para o conteúdo principal
Integre perfeitamente um checkout white-label ao seu site. O iFrame incorporado oferece o processamento de pagamentos seguro da Localpayment, preservando a identidade da sua marca. A opção de Iframe incorporado permite integrar perfeitamente a experiência de checkout segura da Localpayment diretamente ao seu site ou aplicativo. Essa solução oferece uma interface completa de processamento de pagamentos, mantendo a aparência da sua marca.

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

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.
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 corpo
  • publicKey - Sua chave pública do iframe
Resposta: Você receberá um token de sessão contendo o redirectUrl para o seu 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.

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