Central de ajuda
Perguntas frequentes
Respostas diretas sobre cobertura, onboarding, pay-ins, payouts, câmbio, a API, segurança e a conta para PMEs. Não encontrou a sua pergunta? O suporte ao cliente atende 24/7.
- 127 respostas
- 14 temas
- Suporte ao cliente 24/7
Sobre nós
Sobre a Localpayment
O que a Localpayment faz?
A Localpayment é infraestrutura de pagamentos para a América Latina. Com uma única API e o Business Portal, empresas recebem com meios locais (pay-ins), enviam payouts, emitem contas virtuais e convertem moeda em toda a região.
Qual é a relação da Localpayment com o Aleph Group?
A Localpayment faz parte do Aleph Group, que combina pagamentos e mídia digital para plataformas e marcas que entram em mercados emergentes. Números como mais de 26.000 anunciantes, mais de 55 plataformas e mais de 130 mercados se referem ao Aleph Group como um todo, não à Localpayment isoladamente.
A Localpayment é uma orquestradora de pagamentos?
As duas coisas. Orquestramos pagamentos com uma única API, e fazemos isso sobre uma presença licenciada, registrada ou supervisionada em 18 países e trilhos locais em 14, em vez de apenas rotear para outros provedores.
Quem usa a Localpayment?
Empresas que recebem ou pagam pessoas na América Latina: e-commerce e marketplaces, bens digitais e games, fintechs e carteiras, empresas de remessas, SaaS, viagens, mobilidade, folha de pagamento e plataformas de publicidade. As páginas de soluções mostram os fluxos típicos de cada uma.
Quais produtos a Localpayment oferece?
Recebimentos com meios de pagamento locais e cartões, contas virtuais, pagamentos recorrentes, checkout hospedado, payouts, pagamento de contas, câmbio e tesouraria, uma conta de tesouraria global, trilhos de stablecoins, roteamento inteligente, e relatórios e conciliação, tudo com uma única API e o Business Portal.
A Localpayment é um banco?
Não. A Localpayment é um provedor de pagamentos. Em cada país temos a licença, o registro ou a supervisão que a regulação local exige para pagamentos (instituição de pagamento no Brasil, transmissor de dinheiro no México e assim por diante) e a página de licenças mostra a situação exata nos 18 países.
A Localpayment trabalha com startups ou empresas de baixo volume?
A plataforma enterprise é cotada empresa por empresa, então o volume é apenas uma das variáveis. Pequenas e médias empresas também podem solicitar acesso antecipado à Localpayment para PMEs, uma conta empresarial self-service. Conte seus fluxos e indicamos a melhor opção.
Onboarding
Onboarding e verificação de empresas (KYB)
Como funciona o onboarding?
Começa com uma conversa comercial sobre seus mercados e fluxos. Depois vêm a análise de compliance (diligência, ou diligência reforçada quando necessário), a aprovação de compliance, a assinatura do contrato, a integração técnica e a entrada em produção.
Quando recebemos as credenciais da API?
As credenciais de Stage (ambiente de testes) são entregues no início da parceria, para que sua equipe desenvolva e teste enquanto a análise de compliance avança. As credenciais de produção vêm depois dos testes concluídos no Stage, de uma revisão de segurança e da verificação da empresa (KYB).
Quanto tempo leva para entrar em produção?
Você pode entrar em produção em semanas. O prazo exato depende do seu caso de uso, dos mercados com que você começa e de quando a análise de compliance e os testes no Stage são concluídos.
O que a verificação da empresa (KYB) cobre?
O KYB verifica a identidade da sua empresa, a estrutura societária, os diretores e os beneficiários finais. Durante o onboarding, nossa equipe de compliance compartilha a lista exata de documentos para o seu país e setor.
Podemos adicionar países depois?
Sim. Novos mercados usam a mesma API e o mesmo Business Portal. Um novo país ou meio de pagamento pode exigir uma análise de compliance adicional.
O que devemos preparar antes de começar?
Os documentos da sua empresa para a verificação de negócio (KYB), os países e meios de pagamento com os quais quer começar, os endereços IP dos seus servidores para a lista de permitidos e um contato técnico. Nossa equipe confirma a lista exata durante o onboarding.
Quais documentos são exigidos na verificação da empresa?
A lista depende do tipo de empresa, dos países e dos meios de pagamento escolhidos. Normalmente inclui documentos de constituição, o organograma societário, identificação de diretores e beneficiários finais, comprovante de endereço e uma descrição da atividade. Nossa equipe de compliance envia uma lista sob medida.
Ter acesso ao Stage significa que estamos aprovados para operar?
Não. As credenciais de Stage permitem que sua equipe construa e teste desde o primeiro dia, mas o acesso à produção vem depois de concluir os testes no Stage, uma revisão de segurança e a verificação da empresa (KYB).
Nossos desenvolvedores devem começar pelo Stage ou falamos primeiro com vendas?
Os dois, em paralelo. Vendas define países, meios e fluxos enquanto seus desenvolvedores testam no Stage com as credenciais emitidas no início da parceria. Assim, integração e compliance terminam quase ao mesmo tempo.
Podemos começar em um país e expandir depois?
Sim. Muitas empresas entram em produção em um mercado e adicionam os demais depois, com a mesma API. Um novo país ou meio de pagamento pode exigir uma revisão de compliance adicional.
Existem setores restritos ou proibidos?
Sim. Como provedor regulado, mantemos uma lista de atividades restritas na nossa política de PLD, e alguns segmentos exigem diligência reforçada. Conte à equipe de vendas seu modelo de negócio desde o início e confirmamos se e como podemos atendê-lo.
Uma empresa constituída fora da América Latina pode usar a Localpayment?
Sim. Muitos dos nossos clientes são constituídos nos Estados Unidos, na Europa ou na Ásia e recebem e pagam na América Latina por meio das nossas licenças locais. Requisitos como registro fiscal local variam por país e produto, e nossa equipe os confirma durante o onboarding.
Cobertura
Cobertura e meios de pagamento
Onde a Localpayment opera?
Temos presença licenciada, registrada ou supervisionada em 18 países, com trilhos de pagamento locais em 14. Meios de pagamento, moedas e licenças variam por país; as páginas de cobertura e de licenças detalham cada um.
Quais meios de pagamento meus clientes podem usar?
Depende do país: pagamentos bancários como Pix no Brasil, SPEI no México, Bre-B e PSE na Colômbia e Debin na Argentina; pagamentos com QR na Argentina, na Bolívia, na Guatemala e no Peru; contas virtuais em sete países; e cartões na Argentina, na Colômbia, no México e no Peru. O diretório de meios de pagamento lista cada método por país.
Vocês aceitam cartões no Brasil?
Não. No Brasil, seus clientes pagam com Pix, por QR Code ou Copia e Cola, ou por transferência para uma conta virtual identificada por uma chave Pix. Os cartões estão disponíveis na Argentina, na Colômbia, no México e no Peru.
Quais bandeiras de cartão vocês aceitam?
Visa e Mastercard na Argentina, Colômbia, México e Peru, além de American Express, Diners Club, Naranja e Cabal na Argentina e American Express e Diners Club na Colômbia. 3D Secure, parcelamento e assinaturas estão disponíveis na Colômbia, no México e no Peru.
Preciso de uma integração separada para cada país?
Não. Você integra uma vez e usa a mesma API e o mesmo Business Portal em todos os mercados. Um novo país ou meio de pagamento pode exigir uma análise de compliance adicional.
Como verifico se um país ou meio de pagamento está coberto?
As páginas de cobertura mostram cada país com sua situação de licença, moedas e trilhos, e o diretório de meios de pagamento lista cada meio por país. A disponibilidade em tempo real dos trilhos de cada país é publicada em status.localpayment.com.
Vocês aceitam pagamentos em dinheiro?
Nosso catálogo se concentra em pagamentos bancários, QR, contas virtuais e cartões, os meios que a região mais usa para pagar online hoje. Se o seu caso precisa de uma opção em dinheiro em um país específico, fale com vendas.
Vocês aceitam carteiras digitais?
Para receber, oferecemos métodos QR e de transferência em vez de carteiras: QR interoperável e transferências para CVU na Argentina, Pix no Brasil, QR na Bolívia e no Peru, e QR Fri e Wallet Fri na Guatemala. Para payouts, as carteiras são alcançadas em 9 países (Argentina, Bolívia, Brasil, Chile, Colômbia, Costa Rica, El Salvador, México e Peru): com integração direta na Bolívia, na Costa Rica e no Peru, e por trilhos bancários nos demais.
Vocês oferecem pagamentos em tempo real?
Sim. Pix no Brasil, SPEI no México, Bre-B na Colômbia, transferências COELSA na Argentina, TEF no Chile, CCE no Peru e SINPE Móvil na Costa Rica confirmam em segundos, 24/7, dentro dos limites de cada trilho.
Com que frequência vocês adicionam países e meios?
A cobertura cresce continuamente, mas só publicamos o que está operacional hoje. Se você precisa de um mercado ou meio que não aparece, avise vendas: isso nos ajuda a priorizar e podemos contar o que conseguimos oferecer para o seu caso.
Pay-ins
Receber pagamentos
Como sei que um pagamento foi concluído?
As autorizações de cartão retornam em tempo real. Transferências bancárias, pagamentos com QR e pagamentos em contas virtuais são assíncronos: o status final chega por um webhook assinado com HMAC, e você também pode consultar GET /api/transactions/{externalId}/status.
Posso cobrar meus clientes de forma recorrente?
Sim. Assinaturas e parcelamento com cartão estão disponíveis na Colômbia, no México e no Peru, com retentativas configuráveis.
Devo usar o checkout hospedado ou integrar a API diretamente?
O WebCheckout é o caminho mais rápido: o cliente é redirecionado a uma página hospedada e os dados do cartão nunca passam pelos seus servidores. A API dá controle total da experiência, e o Smart Fields fica no meio, com campos de cartão hospedados dentro do seu próprio checkout. A página de integrações compara esforço e escopo PCI.
Posso enviar links de pagamento?
Sim. Os links de pagamento permitem cobrar sem integração: compartilhe o link por e-mail, chat ou fatura e o cliente paga em uma página hospedada com os meios habilitados para aquele país.
Vocês oferecem parcelamento?
Sim, para cartões de crédito em moeda local na Colômbia, no México e no Peru, junto com 3D Secure e assinaturas. As opções de parcelamento exibidas ao cliente dependem do emissor e do plano que você configurar.
Que taxas de aprovação posso esperar?
Taxas de aprovação acima de 99%. A aprovação depende do meio e do emissor, mas adquirência local, trilhos locais e smart routing evitam as recusas que o processamento internacional de cartões costuma causar.
Existem limites por transação?
Sim. Os limites dependem do meio de pagamento, da regulação local, do seu nível de verificação e da avaliação de risco contínua. Você recebe seus limites iniciais durante o onboarding e pode solicitar alterações depois.
O que acontece se um cliente nunca conclui uma transferência ou um pagamento QR?
A transação fica pendente até expirar. Você nunca recebe fundos sem confirmação, e o status final chega por webhook assinado de qualquer forma, então seu pedido pode ser liberado ou cancelado automaticamente.
Payouts
Enviar payouts
Em quais países há payouts?
Os payouts por transferência bancária usam trilhos locais em 14 países: Argentina, Bolívia, Brasil, Chile, Colômbia, Costa Rica, El Salvador, Guatemala, Honduras, México, Panamá, Paraguai, Peru e República Dominicana.
Em quanto tempo os payouts chegam?
Em trilhos em tempo real como Pix, SPEI, COELSA, TEF, CCE, Bre-B e SINPE Móvil, os payouts são confirmados em segundos, 24/7, dentro dos limites de cada trilho. Trilhos em lote como ACH ou TED creditam no mesmo dia ou no dia útil seguinte, conforme os horários de corte.
Posso pagar em carteiras digitais?
Sim. Os payouts para carteiras chegam a 9 países. Há integração direta com carteiras na Bolívia, na Costa Rica (SINPE Móvil) e no Peru, e os payouts por transferência bancária podem chegar a carteiras na Argentina, na Bolívia, no Brasil, no Chile, na Colômbia, em El Salvador e no México.
Um payout pode exigir uma segunda aprovação?
Sim. Com a dupla assinatura, um usuário cria o payout e outro usuário o autoriza, com requireAuth na API ou com a fila de aprovação do Business Portal.
Como comprovo que um payout foi feito?
O comprovante de cada payout está disponível via API e no Business Portal, e cada mudança de status, de Pending Authorization a Completed, chega por webhook assinado.
Como envio muitos payouts de uma vez?
Pela API, com uma requisição por payout a partir dos seus sistemas, ou subindo um arquivo em lote no Business Portal. Os dois caminhos aceitam aprovação por dupla assinatura e informam o status de cada payout por webhook.
Quais dados do beneficiário preciso para enviar um payout?
Nome, identificação fiscal (CPF ou CNPJ, CUIT, RFC, NIT etc.) e identificador da conta bancária (CBU ou CVU, CLABE, chave Pix, CCI, IBAN ou o equivalente local), além dos campos exigidos pela regulação daquele país. A API valida os formatos antes de enviar o payout.
O que acontece se um payout é rejeitado ou devolvido?
Se a validação ou o banco o rejeitam antes do envio, você recebe o status Rejected com o motivo. Em trilhos em lote, o banco do beneficiário pode devolver um pagamento dias depois; os fundos voltam ao seu saldo e você é avisado por webhook.
Posso recuperar um payout enviado para a conta errada?
Payouts em trilhos em tempo real são definitivos depois de concluídos. Em outros trilhos, a recuperação é um processo manual de melhor esforço conduzido com o suporte e depende do banco recebedor. Validar os dados do beneficiário e usar dupla assinatura é a melhor proteção.
Os payouts exigem abastecimento prévio do saldo?
Sim. Os payouts são debitados do seu saldo na Localpayment, que você abastece com um Wire In em moeda forte ou stablecoins, ou com o que recebeu em pay-ins, conforme seu contrato.
Quem posso pagar com payouts?
Pessoas e empresas: fornecedores, vendedores, criadores, motoristas e entregadores, trabalhadores autônomos, beneficiários de remessas e usuários de carteiras que sacam seu saldo. Os payouts são sempre em moeda local por trilhos locais.
Contas virtuais
Contas virtuais
O que é uma conta virtual?
Um número de conta ou chave local exclusivo (CVU, CLABE, CCI, IBAN, chave Pix ou chave Bre-B) atribuído a um cliente, pedido ou fatura. As transferências recebidas são conciliadas automaticamente e confirmadas por webhook. As contas virtuais estão disponíveis na Argentina, no Brasil, no Chile, na Colômbia, na Costa Rica, no México e no Peru.
Em nome de quem as contas virtuais são criadas?
Varia por país. As contas virtuais podem ser configuradas para empresas locais e estrangeiras na Argentina, no Brasil, no Chile, na Colômbia, na Costa Rica, no México e no Peru, com estruturas de titularidade próprias de cada país. Nossa equipe confirma a configuração de cada mercado durante o onboarding.
Qual é a diferença entre uma conta virtual e minha conta Localpayment?
Sua conta Localpayment é sua conta de tesouraria: saldos, aportes, câmbio e payouts. Uma conta virtual é uma conta de recebimento que você cria sob demanda para receber transferências de clientes. Os fundos recebidos em contas virtuais são liquidados na sua conta Localpayment.
Posso mover fundos de uma conta virtual para outra, ou entre países?
Não. As contas virtuais apenas recebem fundos. O dinheiro é liquidado na sua conta Localpayment e, a partir dela, você paga terceiros com payouts ou saca com um Wire Out.
Qual identificador meus clientes veem?
O local: uma CVU na Argentina, uma chave Pix no Brasil, uma chave Bre-B na Colômbia, um IBAN na Costa Rica, uma CLABE no México e um CCI no Peru. O cliente paga com uma transferência comum pelo app do banco ou da carteira.
Posso criar uma conta virtual por cliente?
Sim. Crie contas sob demanda pela API e atribua uma a cada cliente, pedido ou fatura. As transferências recebidas são conciliadas automaticamente e confirmadas por webhook, então a conciliação não exige trabalho manual.
Posso receber em dólares por uma conta virtual?
Na Costa Rica e no Peru, as contas virtuais podem ser denominadas em USD além da moeda local. Nos demais países elas operam em moeda local, e você pode converter saldos para moeda forte com câmbio.
Câmbio e tesouraria
Moedas, câmbio e tesouraria
Para quais moedas posso converter?
As moedas locais são convertidas em moedas fortes: USD, EUR, GBP, CAD, AUD, NZD e CHF, além das stablecoins USDC e USDT. A conversão vai de moeda local para moeda forte.
Quando as conversões acontecem?
Dentro do horário de cada mercado local, que varia por país, por exemplo, das 10h às 12h30 no Brasil e das 8h às 15h30 no México, no horário local. A conversão não funciona 24 horas; a documentação traz o horário de cada país.
Posso travar uma taxa de câmbio?
Sim. Solicite uma cotação e você recebe um token (exchangeRateToken) com data de expiração. As operações enviadas com esse token antes de expirar usam a taxa travada.
Como abasteço minha conta?
Com um Wire In: uma transferência bancária que você notifica via API ou no Business Portal, ou USDC ou USDT em Ethereum ou Tron, que são detectados e creditados automaticamente, normalmente de 2 a 10 minutos após a confirmação on-chain.
Como faço para sacar recursos?
Com um Wire Out para a sua própria conta bancária externa ou para uma carteira de USDC ou USDT autorizada. Wire Outs nunca vão para terceiros; pagamentos a terceiros são feitos com payouts.
Meus clientes podem pagar ou receber em cripto?
Não. As stablecoins são uma ferramenta de tesouraria: USDC e USDT abastecem sua conta empresarial e podem ser sacados para carteiras autorizadas. Não oferecemos on-ramp nem off-ramp de cripto para consumidores.
Como minha taxa de câmbio é determinada?
Você solicita uma cotação pela API ou pelo Business Portal e recebe a taxa daquele momento, incluindo a margem definida no seu contrato, com um token de cotação que a trava até expirar. A taxa aplicada fica registrada em cada conversão.
Posso manter saldos em várias moedas?
Sim. Sua conta mantém um saldo separado por moeda (as moedas locais onde você recebe, mais as moedas fortes e stablecoins para as quais converte ou com as quais aporta) e o Business Portal mostra a atividade por moeda.
Qual é a diferença entre um Wire In e um pay-in?
Um pay-in é um pagamento do seu cliente. Um Wire In é o seu próprio dinheiro: uma transferência ou um depósito de USDC ou USDT que abastece seu saldo na Localpayment, normalmente antes de enviar payouts.
Quanto tempo leva um Wire Out?
Um Wire Out em moeda fiduciária segue o tempo de processamento do banco recebedor e do trilho usado; saques em stablecoins são confirmados on-chain. Você acompanha cada Wire Out no Business Portal e por webhook.
Posso converter moeda forte em moeda local?
As conversões de câmbio vão de moeda local para moeda forte. Para pagar localmente, você aporta na conta em moeda forte ou stablecoins e os payouts são executados em moeda local a partir do seu saldo, conforme seu contrato.
Liquidação
Liquidação, relatórios e conciliação
Quando os recursos chegam ao meu saldo?
Trilhos em tempo real, como Pix ou SPEI, confirmam os pagamentos em segundos, 24/7. A disponibilização dos recursos no seu saldo segue as condições de liquidação do seu contrato, por isso não prometemos liquidação no mesmo dia. Consulte vendas sobre o calendário dos seus países.
Como concilio os pagamentos?
Envie seu externalId em cada transação, receba um webhook assinado a cada mudança de status e consulte o endpoint de status quando precisar verificar. O Business Portal e a API também entregam seus dados de transações para conciliação.
E se meu servidor perder um webhook?
As entregas sem resposta 200 são reenviadas com backoff exponencial, e você sempre pode consultar GET /api/transactions/{externalId}/status para confirmar o estado atual.
Quais relatórios estão disponíveis?
Relatórios de transações, liquidação e saldos no Business Portal, com filtros e exportações, e os mesmos dados pela API. Cada registro carrega seu externalId para corresponder aos seus próprios sistemas.
Em qual moeda sou liquidado?
Na moeda local que você recebeu ou em moeda forte após a conversão (USD, EUR, GBP, CAD, AUD, NZD, CHF, USDC ou USDT), conforme seu contrato.
O que são horários de corte e por que são importantes?
Trilhos em lote como ACH ou TED e as mesas de câmbio operam em horário comercial. Um payout ou uma conversão solicitados após o corte são processados na próxima janela útil. Trilhos em tempo real confirmam 24/7 e não têm corte.
Quais status uma transação pode ter?
Cada transação passa por status documentados, da criação até um estado final como Completed, Rejected ou Refunded; payouts com dupla assinatura começam em Pending Authorization. Cada mudança é enviada por webhook assinado e a documentação lista os estados por produto.
Disputas
Estornos, chargebacks e disputas
Vocês oferecem reembolsos e gestão de chargebacks?
Sim. Há reembolsos para pagamentos com cartão, contas virtuais e meios de pagamento alternativos. Nos chargebacks de cartão, você pode enviar evidências para cada disputa via API ou no Business Portal.
Quanto tempo um estorno leva para chegar ao cliente?
Depende do meio. Estornos de cartão aparecem na fatura quando o emissor os lança; estornos de transferências, QR e contas virtuais são enviados à conta do pagador pelo trilho local. Cada estorno tem seu próprio status e webhook.
Posso estornar parcialmente?
As regras de estorno dependem do meio de pagamento. A seção de estornos da documentação indica, para cada meio, se estornos parciais são permitidos e em qual prazo.
Como funciona um chargeback?
O titular contesta uma cobrança junto ao emissor, o valor é revertido e você é notificado no Business Portal e por webhook. Você pode enviar evidências pela API ou pelo portal dentro do prazo definido pela bandeira; o emissor decide o resultado.
Uma transferência bancária ou um pagamento Pix pode sofrer chargeback?
Pagamentos bancários não têm o mecanismo de chargeback dos cartões: confirmada a transferência, os fundos são seus. Se precisar devolver o dinheiro, você emite um estorno.
Como reduzo chargebacks e fraude?
Ofereça meios bancários locais, ative o 3D Secure nos cartões, guarde comprovantes de entrega e responda às disputas com evidências no prazo. Nossa plataforma adiciona controles antifraude como verificações de velocidade e score de risco.
Qual é a diferença entre estorno, devolução e chargeback?
Um estorno é uma devolução de fundos iniciada por você. Uma devolução é um payout que o banco do beneficiário retorna, por exemplo porque a conta estava encerrada. Um chargeback é um pagamento com cartão revertido pelo emissor a pedido do titular.
Segurança
Segurança e compliance
A Localpayment é regulada?
Sim. Publicamos nossa licença, registro ou supervisão país a país, por exemplo, Instituição de Pagamento licenciada pelo Banco Central do Brasil (BCB) e Transmissor de Dinheiro registrado na Comissão Nacional Bancária e de Valores (CNBV) no México; a página de licenças mostra a situação exata em cada um dos 18.
Quais certificações a Localpayment tem?
A Localpayment é validada no PCI DSS v4.0.1 e tem um relatório SOC 2 Type II. Também é certificada ISO 27001. Você pode solicitar os relatórios pela Central de confiança.
Como os dados são protegidos?
Os dados são criptografados em trânsito com TLS 1.2 ou superior e em repouso com AES-256, com rotação de chaves pelo AWS KMS. O acesso é protegido com autenticação multifator e controle de acesso baseado em perfis.
Quais controles de segurança minha equipe pode configurar?
Lista de IPs autorizados para as chamadas à API, webhooks assinados com HMAC, perfis e permissões personalizados no Business Portal e aprovação por dupla assinatura para payouts.
Como relato uma vulnerabilidade?
Envie um e-mail para cybersecurity@localpayment.com com a descrição do problema e os passos para reproduzi-lo. O mesmo endereço chega à nossa equipe de proteção de dados.
Onde encontro a documentação de segurança?
A Central de confiança (trust.localpayment.com) reúne a documentação de segurança e os recursos de compliance, e a página de segurança deste site resume nossos controles.
A Localpayment aplica controles de PLD e de sanções?
Sim. Como provedor de pagamentos regulado, aplicamos controles de prevenção à lavagem de dinheiro e de compliance conforme nossas licenças, incluindo diligência no cadastro e monitoramento contínuo. Nossa política de AML está publicada na seção jurídica deste site.
Quem verifica meus clientes finais (KYC)?
Depende do produto, do país e da regulação local. Em alguns fluxos você coleta os dados que nossos trilhos exigem; em outros, a verificação faz parte do serviço. Seu contato de compliance confirma o que se aplica ao seu caso durante o onboarding.
Qual é o meu escopo PCI DSS?
Com WebCheckout, links de pagamento ou Smart Fields, os dados do cartão são capturados na nossa infraestrutura PCI DSS v4.0.1 e seu escopo permanece mínimo. Se você enviar dados de cartão em texto puro para a API, seus sistemas precisam ter a própria validação PCI DSS.
Onde os dados ficam hospedados?
Em infraestrutura da AWS, criptografados em trânsito com TLS 1.2 ou superior e em repouso com AES-256, com chaves gerenciadas e rotacionadas pelo AWS KMS.
Vocês realizam auditorias independentes e testes de intrusão?
Sim. Nossa validação PCI DSS v4.0.1, o relatório SOC 2 Type II e a certificação ISO 27001 são emitidos por avaliadores independentes, e realizamos testes de intrusão e revisões de segurança periódicas.
Como vocês tratam dados pessoais?
De acordo com nossa política de privacidade e as leis de proteção de dados de cada país em que operamos. Coletamos apenas os dados necessários para processar pagamentos e cumprir a regulação. Dúvidas chegam à nossa equipe de proteção de dados em cybersecurity@localpayment.com.
Como obtenho o relatório SOC 2 ou outros documentos de segurança?
Pela Central de confiança em trust.localpayment.com, onde você pode solicitar relatórios e certificados. Nossa equipe cuida da solicitação e dos termos de confidencialidade aplicáveis.
Integração
Integração, API e webhooks
Como funciona a autenticação da API?
POST /api/token/ troca seu usuário e senha de API por um token de acesso válido por 5 minutos e um token de atualização válido por 24 horas. Envie o token de acesso como Authorization: Bearer em cada chamada, somente a partir de código no servidor, e libere os IPs dos seus servidores no Business Portal.
Vocês têm SDKs?
Não há SDKs oficiais de servidor: a API REST funciona com qualquer cliente HTTP, e a documentação inclui uma coleção do Postman. Para capturar cartões no navegador, o SDK JavaScript do Smart Fields oferece campos de cartão hospedados.
Como evito transações duplicadas?
Envie seu próprio externalId exclusivo em cada transação. Reutilizá-lo retorna HTTP 409 Conflict em vez de criar uma segunda transação, então repetir a requisição após um timeout é seguro.
Como funcionam os webhooks?
Você configura um endpoint HTTPS no Business Portal. Cada notificação é assinada com HMAC-SHA256 do corpo bruto, enviada no cabeçalho x-Signature. Responda 200 rapidamente e processe de forma assíncrona; entregas sem 200 são reenviadas com backoff exponencial.
Existe um ambiente de testes (Stage)?
Sim. O Stage (api.stage.localpayment.com) espelha a produção sem dinheiro real, com cartões de teste, um simulador de pagamentos em contas virtuais e cenários de teste de payouts.
Assistentes de IA conseguem ler a documentação?
Sim. Um servidor MCP público, somente de leitura em docs.localpayment.com/mcp e um índice llms.txt permitem que seu assistente trabalhe com o contrato real da API. Revise o código gerado como qualquer outro código antes de publicá-lo.
Quais opções de integração existem?
Uma API REST direta, uma página WebCheckout hospedada, links de pagamento, um iframe incorporado, o SDK JavaScript Smart Fields para captura de cartões, envios em lote no Business Portal e um servidor MCP para ferramentas de código com IA. A página de integrações compara esforço e escopo PCI de cada uma.
O que é o Business Portal?
O console web para a sua equipe: acompanhe transações, envie payouts em lote, configure webhooks e a lista de IPs permitidos, gerencie usuários com perfis e permissões personalizados e aprove payouts com dupla assinatura.
Como a API informa erros?
Com códigos HTTP padrão, 4xx para erros da requisição e 5xx para erros do servidor, além de um código e uma mensagem de erro, com detalhes por campo nos erros de validação. Registre o código de erro junto com seu externalId para agilizar o suporte.
Existe uma coleção do Postman?
Sim. A documentação inclui uma coleção do Postman com ambientes de Stage e produção, requisições de exemplo para cada endpoint e auxiliares de autenticação.
A API tem limites de requisições?
Sim. A API limita o volume de requisições para proteger o serviço. Ao receber uma resposta de limite, aplique recuo exponencial em vez de tentar de novo imediatamente, e use webhooks em vez de consultar o status repetidamente.
Como passo do Stage para a produção?
Concluídos os testes no Stage, a revisão de segurança e o KYB, você recebe credenciais de produção. Troque a URL base para api.v3.localpayment.com, inclua seus IPs de produção na lista de permissões e configure seu endpoint de webhooks de produção. O contrato da API é o mesmo.
Como verifico a assinatura de um webhook?
Calcule o HMAC-SHA256 sobre o corpo bruto da requisição com seu segredo de webhook e compare, com comparação em tempo constante, ao valor hexadecimal do cabeçalho x-Signature. Rejeite a notificação se forem diferentes.
Uma única integração pode atender vários comerciantes ou unidades de negócio?
Sim. Plataformas, marketplaces e PSPs operam vários comerciantes ou entidades com uma única integração. Como contas, saldos e liquidações se organizam depende do seu modelo: fale com vendas sobre a configuração.
Preços
Preços e contratos
Quanto custa a Localpayment?
Fazemos uma cotação para cada empresa com base nos países, meios de pagamento e volumes, em vez de publicar uma tabela única, e sua cotação lista cada tarifa aplicável. A página de preços explica como as tarifas funcionam.
Como obtenho uma cotação?
Conte aa nossa equipe comercial de quais países, meios de pagamento e fluxos você precisa, e os volumes esperados. Sua cotação lista cada tarifa aplicável, sem surpresas.
O que influencia as tarifas que eu pago?
Os países em que você opera, os meios de pagamento e trilhos que usa, o tipo de fluxo (recebimento, payout ou câmbio) e os seus volumes. Como cada empresa recebe uma cotação individual, não existe uma tabela de preços pública única.
Podemos testar antes de comprometer volume?
Sim. As credenciais do Stage (ambiente de testes) são entregues no início da parceria, e o Stage espelha a produção sem dinheiro real, então sua equipe pode construir e testar enquanto a análise de compliance avança.
Existem taxas de adesão ou mensalidades?
Sua cotação detalha cada taxa aplicável aos seus países, meios e fluxos, então nada fica oculto. Não publicamos tabela de preços; peça uma proposta a vendas.
A margem de câmbio é informada?
Sim. A margem é definida no seu contrato e incluída em cada cotação, então você vê a taxa aplicada antes de travá-la.
As tarifas variam por país ou meio de pagamento?
Sim. Cada trilho e bandeira tem sua própria estrutura de custos, por isso as tarifas são definidas por país, meio e fluxo no seu contrato.
Suporte
Suporte
Como falo com o suporte?
O suporte ao cliente atende 24/7 pelo e-mail support@localpayment.com. Relatos de segurança vão para cybersecurity@localpayment.com, e clientes no Brasil podem falar com a nossa ouvidoria em ouvidoria@localpayment.com.
Onde vejo o status do serviço?
O status.localpayment.com mostra em tempo real a disponibilidade dos serviços de pay-in, payout e autenticação e dos trilhos de cada país, além do histórico de incidentes.
Como registro uma reclamação ou uma preocupação ética?
Escreva para support@localpayment.com. Clientes no Brasil podem falar com nossa ouvidoria em ouvidoria@localpayment.com, e qualquer pessoa pode usar o canal de ética em https://www.contatoseguro.com.br/en/localpayment. A política de reclamações está publicada na seção jurídica.
Sou consumidor e vejo Localpayment na minha fatura. O que faço?
A Localpayment processa pagamentos para empresas, então a cobrança vem de um estabelecimento onde você comprou. Fale primeiro com esse estabelecimento. Se não conseguir identificá-lo, escreva para support@localpayment.com com a data e o valor e ajudaremos.
Vocês dão suporte durante a integração?
Sim. Uma equipe técnica acompanha sua integração da reunião inicial até a entrada em produção, com revisões de integração e apoio nos testes, e support@localpayment.com responde 24/7.
Como reporto um incidente?
Consulte status.localpayment.com para ver a disponibilidade em tempo real e o histórico de incidentes, e escreva para support@localpayment.com com seus externalIds e horários. O suporte responde 24/7.
Onde está a documentação?
docs.localpayment.com reúne os guias de integração e a referência da API. A Central de desenvolvedores deste site aponta para o Guia rápido, Stage, webhooks e ferramentas de IA.
PMEs
Localpayment para PMEs
Existe uma oferta para pequenas e médias empresas?
Sim, em acesso antecipado. A Localpayment para PMEs é uma conta empresarial de autoatendimento: verificação digital, contas locais de recebimento, e saldos e movimentações por moeda em um só painel. Solicite acesso e nossa equipe entrará em contato.
Quem pode solicitar acesso antecipado?
Pequenas e médias empresas que consigam concluir nossa verificação digital. Durante o acesso antecipado atendemos empresas de poucos mercados, então informe onde sua empresa foi constituída ao se inscrever.
Como funciona a verificação?
É totalmente digital. Uma verificação guiada cobre os dados da empresa, os documentos, os diretores e beneficiários finais e a atividade do negócio. Leva cerca de 15–20 minutos, salva seu progresso automaticamente e você acompanha o status da análise no app.
Posso enviar payouts ou converter moeda com a conta para PMEs?
Não durante o acesso antecipado: a conta para PMEs inclui a verificação, as contas locais de recebimento, os saldos e as movimentações. Se você precisa de payouts ou câmbio agora, nossa plataforma corporativa oferece esses recursos: fale com nossa equipe.
Quanto custa a conta para PMEs?
Durante o acesso antecipado, compartilhamos os preços diretamente com cada empresa, antes do cadastro.
Qual é a diferença entre a conta para PMEs e a plataforma corporativa?
A conta PME é self-service: verificação digital, contas de recebimento locais e um painel com saldos e atividade. A plataforma enterprise acrescenta a API, payouts, câmbio e tesouraria e operação em vários países, com um contrato comercial por empresa.
Continue explorando
Glossário de pagamentos
Definições de Pix, SPEI, CLABE, CVU, Bre-B, idempotência, travamento de câmbio e mais.
Glossário de pagamentos —Guias
Playbooks por país, checklists de integração e visões gerais de compliance.
Guias —Central de desenvolvedores
Guia rápido, Stage, webhooks e ferramentas de IA para a sua integração.
Central de desenvolvedores —Segurança
Criptografia, controles de acesso e as certificações por trás da plataforma.
Segurança —
Ainda tem alguma dúvida?
Conte sobre seus mercados e fluxos e nossa equipe retornará. Para dúvidas operacionais, o suporte ao cliente atende 24/7.

127 respostas