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
POST	/v1/oauth/token	Token de sistema
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
GET	/v1/services	Garantias, seguros e proteções
GET	/v1/imei/validate	Resolução de IMEI para produto
POST	/v1/sales/search	Status de faturamento e cancelamento

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.