Pular para o conteúdo principal
Encontre respostas para as suas perguntas mais frequentes sobre pagamentos, integração de API e serviços da Localpayment, ajudando você a solucionar problemas mais rapidamente e a se manter informado. Obtenha respostas imediatas para as perguntas mais frequentes sobre o Localpayment. Este recurso abrange integração, processamento de pagamentos, gerenciamento de contas e solução de problemas.

Integração

A maioria dos comerciantes consegue concluir a integração em 1 a 2 semanas, dependendo de seus recursos técnicos e da complexidade da implementação. Nossas APIs bem documentadas ajudam a acelerar o processo.
A Localpayment oferece diversas opções de integração:
  • Integração via API: Controle total sobre os fluxos de pagamento com nossa API REST
  • Web Checkout: Redirecione os clientes para nossa página de pagamento hospedada
  • Smart Fields: Incorpore campos de pagamento seguros ao seu checkout
Escolha de acordo com sua experiência técnica, seus requisitos de conformidade com o PCI DSS e a experiência de usuário desejada.
Atualmente, oferecemos APIs REST abrangentes com documentação detalhada e exemplos. Embora não ofereçamos SDKs oficiais no momento, nossas APIs bem estruturadas são projetadas para fácil integração com qualquer linguagem de programação.
Use nosso ambiente Stage com credenciais de teste, que fornece números de cartão de teste, contas bancárias, webhooks simulados e documentação completa para testes. Recomendamos testar minuciosamente todos os métodos de pagamento e cenários de erro antes da implantação em produção para garantir que sua integração lide corretamente com todos os casos possíveis.
Ambiente Stage:
  • Apenas para testes e desenvolvimento
  • Nenhuma transação envolvendo dinheiro real é realizada.
  • Funcionalidade completa da API
  • Dados de teste e respostas simuladas
Ambiente de produção:
  • Processamento de pagamentos em tempo real
  • Transações financeiras reais
  • Requisitos de segurança mais elevados
  • desempenho garantido por SLA

Pagamentos

Oferecemos suporte a uma ampla gama de métodos de pagamento em toda a América Latina:Cartões: Visa, Mastercard, American Express e bandeiras locais de cartão Banco
Transferências: Debin (Argentina), Pix (Brasil) e mais
Carteiras digitais: Wallet Fri e mais
Virtual Accounts: Números de conta dedicados para transferências bancárias
Os métodos disponíveis variam conforme o país. Consulte nossa documentação sobre a cobertura de cada país para obter informações específicas.
O Localpayment realiza a conversão de moeda automaticamente:
  • Aceitar pagamentos em moedas locais
  • Receba a liquidação na moeda de sua preferência (USD, EUR, etc.)
  • Taxas de câmbio competitivas com preços transparentes.
  • Taxas de câmbio em tempo real disponíveis via API.
Atualmente, damos suporte a operações em:
  • Argentina
  • Bolívia
  • Brasil
  • Chile
  • Colômbia
  • Costa Rica
  • Guatemala
  • Honduras
  • México
  • Panamá
  • Paraguai
  • Peru
  • República Dominicana
Estamos em constante expansão para novos mercados. Entre em contato com nossa equipe de vendas para saber mais sobre os próximos lançamentos em outros países.
A velocidade de processamento varia dependendo do método de pagamento utilizado. Pagamentos com cartão geralmente são autorizados imediatamente, enquanto transferências bancárias podem demorar mais, dependendo da rede bancária, e carteiras digitais costumam ser processadas rapidamente. O crédito em sua conta bancária segue os prazos padrão estabelecidos para cada método de pagamento.
Os limites de transação variam de acordo com seu nível de verificação, o método de pagamento utilizado, as regulamentações locais e as avaliações de risco contínuas. Você receberá limites padrão durante o processo de integração e poderá solicitar limites maiores à medida que seu negócio crescer. Para visualizar seus limites atuais, consulte o portal da sua empresa ou entre em contato com nossa equipe de suporte.

Conta e Faturamento

