O que é o POSTMAN?

O Postman é um API Client que facilita aos desenvolvedores criar, compartilhar, testar e documentar APIs. Isso é feito, permitindo aos usuários criar e salvar solicitações HTTP e HTTPs simples e complexas, bem como ler suas respostas.

Por que utilizar o POSTMAN?

Além da praticidade de ter todos os exemplos e códigos de integração prontos, o POSTMAN é a ferramenta oficial de teste pelas equipes de desenvolvimento e suporte Cielo. Dessa maneira ao realizar integrações, caso você possua duvidas, será mais rápido e simples de confirmar o que pode estar ocorrendo com o seu código.

Outras vantagens do POSTMAN:

• Ferramenta gratuita
• Não é necessário instalar EXE - é uma extensão do Google Chrome
• Funciona em qualquer plataforma: Windows, MacOS e Linux
• Converte JSON em várias linguagens (EX: Python, PHP, RUBY)
• Sincronização entre diversos aplicativos
• Sincroniza código entre equipes (Versão paga)

Download e cadastro

Para utilizar o Postman, basta instalar o APP em seu computador. Isso pode ser realizado de duas maneiras:

• Instalando a versão desktop: Basta acessar , baixar a versão para sua plataforma e instalar o executável
• Instalando a extensão do Chrome: Basta acessar a Chrome Store e instalar a extensão do Postman

Instalando a extensão do Chrome

1.Acesse a Chrome Store, pesquise por POSTMAN em APPs

2.Na aba de Apps no seu Google Chrome acesse o ícone do Postman

3.Ao acessar o Postman pela primeira vez, o App ira requisitar um login. Essa etapa é opcional, mas sugerismos que uma conta seja criada, pois isso sincroniza suas configurações com a sua conta POSTMAN, ou seja, se for necessario realiza um login em outro computador, suas configurações já estarão prontas para serem usadas

4.Pronto, basta configurar suas Coleções e ambientes para iniciar os testes

Explicando Componentes do POSTMAN

Nesta área vamos explicar os diferentes componentes do Postman e suas funções. Depois dessa introdução, as próximas partes deste tutorial vão focar na configurações e usos para teste das APIs

A - Environment (Ambiente): Ambiente para onde serão direcionadas as requisições. Nesta área que serão definidos dados de:

Sugerimos que sejam criados dois ambientes, um com dados de produção e outro para Sandbox, cada um com suas respectivas credenciais e URLs. Desta maneira se torna muito mais simples realizar testes com o mesmo contrato para ambos os ambientes.

B - Header Aqui existem o MerchantId/MerchantKey, que por padrão usam os mesmos dados registrados em Environment.

C - Body: É o conteúdo das Requisições. Aqui é onde você pode alterar ou criar exemplos para a API e validar o conteúdo do seu POST/GET/PUT

D - Collection (Coleções) : Local que contém todas os exemplos e códigos que podem ser utilizados na API. Aqui existem as criações de transações, consultas e outras funcionalidades que existem nas APIs Cielo. O número de coleções é ilimitado, ou seja, você pode criar várias coleções para se adequar ao seu estilo de uso do Postman.

Criando Environment Cielo

O primeiro passo na utilização do postman é a criação do ambiente (environment) da API. Essa configuração vai definir quais credenciais e endpoints serão utilizados como padrão, assim evitando a necessidade de realizar configurações a cada teste.

Realizando a criação do ambiente:

1 - No canto superior direito, clique na engrenagem e selecione “Manage environment”.

2 - Na tela de gerenciamento, basta preencher as configurações de acordo com a tela abaixo:

3 - Pronto, agora os endereços e credenciais para teste já estão cadastrada. Sugerimos que você crie um ambiente para Produção e um para Sandbox assim,

Na API Cielo Ecommerce as credenciais, MerchantID e MerchantKey, devem coincindir com o ambiente das URLs, ou seja, Credenciais de sandbox funcionam apenas com URLs de Sandbox No Checkout Cielo não há MerchantKey nem diferença entre Sandbox e produção. Para realizar testes, deve ser ativado o “Modo de Teste”. Para mais informações sobre o Modo de teste, acesso o Tutorial do backoffice

Importando uma Collection

A Cielo dispõe de coleções padrões para suas APIs. Você pode importa-las diretamente para o seu POSTMAN e ter todos os exemplos prontos para utilização instantaneamente, sem a necessidade de copia-los diretamente do manual.

Para realizar a importação basta:

1. Acessar a área deste tutorial onde o link da Coleção está disponível e copiá-lo

*IMPORTANTE: para que a sua coleção sempre esteja atualizada, sugerimos que sempre busque a ultima versão da coleção no manual. O link NÃO ATUALIZA A COLEÇÃO IMPORTADA AUTOMATICAMENTE

1. Com o Postman aberto, use o botão IMPORT, e selecione a opção “IMPORT FROM LINK”.

1. Pronto, sua coleção Cielo já está disponível. Basta selecionar Environment e a requisição. Ao clicar em SEND, o Postman vai executar a comunicação com a Cielo.

Collections e Environments Cielo

Abaixo, listamos as collections e os Environments Cielo. Use-as em seu Postman para realizar testes e integrações.

Api Cielo Ecommerce

• Collection -

Checkout Cielo

• Collection -

Realizando uma requisição

Com a sua Collection e Environmet configurados, realizar uma transação junto a Cielo é extremamente facil:

1. Seleciona qual requisição você deseja usar.
2. Verifique que o Environment correto está selecionado
3. Clique em SEND.
4. Na parte inferior você verá 2 informações: a. O Body do Response - Aqui é onde ficam listadas os dados retornados de suas transações b. O HTTP Status - Aqui você verifica se a sua requisição funcionou.

OBS:Se você não receber um response verifique o status HTTP.

Gerando exemplos em outras linguagens.

O POSTMAN permite criar exemplos de outras linguagens baseadas nas requisições JSON dos produtos Cielo.

Abaixo demonstramos como gerar um exemplo em Python

1 - Acesse a requisição que você deseja converter e clique em CODE no canto direito da tela.

OBS:Caso esse link não exista em sua tela, clique em Params

2 - Selecione a Linguagem que deseje converter, neste caso, Python.

3 - Pronto. O exemplo Json está convertido para Python

Collections e Environments Cielo

Abaixo, listamos as collections e os Environments Cielo. Use-as em seu Postman para realizar testes e integrações.

Api Cielo Ecommerce

Collection

• Link de importação

https://www.postman.com/collections/7313fe78130211f5f009

Environment

Faça download dos arquivos abaixo e subistitua os MerchantIDs e MerchantKeys pelos os da sua Loja

Environment Produção e Sandbox

Checkout Cielo

Collection

• Link de importação

https://www.getpostman.com/collections/97969ec643738aac42f4

Environment

Faça download do arquivo abaixo e subistitua o MerchantID pelo o da sua Loja.

Environment Produção