Skip to main content

​
API Pública KlivoPay

Integre facilmente soluções de pagamento em sua aplicação com nossa API RESTful segura e confiável.

API v1.0 Ativa

Versão estável em produção

PCI DSS Certificado

Segurança certificada

100% Uptime

Disponibilidade garantida

Autenticação Segura

Tokens criptografados

​
Principais Recursos

Tokens de API únicos com criptografia avançada e rate limiting para proteger suas integrações contra acessos não autorizados.
Interface REST padronizada com JSON, fácil de integrar e usar em qualquer linguagem.
Webhooks e notificações em tempo real para manter sua aplicação sempre atualizada.

​
Começando em 3 Passos

Configure sua integração em minutos
1

Obtenha seu Token de API

Acesse sua conta KlivoPay, vá até as configurações de API e gere seu token de acesso.
2

Configure sua Aplicação

Use a URL base https://api.klivopay.com.br/api e inclua seu token em todas as requisições.
3

Faça sua Primeira Transação

Teste com o endpoint de criação de transação e comece a processar pagamentos imediatamente.

​
Conceitos Fundamentais

​
Transações

Representam operações financeiras como pagamentos, reembolsos e consultas. Cada transação possui um identificador único (hash) e passa por diferentes status durante seu ciclo de vida.
Exemplo: POST /transactions para criar um novo pagamento

​
Produtos e Ofertas

Produtos são itens que você vende, enquanto ofertas são configurações específicas de preço e condições para esses produtos. Um produto pode ter múltiplas ofertas.
Exemplo: GET /products para listar seus produtos

​
Saldo e Saques

Consulte seu saldo disponível e solicite transferências para sua conta bancária. O sistema processa saques automaticamente respeitando os prazos estabelecidos.
Exemplo: GET /balance para consultar saldo atual

​
Contas Bancárias

Gerencie suas informações bancárias para recebimento de pagamentos. Suporte para contas correntes, poupança e chaves PIX.
Exemplo: POST /bank-accounts para cadastrar conta

​
HTTP e Segurança

​
Comunicação Criptografada

Todas as requisições utilizam TLS 1.3 com criptografia de ponta a ponta. Headers de segurança obrigatórios e validação rigorosa de dados garantem máxima proteção em todas as comunicações.

Autenticação

Use o parâmetro api_token em todas as requisições.

Formato de Dados

Todas as requisições e respostas usam JSON. Valores monetários são em centavos.

Rate Limiting

Máximo de 1000 requisições por minuto. Headers de limite são retornados nas respostas.

​
URL Base da API

https://api.klivopay.com.br/api/public/v1
Todas as requisições devem ser feitas para esta URL base seguida do endpoint específico.

​
Tokens de Acesso

Produção

Use seu token real obtido no painel da KlivoPay

Sandbox

Disponível para testes sem processamento real

​
Configuração de Postback

Configure uma URL em sua aplicação para receber notificações automáticas sobre mudanças no status das transações. Exemplo de payload recebido: 
{
  "transaction_hash": "abc123def456",
  "status": "paid",
  "amount": 15000,
  "payment_method": "pix",
  "paid_at": "2025-01-20T10:15:00Z"
}