Skip to main content
Acompanhe todas as mudanças, melhorias e correções da API Upay. Mantemos compatibilidade retroativa sempre que possível e comunicamos breaking changes com antecedência.
Versionamento: A API Upay segue o padrão de versionamento semântico (SemVer). A versão atual é v1.

​
2026

​
Fevereiro 2026

​
v1.5.0 - 19 de fevereiro de 2026

  • Advanced Sales Tracking: Integração nativa com Utmify para rastreamento preciso de campanhas e UTMs.
  • IP Tracking: Captura automática de IP do comprador e suporte a parâmetros de rastreio customizados (src, fbclid, gclid).
  • Layout Admin: Refinamento completo da interface do Dashboard e painel Admin para melhor usabilidade em dispositivos móveis.
  • Performance: Otimização no carregamento de modais e estados de skeleton.
  • Segurança: Melhorias na criptografia de tokens de integração de terceiros.
  • Corrigido problema de validação de IP obrigatório na API da Utmify para ordens manuais.
  • Ajustado casing de endpoints internos da API (/utmfy).
  • Corrigido alinhamento de breadcrumbs no layout Admin.

​
Janeiro 2026

​
v1.4.0 - 15 de janeiro de 2026

  • SDKs oficiais: Lançamento dos SDKs para JavaScript/TypeScript, Python, PHP e Java
  • Validação de webhooks: Novos utilitários para validar assinaturas de webhooks em todos os SDKs
  • Meta Pixel: Suporte para integração com Meta Pixel em links de pagamento
  • Parcelamento: Configuração de parcelamento até 12x em links de pagamento
  • Melhor tratamento de erros com códigos específicos
  • Documentação expandida com exemplos em múltiplas linguagens
  • Performance otimizada nas listagens com paginação
  • Headers de rate limit mais informativos
  • Corrigido problema de timezone em datas de expiração
  • Corrigido cálculo de desconto com cupons percentuais
  • Corrigido validação de CPF/CNPJ em alguns casos específicos

​
Dezembro 2025

​
v1.3.0 - 20 de dezembro de 2025

  • Webhooks: Sistema completo de webhooks para notificações em tempo real
  • Eventos suportados: transaction.paid, transaction.failed, transaction.refunded, payment_link.expired
  • Assinaturas de webhook: Gerenciamento de subscriptions via API
  • Retry automático: Sistema de retry para webhooks que falharem
  • Adicionado campo metadata em transações para dados customizados
  • Melhor validação de dados de entrada
  • Mensagens de erro mais descritivas

​
v1.2.0 - 5 de dezembro de 2025

  • Sistema de cupons: Criação e validação de cupons de desconto
  • Tipos de desconto: Suporte para desconto fixo e percentual
  • Limites de uso: Controle de uso por cupom e por usuário
  • Produtos aplicáveis: Restrição de cupons a produtos específicos
  • Adicionado campo expiresAt em links de pagamento
  • Suporte para URLs de redirecionamento customizadas
  • Melhor tratamento de estoque em links de pagamento

​
Novembro 2025

​
v1.1.0 - 15 de novembro de 2025

  • Gestão de produtos: Endpoints para criar e gerenciar produtos
  • Catálogo de produtos: Associação de produtos a links de pagamento
  • Controle de estoque: Gestão automática de estoque por produto
  • Imagens de produtos: Suporte para múltiplas imagens por produto
  • Paginação melhorada com metadados completos
  • Filtros avançados em listagens
  • Ordenação customizável em queries
  • Corrigido problema de encoding em slugs com caracteres especiais
  • Corrigido validação de telefone internacional

​
v1.0.1 - 1 de novembro de 2025

  • Corrigido problema de CORS em requisições OPTIONS
  • Corrigido validação de email em alguns casos
  • Melhorado tratamento de erros de rede

​
Outubro 2025

​
v1.0.0 - 15 de outubro de 2025 🎉

  • Links de pagamento: Criação e gestão de links de pagamento personalizados
  • Transações: Listagem e consulta de transações
  • Múltiplos métodos: Suporte para PIX, Cartão de Crédito/Débito e Boleto
  • Autenticação: Sistema de API Keys
  • Rate limiting: Proteção contra abuso
  • Documentação: Documentação completa da API

​
Próximas versões

​
Em desenvolvimento

Assinaturas recorrentes

Sistema completo de cobranças recorrentes com múltiplas frequências

Split de pagamento

Divisão automática de pagamentos entre múltiplos recebedores

Checkout customizável

Personalização completa da página de checkout

Relatórios avançados

Dashboard com métricas e relatórios detalhados

​
Planejado para 2026

  • Q1 2026
    • Suporte para múltiplas moedas
    • Integração com mais gateways de pagamento
    • Sistema de afiliados
  • Q2 2026
    • API de reembolsos
    • Gestão de disputas (chargebacks)
    • Autenticação 3D Secure
  • Q3 2026
    • Marketplace multi-vendor
    • Sistema de carteira digital
    • Pagamentos internacionais
  • Q4 2026
    • Machine learning para detecção de fraude
    • Análise preditiva de vendas
    • Integração com ERPs

​
Breaking changes

Quando fazemos mudanças que quebram compatibilidade, seguimos este processo:
  1. Anúncio prévio: Comunicamos com 90 dias de antecedência
  2. Período de transição: Mantemos ambas as versões funcionando
  3. Guia de migração: Fornecemos documentação detalhada
  4. Suporte: Oferecemos suporte durante a migração

​
Histórico de breaking changes

Até o momento, não houve breaking changes na API v1.

​
Deprecações

​
Recursos descontinuados

Nenhum recurso foi descontinuado até o momento.

​
Avisos de deprecação

Quando um recurso for marcado para deprecação, ele continuará funcionando por pelo menos 12 meses antes de ser removido.

​
Como se manter atualizado

​
Notificações

Para receber notificações sobre mudanças na API:
  1. Email: Configure notificações no Dashboard
  2. Webhook: Subscribe ao evento api.version.updated
  3. RSS: Assine nosso feed RSS (em breve)

​
Versionamento da API

A URL da API inclui a versão: 
https://upay-sistema-api.onrender.com/api/v1/...
Quando lançarmos a v2, a v1 continuará disponível: 
https://upay-sistema-api.onrender.com/api/v1/...  # Versão antiga
https://upay-sistema-api.onrender.com/api/v2/...  # Nova versão

​
Versionamento dos SDKs

Os SDKs seguem versionamento semântico:
  • Major (1.x.x): Breaking changes
  • Minor (x.1.x): Novos recursos (compatível)
  • Patch (x.x.1): Correções de bugs
# JavaScript/TypeScript
npm install @upay/upay-js@latest

# Python
pip install upay-python --upgrade

# PHP
composer update upay/upay-php

​
Suporte a versões antigas

VersãoStatusSuporte atéNotas
v1.x✅ AtualIndefinidoVersão estável atual

​
Feedback

Sua opinião é importante! Compartilhe feedback sobre:
  • Novos recursos que você gostaria de ver
  • Problemas encontrados
  • Sugestões de melhoria
Canais de feedback:

​
Recursos adicionais

Códigos de erro

Referência completa de erros

Troubleshooting

Soluções para problemas comuns

Status da API

Verifique o status dos serviços