Integrações
Conecte-se do seu jeito: API, páginas hospedadas ou sem código
Escolha o caminho que combina com sua equipe e seu escopo PCI. Construa sobre a API REST, use um checkout hospedado, envie um Payment Link ou suba um lote no Business Portal, e deixe sua ferramenta de código com IA ler o contrato real.
- API REST
- Stage (ambiente de testes)
- Webhooks assinados
- Servidor MCP público
API RESTSete caminhos
Escolha como se conectar
Por trás de cada caminho estão as mesmas contas, saldos e relatórios, então você pode começar leve e somar mais depois.
API REST diretaMais flexível
Controle total sobre recebimentos, payouts, contas virtuais, FX e relatórios. JSON sobre HTTPS, chamado do seu servidor, com webhooks assinados a cada mudança de status.
API REST direta —WebCheckout hospedadoSem código
Envie seus clientes a um checkout hospedado pela Localpayment com os métodos locais que você habilitar. Sem código de front-end para manter.
WebCheckout hospedado —Payment LinksSem código
Crie um link no Business Portal e compartilhe por e-mail, SMS ou redes. Ideal para faturas, vendas remotas e cobranças pontuais.
Payment Links —iframe incorporadoWhite-label
Coloque um checkout white-label dentro da sua página e mantenha sua marca ao redor, com escopo PCI reduzido.
iframe incorporado —SDK JS Smart FieldsFormulário próprio
Campos de cartão hospedados, tokenizados no navegador e consolidados em um token de uso único que seu servidor depois cobra. Você controla o design do formulário.
SDK JS Smart Fields —Lotes no Business PortalOperações
Suba arquivos de payouts e de contas virtuais e acompanhe os resultados no portal. Sem trabalho de integração para finanças e operações.
Lotes no Business Portal —Servidor MCP para IACom IA
Um servidor MCP público, somente de leitura e o llms.txt permitem que Cursor, VS Code, Claude e outros assistentes construam sobre a API documentada.
Servidor MCP para IA —
Compare
Esforço, escopo PCI e melhor uso
Um guia para pré-selecionar. Seu escopo PCI final depende de como você captura e armazena dados de cartão; confirme com seu avaliador.
API REST direta
- Esforço
- Alto: desenvolvimento no servidor
- Escopo PCI
- Depende de como você captura os dados de cartão; combine com Smart Fields ou uma opção hospedada
- Ideal para
- Plataformas que precisam de controle total de recebimentos, payouts e FX
WebCheckout hospedado
- Esforço
- Baixo: redirecionamento
- Escopo PCI
- Mínimo
- Ideal para
- Equipes que querem métodos locais no ar rápido
Payment Links
- Esforço
- Muito baixo: sem código
- Escopo PCI
- Mínimo
- Ideal para
- Faturas, vendas remotas, cobranças pontuais
iframe incorporado
- Esforço
- Baixo a médio
- Escopo PCI
- Reduzido
- Ideal para
- Checkout com sua marca sem lidar com campos de cartão
SDK JS Smart Fields
- Esforço
- Médio: front-end e servidor
- Escopo PCI
- Compartilhado
- Ideal para
- Design de checkout próprio com campos de cartão hospedados
Lotes no Business Portal
- Esforço
- Muito baixo: upload de arquivo
- Escopo PCI
- Sem dados de cartão
- Ideal para
- Finanças e operações que executam payouts e contas virtuais
Servidor MCP para IA
- Esforço
- Baixo: adicionar uma URL
- Escopo PCI
- Não se aplica: sem dados de pagamento
- Ideal para
- Engenheiros que usam assistentes de código com IA
As credenciais do Stage (ambiente de testes) são entregues no início da parceria. O acesso à produção vem após os testes, uma revisão de segurança e a verificação da empresa (KYB).
A API na prática
Um recebimento típico por API, de ponta a ponta
Quatro partes, seis passos. Seu backend fala com uma só API; o trilho local fica por nossa conta.
- 1
Backend do comércioAPI da Localpayment:
Autenticar
POST /api/token/ retorna um token de acesso de curta duração. As chamadas saem do seu servidor, de um IP autorizado.
- 2
Backend do comércioAPI da Localpayment:
Criar o recebimento
POST /api/payin/ com seu próprio externalId, país, moeda, valor e método de pagamento.
- 3
API da LocalpaymentTrilho local:
Rotear ao trilho local
A Localpayment envia a solicitação pelo trilho que você habilitou, como Pix, SPEI ou PSE.
- 4
Trilho localAPI da Localpayment:
O cliente paga
O trilho confirma o pagamento. Trilhos em tempo real confirmam em segundos, 24/7.
- 5
API da LocalpaymentEndpoint de webhooks:
Webhook assinado
Um webhook com o cabeçalho X-Signature HMAC-SHA256 anuncia o novo status.
- 6
Endpoint de webhooksBackend do comércio:
Verificar e atualizar
Valide a assinatura, deduplique por externalId ou internalId, responda 200 e atualize o pedido.
Ilustração simplificada com dados fictícios. Veja o Guia rápido para os campos exatos de requisição e resposta.
Entre em produção
Do contrato assinado à produção
Receba credenciais de Stage
As credenciais do Stage chegam no início da parceria, para que a engenharia comece enquanto a revisão de compliance acontece.
Construa e teste no Stage
O Stage replica a produção sem dinheiro real. Use cartões de teste, o simulador de contas virtuais e a coleção do Postman.
Revisão e verificação
As credenciais de produção vêm após concluir os testes, uma revisão de segurança e a verificação da empresa (KYB).
Entre no ar em semanas
Troque a URL base e as credenciais, autorize seus IPs e comece. Novos mercados usam a mesma API.
Perguntas frequentes
Perguntas sobre integração
Com qual caminho devemos começar?
Se você precisa de controle e tem engenheiros, comece pela API REST. Se quer métodos locais no ar rápido, use WebCheckout ou Payment Links. É possível combinar caminhos na mesma conta.
Vocês oferecem SDKs de servidor?
Não há SDKs de servidor oficiais. A API REST é JSON sobre HTTPS e a documentação traz exemplos em cURL e Node.js. O único SDK é o SDK JS Smart Fields, no lado do cliente.
Como as chamadas à API são protegidas?
As chamadas usam HTTPS a partir de ambientes de servidor, com tokens Bearer, e exigem a liberação de IPs. Os webhooks são assinados com HMAC-SHA256 para você verificar que vêm da Localpayment.
Como evitamos cobranças duplicadas?
Envie seu próprio externalId único em cada transação. Uma duplicata retorna HTTP 409, e quem consome webhooks deve deduplicar por externalId ou internalId.
Como isso afeta nosso escopo PCI?
Depende do caminho. WebCheckout hospedado e Payment Links mantêm o escopo mínimo, o iframe incorporado o reduz e o Smart Fields o compartilha. Confirme o resultado com seu avaliador.
Como as ferramentas de código com IA ajudam?
Adicione o servidor MCP público, somente de leitura em docs.localpayment.com/mcp ao Cursor, VS Code, Claude ou similares. Elas passam a ler a API documentada em vez de adivinhar.
Quanto tempo leva a integração?
As credenciais de Stage chegam no início da parceria e entrar em produção leva semanas, conforme o caminho e seus ciclos de revisão. Fale com vendas para um plano sob medida.
Comece a construir hoje
Conte-nos seus mercados e seu stack. Recomendaremos o caminho de integração e prepararemos suas credenciais de Stage.