Revisado em 19/09/2026
Integrar a API Pro
Autenticação no servidor, privilégio mínimo e ambientes separados.
Execute os exemplos no seu servidor com seus próprios dados de sandbox. Nunca inclua chaves no frontend. Esta documentação não habilita operações live.
Chaves e scopes
Envie chaves lp_sandbox_… ou lp_live_… como Authorization: Bearer. Negócio e ambiente derivam da chave, não de um ID enviado pelo cliente. Owner/admin/developer podem emitir chaves com MFA; apenas owner/admin delegam scopes financeiros. O contrato Pro deve estar vigente.
Idempotência e erros
Todos os POST exigem Idempotency-Key com 8–200 caracteres. Reutilizar a chave com outro payload em criação financeira causa conflito. Preserve requestId para diagnóstico. Erro: {error:{code,message,requestId}}. HTTP 400 valida dados, 401 autenticação, 403 permissões/plano, 404 recurso, 409 conflito, 429 limite e 500 erro interno.
Paginação e limites
Listas: limit de 1 a 100, padrão 50, e before com o último UUID recebido. Ordem decrescente por criação e ID. Limite atual de 300 solicitações por minuto por negócio e ambiente. Use backoff; não repita cobranças às cegas.
Exemplo no servidor
Use variáveis privadas e verifique HTTP antes de processar data. A documentação não oferece controle para executar solicitações live.
const key = process.env.LUNAPAY_API_KEY;
if (!key) throw new Error('Missing server API key');
const response = await fetch('https://payments.lunapay.ar/v1/payments?limit=50', {
headers: { Authorization: 'Bearer ' + key },
});
const payload = await response.json();
if (!response.ok) throw new Error(payload.error?.code || 'API_ERROR');
const payments = payload.data;Contrato de desenvolvimento · fonte: Payments · 9f82d06
Próximo guiaWebhooks verificados