Segurança de credenciais
Regras a seguir:- Use variáveis de ambiente para todas as credenciais no código gerado por IA. Se a IA produzir uma chave fixa em um exemplo, substitua-a imediatamente.
- Use credenciais do ambiente de teste ao trabalhar com IA durante o desenvolvimento e os testes. As chaves de API do ambiente de teste são de baixo risco: elas não podem movimentar dinheiro real.
- Se você compartilhar acidentalmente uma chave de API de Produção em uma sessão de bate-papo, faça a rotação dela imediatamente no Business Portal do Localpayment (
https://ui.v3.localpayment.compara Produção ouhttps://ui.stage.localpayment.compara Stage) e audite seu histórico recente de transações. - Não compartilhe segredos de webhook, tokens JWT ou qualquer material de autenticação em prompts, mesmo que de forma “sanitizada” e aparentemente óbvia.
Dados do cliente e de pagamento
Não compartilhe dados reais de pagamento com ferramentas de IA, a menos que tenha verificado se os termos de processamento de dados do provedor são compatíveis com suas obrigações de conformidade. O que evitar colar em chats de IA:- Dados reais do titular do cartão (números do cartão, CVVs, datas de validade)
- Informações pessoais reais de clientes (números de identificação nacional, nomes completos combinados com dados de documentos)
- Cargas úteis reais de webhook contendo valores de transações e números de contas reais provenientes de produção
- Números de conta (CVU, CLABE, CCI) associados a clientes reais
- Cargas úteis de webhook sanitizadas ou fictícias (substitua os valores reais por marcadores como
XXXXou por valores de exemplo) - Códigos de erro e códigos de status sem o contexto da transação
- Estruturas de requisição de API com valores de exemplo da documentação
Stage antes de Produção
Desenvolva e teste sempre a sua integração assistida por IA no ambiente de teste (Stage) antes de implantá-la em Produção.O servidor Localpayment MCP expõe a documentação e a especificação da API, mas não executa solicitações. Todas as chamadas de API reais ocorrem no seu próprio código, usando suas credenciais. O risco do ambiente depende inteiramente das credenciais e da URL base que você usa na sua integração.
Analisando o código gerado por IA
O código gerado por IA deve sempre ser revisado antes de ser integrado ou implantado. Em uma integração de pagamentos, erros podem ter consequências financeiras. Lista de verificação para revisão do código de integração do Localpayment gerado por IA:- Sem credenciais fixas no código: todas as chaves de API usam variáveis de ambiente
- URL base correta: URL de Stage para desenvolvimento, URL de Produção para implantação
- O externalId é único: o código gera IDs únicos por transação (por exemplo, UUID). externalIds duplicados causarão o erro
500. - Idempotência do webhook: o manipulador de webhook verifica se o
internalIdjá foi processado antes de agir - Resposta HTTP 200: o manipulador de webhook sempre retorna 200 OK após o processamento, mesmo para eventos que ele ignora
- Somente HTTPS: todas as chamadas de API usam HTTPS, nunca HTTP
- Tratamento de erros: os códigos de status de rejeição (5xx, 8xx, 9xx) são capturados e tratados, e não ignorados silenciosamente
- Dados sensíveis não registrados em log: chaves de API, dados de cartão e informações pessoais de clientes não são gravados nos logs
Que dados o Localpayment pode visualizar?
Ao utilizar qualquer ferramenta de IA da Localpayment (servidor MCP, prompts do sistema do agente ou esta documentação), é importante compreender exatamente o que a Localpayment pode e não pode acessar:
O servidor Localpayment MCP é um servidor de documentação pública, somente leitura. Ele não tem acesso à sua conta de comerciante na Localpayment, às suas transações nem a quaisquer dados que você tenha armazenado na Localpayment. Ele apenas disponibiliza a mesma documentação disponível publicamente em
https://docs.localpayment.com.
Políticas de dados de ferramentas de IA
Entender como seu provedor de IA lida com os dados que você compartilha faz parte do uso responsável.Referência rápida
Próximos passos
Chaves de API e ambientes
Gerencie suas credenciais de Stage e de Produção e compreenda as diferenças entre os ambientes.
Receba notificações de pagamento
Implemente o tratamento seguro e idempotente de webhooks para eventos de pagamento do Localpayment.

