Pular para o conteúdo principal
Diretrizes de segurança para desenvolvedores que usam ferramentas de IA para criar integrações com o Localpayment. Proteja suas credenciais, gerencie os dados de pagamento com responsabilidade e revise o código gerado por IA antes de implantá-lo em produção. As ferramentas de IA aceleram significativamente o desenvolvimento, mas, no contexto de pagamentos, avançar rapidamente sem medidas de segurança acarreta riscos reais. As diretrizes desta página ajudam você a obter os benefícios do desenvolvimento assistido por IA sem expor suas credenciais, os dados de seus clientes ou seu ambiente de produção a riscos desnecessários.

Segurança de credenciais

Nunca cole chaves de API, tokens de acesso ou credenciais secretas em uma interface de bate-papo com IA. A maioria dos provedores de IA registra as conversas, e as credenciais compartilhadas em um bate-papo podem ser armazenadas, indexadas ou expostas.
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.com para Produção ou https://ui.stage.localpayment.com para 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.
Padrão de credenciais seguras em código gerado por IA:

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
O que é seguro:
  • Cargas úteis de webhook sanitizadas ou fictícias (substitua os valores reais por marcadores como XXXX ou 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
Exemplo: forma segura de solicitar ajuda para depurar webhooks:

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.
Observe que alguns recursos estão disponíveis apenas em Produção (por exemplo, a criação de aliases CVU na Argentina). A documentação de cada recurso indica explicitamente quando isso se aplica.

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 internalId já 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.
Antes de utilizar qualquer ferramenta de IA para processar dados de clientes ou transações, você deve avaliar suas obrigações de acordo com as regulamentações de proteção de dados e financeiras aplicáveis em cada país onde opera. O uso de ferramentas de IA para processar dados pessoais, informações financeiras ou dados de transações de pagamento pode exigir bases legais específicas, contratos de processamento de dados (DPA) com o fornecedor de IA e salvaguardas técnicas, dependendo da sua jurisdição.As regulamentações aplicáveis por país de operação incluem, entre outras:
  • Argentina: Ley 25.326 de Protección de Datos Personales (LPDP) e regulamentos aplicáveis do BCRA
  • Brasil: Lei Geral de Proteção de Dados (LGPD, Lei 13.709/2018)
  • Colômbia: Ley 1581 de 2012 (Habeas Data) e Decreto 1074 de 2015
  • México: Ley Federal de Protección de Datos Personales en Posesión de los Particulares (LFPDPPP) e seu Reglamento
  • Peru: Ley 29733 de Protección de Datos Personales e seu Regulamento (D.S. 003-2013-JUS)
  • Chile: Ley 19.628 sobre Protección de la Vida Privada (e alterações em vigor)
  • Equador: Ley Orgánica de Protección de Datos Personales (LOPDP)
  • Todos os mercados: PCI DSS v4.0 para qualquer processamento que envolva dados de cartão de pagamento.
Em todos os casos: (1) verifique se o seu fornecedor de IA assinou um Acordo de Processamento de Dados (DPA) que abrange os tipos de dados específicos que pretende compartilhar; (2) aplique a minimização de dados: compartilhe apenas o que é estritamente necessário; (3) nunca compartilhe dados de titulares de cartões, documentos de identificação nacionais ou números de contas financeiras com qualquer ferramenta de IA sem autorização legal explícita e controles técnicos adequados.

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.
Última modificação em 10 de novembro de 2026