🔧 Troubleshooting - Integrações APPs Private Label
Este guia ajuda você a identificar e resolver problemas comuns ao integrar com as APIs dos APPs Private Label.
🎯 Início Rápido: Checklist de Debug
Antes de abrir um chamado de suporte, verifique:
- Token válido: Seu JWT está dentro da validade?
- Headers corretos: Header
Authorization: Bearer <token>está presente? - URL correta: Está usando HML ou PRD apropriadamente?
- Formato JSON: Body está em JSON válido?
- Campos obrigatórios: Todos os campos required foram enviados?
- Server correto: O endpoint está apontando para o serviço correto (cartao-app, extrato-app, etc.)?
📑 Índice por Serviço
- 💳 Cartão — 9 endpoints
- 📊 Extrato e Faturas — 8 endpoints
- 💰 Arrecadação — 11 endpoints
- 🛒 Produtos Financeiros — 9 endpoints
- 💸 Empréstimo Pessoal — 35 endpoints
- 🏷️ Serviços PL — 10 endpoints
- 📞 Atendimento — 3 endpoints
- 👤 Cadastro — 5 endpoints
- 🎁 Promoções — 3 endpoints
📚 Erros Comuns por Endpoint
💳 Cartão
1. Listar Cartões (GET /cartao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
2. Detalhes do Cartão (GET /cartao/detalhe/{idCartao})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
IdCartao inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
🔍 404 Not Found
| Mensagem | Solução |
|---|---|
Cartão não encontrado | Confirme que o recurso solicitado existe. Verifique IDs e parâmetros de path. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao recuperar detalhes do cartão | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
3. Cartão Titular (GET /cartao/titular)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetros inválidos | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
🔍 404 Not Found
| Mensagem | Solução |
|---|---|
Cartão titular não encontrado | Confirme que o recurso solicitado existe. Verifique IDs e parâmetros de path. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao recuperar cartão titular | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
4. Direcionamento Negociação (GET /cartao/cobranca)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
5. Gerar Voucher (POST /voucher)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
ID do cartão é obrigatório | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao gerar cartão digital | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
6. Alterar Senha do Cartão (PUT /senha)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Senha deve conter pelo menos 4 caracteres | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao criar senha do cartão | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
7. Validar Senha do Cartão (POST /senha/validar)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Senha inválida ou não cadastrada | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao validar senha do cartão | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
8. Exibir Senha do Cartão (GET /senha/clarear)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Código do cartão é obrigatório | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao exibir senha do cartão | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
9. Validar CVV (POST /cvv/valida)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
CVV inválido ou ausente | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao validar CVV do cartão | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
📊 Extrato e Faturas
10. Faturas Passadas (GET /faturas/passadas)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
11. Faturas Futuras (GET /faturas/futuras)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
12. Fatura Atual (GET /faturas/atual)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
13. Detalhes da Fatura (GET /faturas/detalhes)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
14. Verificar Pagamento (GET /faturas/permitePagamento/{numeroExtrato})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
15. Opções de Parcelamento (GET /faturas/{numeroExtrato}/parcelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
16. Listar Faturas (GET /faturas)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
17. Detalhes da Transação (GET /transacao/{idTransacao})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
💰 Arrecadação
18. Gerar QR Code PIX - Extrato (POST /pix/extrato/gerarQRCode)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
19. Comprovante PIX (GET /pix/comprovante/{chaveComprovante})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
20. Gerar QR Code PIX - Carnê (POST /pix/carne/gerarQRCode)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
21. Status PIX (GET /pix/status/{chave})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
22. Consultar Boleto Extrato (GET /boleto/extrato/{idExtrato})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
23. Boleto Extrato PDF (GET /boleto/extrato/{idExtrato}/pdf)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
24. Boleto Carnê - Parcela (GET /boleto/carne/{contrato}/parcela/{parcela})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
25. Boleto Carnê - Parcela PDF (GET /boleto/carne/{contrato}/parcela/{parcela}/pdf)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
26. Boleto Personalizado (GET /boleto/personalizado)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
27. Fatura PDF (GET /fatura/pdf)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
28. Listar Lojas (GET /lojas)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
🛒 Produtos Financeiros
29. Gerar Token Transacional (POST /token-transacional)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
30. Consultar Ofertas (GET /produtos-financeiros/oferta)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
31. Aderir Produto (POST /produtos-financeiros/adesao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
32. Cancelar Adesão (PATCH /produtos-financeiros/cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
33. Consultar Contratados (GET /produtos-financeiros/contratados)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
34. Detalhes do Produto (GET /produtos-financeiros/detalhes/{codigoProduto})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
35. Consultar Termo de Adesão (GET /produtos-financeiros/termo/adesao/{codigoAdesao})
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
36. Criar Pré-Adesão (POST /produtos-financeiros/termo/pre-adesao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Requisição inválida | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
37. Motivos de Cancelamento (GET /produtos-financeiros/motivo-cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
💸 Empréstimo Pessoal
38. Consultar Agendamento (GET /agendamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
39. Cancelar Agendamento (POST /agendamento/cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
40. Verificar Elegibilidade (POST /elegibilidade)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
41. Cancelar Elegibilidade (POST /elegibilidade/cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
42. Listar Bancos (GET /banco)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
43. Listar Contas (GET /conta)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
44. Cadastrar Conta (POST /conta)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
45. Consultar Efetivação (GET /efetivacao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
46. Efetivar Contratação (POST /efetivacao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
47. Cancelar Efetivação (POST /efetivacao/cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
48. Boleto Cancelamento (GET /efetivacao/cancelamento/boleto)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
49. Simular Planos (GET /simulacao-plano)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
50. Health Check (GET /isAlive)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
51. Boleto Cancel. - SMS (POST /cancelamento/boleto/envio-sms)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
52. Boleto Cancel. - Email (POST /cancelamento/boleto/envio-email)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
53. Elegib. Cancel. Seguro (GET /seguro/cancelamento/elegibilidade)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
54. Cancelar Seguro (POST /seguro/cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
55. Valores Cancel. Seguro (GET /seguro/cancelamento/valores)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
56. Status Cancel. Seguro (GET /seguro/consulta-cancelado)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
57. Transferência Seguro (POST /seguro/cancelamento/pedido-transferencia)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
58. Consultar Transf. Seguro (GET /seguro/cancelamento/consulta-pedido-transferencia)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
59. Pré-Contrato PDF (GET /precontrato)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
60. Contrato PDF (GET /contrato)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
61. Consultar Parcelas (GET /parcela)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
62. Boleto da Parcela (GET /parcela/boleto)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
63. Boleto Parcela - SMS (POST /parcela/boleto/envio-sms)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
64. Boleto Parcela - Email (POST /parcela/boleto/envio-email)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
65. Transferência Agendada (GET /transferencia-agendada)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
66. Elegib. Antecipação (GET /antecipacao/elegibilidade)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
67. Parcelas p/ Antecipação (GET /antecipacao/parcela)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
68. Efetivar Antecipação (POST /antecipacao/efetivacao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
69. Consultar Antecipação (GET /antecipacao)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
70. Cancelar Antecipação (POST /antecipacao/cancelamento)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
71. Boleto Antecip. - SMS (POST /antecipacao/boleto/envio-sms)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
72. Boleto Antecip. - Email (POST /antecipacao/boleto/envio-email)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetro inválido | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token inválido ou expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro interno | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
🏷️ Serviços PL
73. Consultar Elegib. Opt-in (GET /optin-servico)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
74. Contratar Serviço (Opt-in) (POST /optin-servico)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Ocorreu um erro ao contratar o optin. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
75. Alterar Status Opt-in (PUT /optin-servico)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Ocorreu um erro ao contratar o optin. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
76. Valores de Anuidade (GET /anuidade/valores)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Ocorreu um erro ao recuperar as taxas de anuidade | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
77. Gerar Link Biometria (POST /biometria/link)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetros inválidos ou consumidor ausente | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
78. Taxas Limite Emergencial (GET /limite-emergencial/taxas)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
79. Carnês Abertos (GET /carne/abertos)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
80. Histórico de Carnês (GET /carne/historico)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
81. Detalhes do Carnê (GET /carne/detalhes/{contrato}/{parcela})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Ocorreu um erro ao buscar as informações da loja. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
82. Consultar Termo/Contrato (GET /termos-contratos/{Chave})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
📞 Atendimento
83. Dados Emissor (Logado) (GET /cleo/dados)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Ocorreu um erro ao tentar recuperar o termo. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
84. Link Chat Cleo (GET /cleo/chat/link)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
85. Dados Emissor (Público) (GET /cleo/dados/{idApp})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Ocorreu um erro ao tentar recuperar o termo. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
👤 Cadastro
86. Obter Dados Pessoais (GET /dados-pessoais)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetros inválidos | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao recuperar dados pessoais | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
87. Atualizar Dados Pessoais (PUT /dados-pessoais)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetros inválidos ou dados incompletos | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao atualizar dados pessoais | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
88. Obter Endereço (GET /dados-pessoais/endereco)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Parâmetros inválidos | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao recuperar endereços | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
89. Atualizar Endereço (PUT /dados-pessoais/endereco)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Endereço inválido ou parâmetros obrigatórios faltando | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao atualizar endereço | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
90. Buscar CEP (GET /cep/{cep})
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
CEP inválido ou parâmetro ausente | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Token Inválido ou Token Expirado | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
🔍 404 Not Found
| Mensagem | Solução |
|---|---|
CEP não encontrado | Confirme que o recurso solicitado existe. Verifique IDs e parâmetros de path. |
💥 500 Internal Server Error
| Mensagem | Solução |
|---|---|
Erro ao consultar CEP | Erro interno do servidor. Tente novamente em alguns instantes. Se persistir, entre em contato com o suporte informando o endpoint e os dados enviados. |
🎁 Promoções
91. Banners Promocionais (GET /banners)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
92. Campanhas Cashback (GET /cashback)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
93. Programa de Fidelidade (GET /loyalty)
⚠️ 400 Bad Request
| Mensagem | Solução |
|---|---|
Authorization é uma informação obrigatória. | Verifique os parâmetros enviados. Confirme que todos os campos obrigatórios estão presentes e no formato correto. |
⛔ 401 Unauthorized
| Mensagem | Solução |
|---|---|
Não foi possível validar o token | Obtenha um novo token via endpoint de autenticação. Tokens JWT têm validade limitada. |
🔄 Erros Gerais (Todos os Endpoints)
Estes erros podem ocorrer em qualquer endpoint:
⛔ 401 Unauthorized — Token Expirado
Sintoma: Todas as chamadas retornam 401.
Solução:
- Faça nova requisição ao endpoint de autenticação (
POST /token) - Guarde o novo
access_token - Implemente renovação automática antes do token expirar
Exemplo de renovação:
curl -X POST 'https://ssohml.credsystem.com.br/auth/realms/{realm}/protocol/openid-connect/token' \
-d 'grant_type=refresh_token&refresh_token=SEU_REFRESH_TOKEN&client_id=SEU_CLIENT_ID&client_secret=SEU_CLIENT_SECRET'
💥 500 Internal Server Error — Erro Genérico
Sintoma: Erro intermitente sem mensagem clara.
Solução:
- Aguarde 30 segundos e tente novamente
- Implemente retry com backoff exponencial (1s, 2s, 4s, 8s)
- Se persistir após 3 tentativas, abra chamado com suporte
🌐 CORS / Network Error
Sintoma: Erro de rede ou CORS no navegador.
Solução:
- Chamadas à API devem ser feitas pelo backend, não pelo frontend
- Verifique se a URL está correta (HML vs PRD)
- Confirme que não há proxy ou firewall bloqueando
⏱️ Timeout
Sintoma: A requisição demora e retorna timeout.
Solução:
- Configure timeout de 30-60 segundos
- Para endpoints de geração de PDF/QR Code, use timeout maior (60s)
- Verifique conectividade de rede
📞 Contato com Suporte
Se o problema persistir após seguir este guia:
Informações para incluir no chamado:
- Endpoint que estava sendo acessado (método + path)
- Timestamp de quando ocorreu o erro
- Dados enviados (remova informações sensíveis como tokens)
- Resposta recebida (completa, incluindo status code e body)
- Ambiente (HML ou PRD)
- Server/URL Base utilizada
- Passos para reproduzir o problema
Canais de Contato:
Tempo de Resposta:
- 🔴 Crítico (produção parada): 2 horas
- 🟡 Alto (funcionalidade impactada): 8 horas
- 🟢 Normal (dúvidas, melhorias): 24 horas
🔄 Ambientes
Homologação (HML)
| Serviço | URL Base |
|---|---|
| Cartão | https://apihml.credsystem.com.br/cartao-app/api/v1 |
| Extrato | https://apihml.credsystem.com.br/extrato-app/api/v1 |
| Arrecadação | https://apihml.credsystem.com.br/arrecadacao-app/api/v1 |
| Venda | https://apihml.credsystem.com.br/venda-app/api/v1 |
| Empréstimo Pessoal | https://apihml.credsystem.com.br/emprestimo-pessoal-app/api/v1 |
| Private Label | https://apihml.credsystem.com.br/private-label-app/api/v1 |
Produção (PRD)
| Serviço | URL Base |
|---|---|
| Cartão | https://api.credsystem.com.br/cartao-app/api/v1 |
| Extrato | https://api.credsystem.com.br/extrato-app/api/v1 |
| Arrecadação | https://api.credsystem.com.br/arrecadacao-app/api/v1 |
| Venda | https://api.credsystem.com.br/venda-app/api/v1 |
| Empréstimo Pessoal | https://api.credsystem.com.br/emprestimo-pessoal-app/api/v1 |
| Private Label | https://api.credsystem.com.br/private-label-app/api/v1 |