Retail Financing API v1.0

Jornada completa de financiamento de smartphones no varejo de telecom.

Endpoints por direção

Partner PDV API — implementada pelo PDV Parceiro

Método	Path	Operação	Frequência
POST	/v1/oauth/token	Token de sistema	Renovação por expiração
POST	/v1/sellers/session	Sessão do vendedor e contexto de loja	Tempo real
GET	/v1/employees	Funcionários ativos	1x/dia
GET	/v1/stores	Lojas cadastradas	1x/dia
GET	/v1/plans	Planos de operadora da loja	1x/dia
GET	/v1/products	Catálogo de smartphones elegíveis ao plano (sem estoque)	1x/dia
GET	/v1/products/barcode	Produto por código de barras, com estoque atual	Tempo real
GET	/v1/services	Garantias, seguros e proteções	1x/dia
GET	/v1/stock	Estoque atual de um SKU	Tempo real
GET	/v1/imei/validate	Resolução de IMEI para produto	Tempo real
POST	/v1/sales/search	Status de faturamento e cancelamento	Tempo real

A Levfone sincroniza os endpoints marcados 1x/dia para o próprio banco — eles não são chamados por transação, o que mantém a jornada de venda rápida e reduz a carga no sistema do PDV Parceiro. GET /products por isso não retorna stock: estoque muda o dia inteiro e é sempre consultado em tempo real, via GET /products/barcode (ao ler o código de barras) ou GET /stock (quando o SKU já é conhecido pelo catálogo sincronizado).

Referência completa →

Sales Authorization API — implementada pela Levfone

Método	Path	Operação
POST	/v1/oauth/token	Token de sistema
POST	/v1/sales/authorize	Autorizar venda financiada
POST	/v1/sales/{id}/confirm	Confirmar faturamento
POST	/v1/sales/{id}/cancel	Notificar cancelamento

Referência completa →

O endpoint que importa

POST /sales/authorize é o ponto de controle de toda a integração.

O PDV Parceiro não pode faturar antes de receber authorized: true. Esta é a única trava contratual dura. Todo o resto do fluxo é reversível; este passo não é.

Ele é uma chamada única e autocontida: não há passo prévio obrigatório, e a Levfone não consulta o PDV durante o processamento. O PDV pede e recebe ou a autorização ou o motivo da recusa, em uma ida e volta.

Ciclo de vida da autorização

O authorizationId expira em 15 minutos, informado em expiresAt. Sem TTL, uma autorização emitida e nunca usada prenderia crédito indefinidamente.

Consulta de IMEI não é decisão

GET /imei/validate resolve um IMEI para SKU, marca, modelo e memória, e informa disponibilidade. Ele não reserva, não garante e não decide.

Serve à jornada da Levfone, antes de o carrinho existir. A decisão sobre a venda é sempre e apenas POST /sales/authorize.

Glossário

Termo	Definição
PDV Parceiro	Sistema de ponto de venda do varejista. Nome genérico usado em toda a documentação.
Proposta	Solicitação de crédito analisada e aprovada pela Levfone, com valor e prazo definidos.
Autorização	Confirmação de que a venda montada no PDV corresponde à proposta aprovada.
Crediário	Contrato de financiamento formalizado após o faturamento.
NF-e	Nota Fiscal eletrônica emitida pelo PDV Parceiro.
Chave de acesso	Identificador de 44 dígitos que localiza a NF-e na Receita Federal.
IMEI	Identificador único de 15 dígitos do aparelho.
TTL	Prazo de validade da autorização antes de expirar.