Postman

Download

Arquivo	Conteúdo
levfone-connect.postman_collection.json	Coleção completa, ambas as APIs
sandbox.postman_environment.json	Ambiente de sandbox

Configuração

1. Importe a coleção e o environment.
2. Selecione o environment Levfone Connect — Sandbox.
3. Preencha clientId e clientSecret como variáveis de tipo secret.
4. Execute Auth › Get Token. O access_token é salvo automaticamente.

Nunca compartilhe o environment preenchido

Environment exportado com clientSecret preenchido é credencial em texto claro em um arquivo JSON. Use variáveis de tipo secret e exporte sempre com os valores em branco.

Automação embutida

A coleção já inclui scripts que resolvem o trabalho repetitivo:

Pre-request, no nível da coleção — gera X-Request-Id e Idempotency-Key novos a cada envio, e mantém o X-Correlation-Id estável durante a jornada:

pm.request.headers.upsert({ key: 'X-Request-Id', value: uuid() });
pm.request.headers.upsert({ key: 'Idempotency-Key', value: uuid() });

if (!pm.environment.get('correlationId')) {
  pm.environment.set('correlationId', uuid());
}
pm.request.headers.upsert({
  key: 'X-Correlation-Id',
  value: pm.environment.get('correlationId'),
});

Test, em Get Token — persiste o token e o prazo de validade:

const body = pm.response.json();
pm.environment.set('accessToken', body.access_token);
pm.environment.set('tokenExpiresAt', Date.now() + body.expires_in * 1000);
pm.test('Token emitido', () => pm.response.to.have.status(200));

Test, em Authorize Sale — captura o authorizationId para os passos seguintes e trata a recusa como fluxo normal:

const body = pm.response.json();
pm.test('HTTP 200', () => pm.response.to.have.status(200));

if (body.data && body.data.authorized) {
  pm.environment.set('authorizationId', body.data.authorizationId);
} else {
  console.log('Recusa:', body.data && body.data.declineReason);
}

Cenários incluídos

Pasta	Cenário
01 Auth	Token de sistema e sessão de vendedor
02 Catalog	Planos, produtos, código de barras, serviços
03 Inventory	Resolução de IMEI
04 Authorization	Venda aprovada, recusada, expirada e duplicada
05 Fulfillment	Confirmação de faturamento
06 Cancellation	Cancelamento e troca
07 Errors	Reprodução dos principais códigos de erro