Para criar uma conta Localpayment, primeiro você precisa entrar em contato com nossa equipe para que possamos avaliar sua empresa e iniciar o processo de integração. Orientaremos você em cada etapa necessária, incluindo verificação da empresa, envio de documentos e análise de conformidade. Assim que sua integração for aprovada, ativaremos sua conta e forneceremos suas credenciais de API para que você possa começar a integrar.
Nossos preços são transparentes e competitivos: - Taxa percentual: Com base no volume de transações e no método de pagamento - Taxa fixa: Cobrança por transação
  • Margem de FX: Para conversão de moeda (se aplicável) - Sem mensalidades para contas padrão Os preços específicos são informados durante o processo de integração, com base no seu modelo de negócio, volume e países. Entre em contato com o time de vendas para preços personalizados para grandes empresas.
Opções de acesso aos fundos: - Liquidações automáticas: Diárias, semanais ou mensais para sua conta bancária - Saques manuais: Inicie payouts sob demanda - Contas em moeda local: Mantenha fundos em moedas locais - Liquidações multimoeda: Receba fundos em USD, EUR ou outras moedas principais Configure suas preferências de liquidação no portal da empresa, em “Configurações da conta”.
A documentação necessária para o cadastro varia dependendo do tipo de negócio, dos métodos de pagamento que você pretende usar, do país em que opera e de quaisquer obrigações regulatórias aplicáveis. Nossa equipe de conformidade analisará suas informações e fornecerá um checklist personalizado durante o processo de cadastro para garantir que você atenda a todos os requisitos necessários.

Técnico

Os webhooks fornecem notificações em tempo real sobre eventos de transação: Configure a URL do seu webhook no portal da empresa Selecione quais eventos receber (payins, payouts, etc.) Implemente a verificação de assinatura usando o segredo do seu webhook Trate as requisições POST recebidas com payloads JSON Todos os webhooks são enviados por HTTPS e incluem assinaturas de verificação para segurança. Consulte nossa documentação de webhooks para obter todos os detalhes de implementação.
Nossa API retorna respostas de erro padronizadas: - Códigos de status HTTP (4xx para erros do cliente, 5xx para erros do servidor) - Códigos e mensagens de erro detalhados - Erros de validação específicos de campo, quando aplicável Implemente um tratamento de erros adequado para exibir mensagens amigáveis ao usuário e registrar os erros para depuração. Consulte nosso guia de tratamento de erros para conhecer as melhores práticas.
Sim! Fornecemos coleções do Postman abrangentes que incluem: - Ambientes pré-configurados para Stage e Produção - Exemplos de requisições para todos os endpoints da API - Dados de teste para diversos cenários - Auxiliares de autenticação Baixe nossa coleção do Postman no site de documentação.
Há várias formas de verificar o status da transação: API: Use o endpoint de status da transação com seu ID externo Business Portal: Visualize relatórios de transações em tempo real Webhooks: Receba atualizações automáticas de status Relatórios: Baixe os relatórios diários de liquidação Recomendamos usar webhooks para o acompanhamento de status em tempo real em sua aplicação.

Segurança e Conformidade

Sim, a Localpayment está em conformidade com o PCI DSS Nível 1, o mais alto nível de certificação do setor de pagamentos. Isso significa que mantemos os padrões de segurança mais rigorosos no tratamento de dados de pagamento. Ao usar nossas APIs ou o Web Checkout, você reduz significativamente o escopo de conformidade com o PCI DSS. Entre em contato conosco para obter um guia de conformidade específico para o seu método de integração.
Empregamos diversas medidas de segurança: - Criptografia de dados em trânsito (TLS 1.2+) e em repouso - Tokenização para substituir dados sensíveis - Auditorias de segurança e testes de penetração regulares - Conformidade com SOC 2 Tipo II - Sistemas de detecção e prevenção de fraudes A segurança é fundamental para nossa plataforma, e investimos continuamente na proteção dos seus dados.
Nossa prevenção abrangente de fraudes inclui: - 3D Secure: Autenticação adicional para pagamentos com cartão - Pontuação de risco: Detecção de fraudes baseada em aprendizado de máquina - Verificações de velocidade: Monitoramento de padrões de transação - Geolocalização de IP: Detecção de padrões de localização suspeitos.

Suporte

