Skip to main content

​
Estrutura do Changelog

Cada versão é organizada em seções para facilitar a leitura:
  • Added: novos recursos e funcionalidades.
  • Changed: mudanças em recursos existentes.
  • Fixed: correções de bugs.
  • Removed: recursos ou funcionalidades removidos.
  • Deprecated: recursos ou funcionalidades que estão obsoletos e serão removidos em futuras versões.
  • Security: atualizações relacionadas à segurança.
  • Performance: melhorias de desempenho.
  • Documentation: atualizações na documentação.
  • Notes: notas adicionais sobre a versão, como links para pull requests, issues ou detalhes técnicos.
  • Contributors: lista de colaboradores que contribuíram para a versão, com links para seus perfis.
  • Other: outras mudanças que não se encaixam nas categorias acima.

​
v15.03.2026

Added
  • Atualização dos models User e Store para suportar URLs de webhook (API)
  • Refatoração do upload de imagens para usar blob server interno e atualização dos componentes relacionados (Site)
  • Aprimoramento da gestão de webhooks com melhor controle de estado e feedback ao usuário (Site)
Changed
  • Ajuste no package.json da API e do Site para nova versão 15.03.2026
  • Ajuste no controle de sessão e logging de erros nos controllers de autenticação (API)
Fixed
  • Correção de logging de erro e ajuste no skip de recuperação de sessão nos controllers de autenticação (API)
Documentation
  • Atualização de versão e dependências nos pacotes (API e Site)
Contributors

​
v14.03.2026

Added
  • Nova estrutura de documentação para Webhooks: seção própria, endpoints GET/POST/DELETE documentados separadamente.
  • Documentação de payload criptografado e exemplo de decifragem no tutorial.
Changed
  • Navegação da documentação reorganizada: webhooks não aparecem mais em lojas, mas em grupo próprio.
  • Tutorial de webhooks revisado para alinhar com a API real e o formato criptografado.
  • Ajuste nos exemplos e explicações para refletir a implementação real do backend.
Removed
  • Removido campo/menção a webhooks da resposta de loja na documentação.
  • Arquivo antigo de webhooks dentro de stores removido.
Contributors

​
v13.03.2026

Added
  • Revisão do job de expiração de planos (billing.job.js) para garantir compatibilidade com a estrutura atual de assinaturas baseada em UserSubscriptionHistory.
  • Validação da lógica de assinatura ativa usando getPrimarySubscription e conferência dos critérios de expiração e notificações.
  • Função minimalista para setar plano do usuário (setUserPlan).
  • Refatoração do helper ACTIVE_SUBSCRIPTION para lógica direta e enxuta.
  • Validação e documentação dos códigos de erro do endpoint de criação de loja.
  • Ajuste no frontend: tratamento de erros no modal de criação de loja agora impede feedback de sucesso indevido.
Changed
  • Documentação do fluxo de assinatura e expiração revisada via IA.
  • Refatoração dos schedulers e filas: nomes de jobs e filas padronizados para evitar conflitos e garantir processamento correto.
  • Limpeza automática de jobs concluídos e falhados agora é padrão em todas as filas (removeOnComplete/removeOnFail).
  • Atualização dos métodos de agendamento para usar apenas as opções essenciais, centralizando a configuração de limpeza no core da fila.
  • Atualização do webhook de assinatura para usar a nova assinatura do ACTIVE_SUBSCRIPTION.
  • Padronização dos retornos de status e códigos de erro no backend de lojas.
Fixed
  • E-mails de expiração e expiração de plano revisados e corrigidos, agora enviados com novo design padronizado.
  • Correção do job de expiração para processar assinaturas já vencidas, não apenas ativas.
  • Atualização direta do metadata do histórico de assinatura, sem dependência de função externa.
  • Correção do switch/case de erros no modal de criação de loja para garantir UX correta.
  • Ajuste de classes Tailwind para evitar warnings de build.
Contributors

​
v11.03.2026

Added
  • Suporte a múltiplos métodos de pagamento via Mercado Pago: PIX e Cartão de Crédito (MERCADOPAGO_SERVICE_PIX, MERCADOPAGO_SERVICE_CARD).
  • Campo feeAppliedTo nas credenciais do gateway para definir em quais métodos de pagamento a taxa é aplicada (ex: apenas cartão, apenas pix, ou ambos).
  • Estrutura padronizada de resposta de pagamento com objetos service e payment separados.
  • Registro do campo gatewayMethod nos metadados internos do pagamento para rastreabilidade.
Changed
  • Lógica de cálculo de taxa (feePercentage) agora considera feeAppliedTo — a taxa só é aplicada se o método de pagamento estiver listado.
  • Resposta da API de pagamento reestruturada: agora retorna { service, payment } em vez de dados planos.
  • Pagamentos gratuitos agora retornam service.type: "FREE_PAYMENT" para consistência com os demais fluxos.
  • Gateway de cartão migrado para Checkout Pro do Mercado Pago com exclusão de métodos não desejados via excluded_payment_types e excluded_payment_methods.
