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

# Perguntas frequentes

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

> [accordion] Quanto tempo leva para integrar com o Localpayment?
>
> 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.

> [accordion] Quais são as diferentes opções de integração disponíveis?
>
> 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.

> [accordion] Vocês fornecem SDKs ou bibliotecas de cliente?
>
> 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.

> [accordion] Como faço para testar minha integração antes de publicá-la?
>
> 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.

> [accordion] Qual é a diferença entre os ambientes Stage e de Produção?
>
> **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

> [accordion] Quais métodos de pagamento o Localpayment aceita?
>
> 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.

> [accordion] Como funcionam as conversões de moeda?
>
> 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.

> [accordion] Quais países vocês atendem?
>
> 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.

> [accordion] Quanto tempo demora o processamento dos pagamentos?
>
> 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.

> [accordion] Quais são os limites de transação?
>
> 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

> [accordion] Como faço para criar uma conta Localpayment?
>
> 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.

> [accordion] Quais são as taxas que vocês cobram?
>
> 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.

> [accordion] Como posso acessar meus fundos?
>
> 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".

> [accordion] Quais documentos são necessários para a verificação 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

> [accordion] Como funcionam os webhooks e como posso configurá-los?
>
> 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.

> [accordion] Como lidar com erros e recusas?
>
> 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.

> [accordion] Vocês fornecem coleções do Postman para testes?
>
> 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.

> [accordion] Como faço para verificar o status da transaçã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

> [accordion] A Localpayment está em conformidade com o PCI DSS?
>
> 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.

> [accordion] Como você protege os dados dos clientes?
>
> 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.

> [accordion] Que ferramentas de prevenção de fraudes vocês oferecem?
>
> 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

> [accordion] Como faço para entrar em contato com o suporte?
>
> Suporte técnico:
> [support@localpayment.com](mailto:support@localpayment.com)

> [accordion] Vocês oferecem suporte técnico durante a integração?
>
> 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.

> [accordion] Onde posso encontrar a documentação da API?
>
> 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

> [accordion] Em nome de quem são criadas as 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:
>
> <table>
>   <thead>
>     <tr>
>       <th>
>         País
>       </th>
>
>       <th>
>         Moradores locais
>       </th>
>
>       <th>
>         Residentes estrangeiros
>       </th>
>
>       <th>
>         Proprietário da conta
>       </th>
>
>       <th>
>         Alias
>       </th>
>
>       <th>
>         Nome de exibição da transferência bancária
>       </th>
>     </tr>
>   </thead>
>
>   <tbody>
>     <tr>
>       <td>
>         Argentina
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         * **FBO** = Residentes estrangeiros
>         * **DDA** = Residentes Locais
>       </td>
>
>       <td>
>         Criação de até 1 pseudônimo
>       </td>
>
>       <td>
>         * **Nome do beneficiário** (fornecido durante a criação da Virtual Account, se argentino)
>         * **Nome legal da entidade Localpayment** (em todos os outros casos)
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Brasil
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         * **FBO** = Residentes estrangeiros
>         * **DDA** = Residentes Locais
>       </td>
>
>       <td>
>         N / D
>       </td>
>
>       <td>
>         **Nome da entidade legal da Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Chile
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         N / D
>       </td>
>
>       <td>
>         **Nome da entidade legal da Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Colômbia
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         Chave padrão
>       </td>
>
>       <td>
>         **Nome da entidade legal da Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         México
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **DDA** = Residentes Locais
>       </td>
>
>       <td>
>         N / D
>       </td>
>
>       <td>
>         **Nome da entidade legal da Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Peru
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         N / D
>       </td>
>
>       <td>
>         **Nome da entidade legal da Localpayment**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         Costa Rica
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         N / D
>       </td>
>
>       <td>
>         **Nome da entidade legal da Localpayment**
>       </td>
>     </tr>
>   </tbody>
> </table>

> [accordion] As regras para Virtual Accounts são diferentes para empresas locais?
>
> 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.

> [accordion] Qual o custo do serviço de Virtual Account?
>
> 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](mailto:sales@localpayment.com).

> [accordion] Qual a diferença entre uma Virtual Account e a minha conta Localpayment?
>
> 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.

> [accordion] Posso transferir fundos diretamente de uma Virtual Account para outra em países diferentes?
>
> 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.


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