Esta documentação cobre as integrações que você pode construir por fora do painel Kleevo: um checkout customizado no seu próprio domínio, um portal de membros com a sua cara, ou a conexão da sua loja Shopify à Kleevo.
Ela não inclui rotas internas do painel Kleevo (login de vendedor, configurações de conta, antifraude, área administrativa) — essas continuam existindo, mas não fazem parte da superfície pública da API.
Base URL
Todas as rotas descritas nesta documentação partem da mesma base:
https://auth.kleevopay.com/functions/v1/<rota>
💡 Formato: todas as chamadas usam
application/json, tanto no corpo da requisição quanto na resposta.Convenções gerais
Formato de erro
Toda rota retorna erros no formato abaixo:
{ "error": "Mensagem legível." }
| Código | Significado |
|---|---|
| 400 | Dados inválidos |
| 401 | Sessão ausente ou expirada |
| 404 | Não encontrado |
| 409 | Conflito |
| 422 | Regra de negócio |
| 429 | Limite de requisições excedido |
| 500 / 502 | Erro interno ou de um provedor externo |
CORS e domínios próprios
As rotas de checkout aceitam chamadas tanto de app.kleevopay.com quanto de qualquer domínio próprio que você já tenha cadastrado e verificado no seu painel Kleevo (Configurações → Domínio personalizado).
⚠️ Uma origem não reconhecida é bloqueada pelo navegador. Se você for construir um checkout customizado, cadastre e verifique seu domínio antes de testar a integração.