> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Iframe incorporado

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

> [card] 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

> [card] 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.

> [card] 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.

> [card] 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

> [accordion] 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](https://docs.localpayment.com/pt-br/docs/dashboard-iframe-keys.md) para obter instruções passo a passo.

> [accordion] 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/createsession`
>
> **Parâ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.

> [accordion] 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:

> [card] 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

> [card] 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:

```csharp theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
public static string Sign(string content, string privateKey)
{
    var contentData = Encoding.ASCII.GetBytes(content);
    var privateKeyData = Convert.FromBase64String(privateKey);

    using var rsa = new RSACryptoServiceProvider();
    using var sha1 = SHA1.Create();

    rsa.ImportRSAPrivateKey(privateKeyData, out _);
    return Convert.ToBase64String(rsa.SignData(contentData, sha1));
}
```

### 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:

> [card] [Exemplo completo de integração do Iframe](https://cdn.localpayment.com/public_docs/Iframe%20Example.txt)

***

> [!NOTE]
>
> **Precisa de ajuda?**
>
> Entre em contato com nossa [equipe de suporte](mailto:support@localpayment.com) caso encontre algum problema ou precise de ajuda com a integração.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.