Suporte técnico: support@localpayment.com
Sim! Oferecemos suporte abrangente à integração: - Gerente técnico de conta dedicado para os clientes - Revisões de integração e orientação sobre melhores práticas - Auxílio na revisão de código - Suporte a testes e validação Entre em contato com nossa equipe de integração para agendar uma reunião de kickoff e obter suporte dedicado durante a sua implementação.
Documentação completa disponível em: - Referência da API: docs.localpayment.com/reference - Guias de integração: docs.localpayment.com/docs - Coleção do Postman: Baixe na documentação.

Virtual Accounts

O titular legal da conta (o nome registrado no sistema bancário) varia de acordo com o país. A tabela a seguir detalha as especificidades:
PaísMoradores locaisResidentes estrangeirosProprietário da contaAliasNome de exibição da transferência bancária
Argentina✅✅
  • FBO = Residentes estrangeiros
  • DDA = Residentes Locais
Criação de até 1 pseudônimo
  • Nome do beneficiário (fornecido durante a criação da Virtual Account, se argentino)
  • Nome legal da entidade Localpayment (em todos os outros casos)
Brasil✅✅
  • FBO = Residentes estrangeiros
  • DDA = Residentes Locais
N / DNome da entidade legal da Localpayment
Chile✅✅FBON / DNome da entidade legal da Localpayment
Colômbia✅✅FBOChave padrãoNome da entidade legal da Localpayment
México✅✅DDA = Residentes LocaisN / DNome da entidade legal da Localpayment
Peru✅✅FBON / DNome da entidade legal da Localpayment
Costa Rica✅✅FBON / DNome da entidade legal da Localpayment

Não. A possibilidade de criar Virtual Accounts para residentes locais e estrangeiros é a mesma em toda a Argentina, Brasil, Chile, Colômbia, México e Peru.Distinção importante para a Argentina: O proprietário legal (titular) da Virtual Account varia de acordo com a residência do beneficiário:
  • Para um beneficiário argentino: A conta é de propriedade legal do beneficiário designado.
  • Para um beneficiário estrangeiro: A conta pertence legalmente à entidade local da Localpayment.
As taxas do serviço de Virtual Account podem variar de acordo com o seu contrato comercial, volume e país. Para obter informações detalhadas e atualizadas sobre preços, entre em contato com nossa equipe de vendas.
Esses são dois tipos distintos de conta que servem a propósitos diferentes no seu fluxo de pagamentos:
  • Suas contas internas do Localpayment: Esta é a sua conta principal administrativa e de tesouraria. Você pode ter várias contas principais para diferentes unidades de negócios ou regiões. Criada durante o processo de integração, ela é usada para gerenciar todas as suas finanças, configurações, relatórios, definições e operações de pagamento por meio do Business Portal. Todos os fundos arrecadados por meio de Contas Virtuais e outros métodos são finalmente liquidados aqui para fins de gestão de tesouraria.
  • Uma Virtual Account: este é um produto Payin. Trata-se de uma conta de recebimento de pagamentos sob demanda que funciona como uma conta bancária dedicada para receber fundos via transferências eletrônicas. Seu único propósito é encaminhar pagamentos de clientes.
Não, isso não é possível. As Virtual Accounts são projetadas exclusivamente para receber fundos (payins). Você não pode iniciar transferências ou enviar fundos de uma Virtual Account para outra.Assim que os fundos forem recebidos em uma Virtual Account, eles serão transferidos para sua Conta Localpayment interna vinculada. Você poderá então distribuir esses fundos (mesmo entre diferentes países) usando os serviços de payout ou transferência apropriados da sua conta principal.

Solução rápida de problemas

  • Problemas de autenticação: verifique suas credenciais de API, a validade do token e a lista de permissões de IP.
  • Recusas de pagamento: verifique os cartões de teste no ambiente de sandbox e revise o status e os limites da sua conta.
  • Problemas com webhooks: Certifique-se de que seu endpoint utilize HTTPS, valide as assinaturas e retorne respostas 200 OK.
  • Erros de integração: revise os registros da sua API, teste no ambiente de sandbox e consulte a documentação.
Última modificação em 10 de novembro de 2026