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

# Chaves de API de Campos Inteligentes

Guia passo a passo para gerar e gerenciar sua chave de API do Smart Fields no Business Portal da Localpayment.

O Smart Fields oferece uma forma segura de coletar informações sensíveis de pagamento diretamente no seu site. Para [integrá-lo](https://docs.localpayment.com/pt-br/docs/smart-fields-overview.md) , primeiro você precisa gerar uma chave de API exclusiva. Essa chave autentica suas requisições e vincula os dados de pagamento tokenizados à sua conta.

## Pré-requisitos

Antes de começar, certifique-se de ter:

**Requisitos de acesso**

* Credenciais válidas para o [Business Portal Localpayment](https://ui.v3.localpayment.com/login)
* Conta de usuário com [permissões de configurações de segurança](https://docs.localpayment.com/pt-br/docs/user-roles-and-permissions.md)

***

## Caminho de navegação

```
Side Menu → PayIn → Checkout → Smart Fields Api Keys
```

***

## Guia passo a passo

1. Acesse o módulo **PayIn** no menu lateral.
2. Selecione a seção **Finalizar Compra**.
3. Em seguida, selecione a seção **Chaves de API de Campos Inteligentes**.
4. Clique no botão **Adicionar chave de API**.
5. Preencha os detalhes conforme necessário:
   * **Título**: Insira um nome descritivo para esta chave (por exemplo, "Site de Produção", "Loja de Teste do João"). Isso ajuda a identificá-la mais tarde.
   * **Domínio**: Insira o nome do domínio a partir do qual esta chave de API será utilizada (por exemplo, myshop.com). Por segurança, a chave funcionará apenas no domínio especificado.
6. Clique no botão "Aceitar" para gerar a chave de API.
7. Sua nova chave de API agora ficará visível na lista **Chaves de API de Campos Inteligentes**. Ela será uma longa sequência de caracteres aleatórios. Copie essa chave e armazene-a com segurança nas variáveis de ambiente ou nos arquivos de configuração da sua aplicação.

> [!NOTE]
>
> Agora que você tem suas chaves, pode começar a desenvolver com o SmartFields. Para detalhes de implementação, consulte [Iframe incorporado](https://docs.localpayment.com/pt-br/docs/smart-fields-overview.md)

Acesse o módulo **PayIn** no menu lateral do portal da empresa.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/00afb1a4fbd538c77f4b363db438059b7dd1702b75a7e58cb97bf8131c841f05-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=0847efb5a1e70a0c23cf740e8136ef53)

Selecione a seção **Finalizar Compra**.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/a832f4ccd3d8b7f7cf939ca3d20130214bf175740377c630acf2077294aa6259-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=60e54c501b2ff5428350990f49f0b8d7)

Em seguida, selecione a seção **Chaves de API de Campos Inteligentes**.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/36a0e229de597e3223ea3388d54266901e85cb7e23e47fed440150ae805760e8-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=9382760cc80a69378cf5e1e57dfbf49f)

Clique no botão **Adicionar chave de API**.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/a4f33d8e3bb6a072cda9387043a74208961210c3781bff3dc51a2b41a5524bd4-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=00ab8eb87e7bd54cc0748598f686172f)

Preencha os detalhes conforme necessário.

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/532aa0a8f8c408a49013e947535c0b8610e60ffd6b1e0923e1b499e33b827451-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=f0c1160222d01793e51a9666cb332c69)

Clique no botão **Aceitar** para gerar a chave de API.

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/2f8ea403b5c222d949a3732372ecd9f1c6a2ac382d8043318ee7deaace9495af-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=b90c7fe513f43b6e26b566dd5373bba3)

Sua nova chave de API agora ficará visível na lista **Chaves de API de Campos Inteligentes**. Ela será uma longa sequência de caracteres aleatórios.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/b97f37539ec67974923e28616447964ac94335d2fbc2337a89d7f10d6e17ad5a-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=1cacf0fc44942f76cab1ae84b773ae31)

***

## Gerenciando suas chaves de iframe

### Visualizando as chaves existentes

Acesse a seção Chaves do Iframe para ver uma lista completa de todas as chaves criadas, incluindo:

* Título da chave e data de criação
* Domínio associado
* Status (Ativo/Inativo)
* Chave pública

### Removendo a chave do iframe

1. Localize a chave que deseja remover na sua lista de chaves.
2. Clique no ícone **Excluir** ao lado da chave.
3. Analise atentamente a mensagem de confirmação; esta ação não pode ser desfeita.
4. Clique em **OK** para remover a chave permanentemente.

> [!WARNING]
>
> **Aviso**
>
> Excluir uma chave desativará imediatamente quaisquer integrações que a utilizem. Certifique-se de ter atualizado suas implementações antes da exclusão.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/fb08e020da5d8ad4f8b4ebe4f76bc29a80d78078eb94a1ac5d79cc37d65ad7fe-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=101896150c331f99d388a47f247e045a)

### Desativar/Ativar a chave do iframe

1. Encontre na sua lista de chaves a chave que deseja desativar ou ativar.
2. Clique no ícone de alternância **Desativar/Ativar** ao lado da chave.
3. Analise atentamente a mensagem de confirmação.
4. Clique em **OK** para alterar o status da chave.

> [!NOTE]
>
> **Dica**
>
> Desativar uma chave a desabilita temporariamente sem excluí-la, o que é útil para manutenção ou solução de problemas.

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dd62748a02547be548eb3e6ed3a3ffa67cf92ab2a7c5f35bcddd64db31dc592c-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=1375fb60c8209082012ed38bdabb2d5d)

***

> **Precisa de ajuda?** Se tiver dúvidas sobre este processo ou qualquer outra funcionalidade, nossa [equipe de suporte](mailto:support@localpayment.com) está à sua disposição. Podemos ajudar com a resolução de problemas, planejamento de integração e otimização.


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