Pular para o conteúdo principal

Changelog

Formato baseado em Keep a Changelog.

Mudanças compatíveis entram na v1 sem aviso prévio — seu cliente deve ignorar campos desconhecidos. Mudanças incompatíveis geram nova versão de path, com no mínimo 12 meses de convivência.

[1.0.0] — Não publicado​

Versão inicial da Retail Financing API.

Adicionado​

Partner PDV API — implementada pelo PDV Parceiro:

  • POST /v1/oauth/token — autenticação de sistema, OAuth 2.0 client credentials
  • POST /v1/sellers/session — sessão do vendedor e contexto de loja
  • GET /v1/plans — planos de operadora da loja
  • GET /v1/products — catálogo de smartphones elegíveis ao plano
  • GET /v1/products/barcode — produto por código de barras, smartphones e acessórios
  • GET /v1/services — garantias, seguros e proteções por SKU
  • GET /v1/imei/validate — resolução de IMEI para produto
  • POST /v1/sales/search — status de faturamento e cancelamento

Sales Authorization API — implementada pela Levfone:

  • POST /v1/oauth/token — autenticação de sistema
  • POST /v1/sales/authorize — autorização de venda financiada
  • POST /v1/sales/{id}/confirm — confirmação de faturamento
  • POST /v1/sales/{id}/cancel — notificação de cancelamento

Plataforma:

  • Envelope de resposta padronizado com error e requestId
  • Objeto Money com inteiro em centavos
  • Idempotência via Idempotency-Key, retenção de 24 h
  • TTL de 15 minutos na autorização
  • Catálogo de erros com códigos semânticos e alias numérico LFxxxx
  • Rastreabilidade via X-Request-Id e X-Correlation-Id

Roadmap​

v1.1​

  • Webhooks de mudança de status de contrato, para o PDV Parceiro
  • Reserva de estoque opcional, se o volume justificar (ver ADR-007)

v2.0​

  • OIDC Authorization Code + PKCE hospedado pelo PDV Parceiro, eliminando o encaminhamento de credencial do vendedor (ver ADR-001)
  • mTLS obrigatório em produção
Última atualização em