Fixed
  • Correção de bug onde MERCADOPAGO_SERVICE não retornava o resultado do axios por ausência de return.
  • Correção de bug onde value.gateway era sobrescrito com gatewayType, fazendo o serviço sempre cair no fluxo UNSUPPORTED_PAYMENT_TYPE.
  • Correção do campo gateway salvo no banco para usar o enum correto do Prisma (MERCADOPAGO) em vez do método completo.
  • Remoção de default_payment_method_id: "credit_card" que causava erro invalid default_payment_method_id na API do Mercado Pago.
Documentation
  • Nova página de referência para o endpoint POST /stores/:storeId/payments com exemplos de requisição, snippets JavaScript e respostas documentadas para PIX, Cartão e pagamento gratuito.
Contributors

​
v08.03.2026

Added
  • Changelog atualizado para documentar os novos schedulers automáticos (UserDelete, Billing) e a tradução de todas as mensagens de scheduler/fila para inglês.
  • Opção para configurar taxa (%) repassada ao cliente ao usar gateways de pagamento (frontend e backend).
  • Campo feePercentage agora pode ser definido por gateway e salvo nas credenciais criptografadas.
  • Aplicação automática da taxa no valor final do pagamento, tanto na API pública quanto na admin.
  • Registro dos campos gatewayFeePercentage e gatewayFeeAmount nos metadados do pagamento.
  • IDs e htmlFor dos campos do modal de gateways agora seguem o padrão gateway-TIPO-campo para compatibilidade e acessibilidade.
  • Mensagens de validação dos gateways exibidas em português, tanto no frontend quanto no backend.
Changed
  • Estrutura dos metadados de pagamento na API admin agora está idêntica à pública para taxas de gateway.
  • Validação aprimorada para garantir que feePercentage seja respeitado e aplicado corretamente.
  • Dashboard de pagamentos agora exibe os pagamentos mais recentes por padrão, mesmo na opção “Todos”.
  • Ajuste nos checkboxes de métodos de pagamento para garantir compatibilidade com o backend e scripts de validação.
Fixed
  • Correção de erro de reatribuição de variável (finalPrice) no controller de pagamento admin.
  • Ajustes para garantir consistência entre API pública e admin na lógica de taxas.
  • Correção de erro TypeError: Cannot read properties of undefined (reading 'split') ao salvar gateways sem id nos inputs.
  • Checagem extra para ignorar elementos sem id no script de gateways.
  • Aplicação de optional chaining (?.) para evitar erros de acesso a propriedades indefinidas.
  • Checagem de lint/type em API e site para garantir ausência de erros críticos.
Contributors

​
v05.03.2026

Added
  • Aba dedicada Changelog na navegação principal da documentação.
  • Estrutura inicial para registro contínuo de versões e mudanças.
  • Copiar o ID de usuário no modal do perfil para facilitar a integração com outras ferramentas.
  • Suporte a ordenação de categorias com campo position no backend.
  • Novo endpoint privado PUT /stores/:storeId/categories/reorder para salvar a ordem por lista de IDs.
  • Ações de painel para organizar categorias com Mover para cima e Mover para baixo.
  • Suporte a ordenação de produtos, cupons e lojas com campo position no backend.
  • Novos endpoints privados PUT /stores/:storeId/products/reorder, PUT /stores/:storeId/coupons/reorder e PUT /stores/reorder.
  • Ações de painel para organizar produtos, cupons e lojas com Mover para cima e Mover para baixo.
Changed
  • Ajuste de navegação para separar atualizações da aba de tutoriais.
  • Melhoria no agrupamento da documentação para facilitar descoberta de mudanças recentes.
  • GET /stores/:storeId/categories agora retorna categorias na ordem de position.
  • GET /stores/:storeId/categories/:categoryId e respostas de criação/edição de categoria agora incluem position.
  • GET /stores, GET /stores/:storeId/products e GET /stores/:storeId/coupons agora retornam dados na ordem de position.
  • Respostas de criação/edição e detalhes de produtos, cupons e lojas agora incluem position.
Fixed
  • Correção de links quebrados relacionados a tutoriais de integração.
  • Correção de inconsistências na nomenclatura de versões anteriores.
  • Correção de formatação em seções de changelog anteriores.
  • Erros de rotas que era privada e agora é pública.
Documentation
  • Atualização da documentação para incluir o changelog e instruções de uso.
  • Novos tutoriais de integração adicionados à documentação, como Mercado Pago, EFI Bank (apenas as abas).
  • Documentação da API de categorias atualizada com o campo position.
  • Nova página da API para reordenação: api-reference/category/reorder.
  • Documentação da API de produtos, cupons e lojas atualizada com o campo position.
  • Novas páginas de reordenação: api-reference/product/reorder, api-reference/coupon/reorder e api-reference/store/reorder.
Notes
  • Esta é a versão inicial do changelog, e as versões anteriores estão sendo documentadas retroativamente.
  • As versões anteriores estão sendo revisadas para garantir que todas as mudanças significativas sejam registradas.
  • O changelog será atualizado regularmente com cada nova versão lançada, e as versões anteriores serão revisadas para garantir que todas as mudanças significativas sejam registradas.
Contributors