Perguntas frequentes

O que fazer se o token expirar?

Obtenha um novo token JWT repetindo o processo de autenticação descrito em Fluxo de Autenticação de Credenciais do Cliente .

Como realizar testes sem impactar o ambiente de produção?

Use a URL de homologação fornecida em Acesso aos endpoints da Cielo.

Posso utilizar o mesmo token para múltiplas requisições?

Sim, desde que ele ainda esteja válido (duração: 5 minutos). Caso expire, gere um novo token.

Ao integrar na API de Cancelamento, ainda posso cancelar por outros canais?

Sim. A API é mais uma opção de canal para solicitar cancelamento de vendas. Os demais canais continuarão disponíveis para solicitação de cancelamento (POS, TEF, e-commerce, Central de Atendimento, Site/APP).

Atente-se para envio de cancelamentos parciais por 2 canais diferentes. Havendo saldo disponível na transação, as duas solicitações podem ser efetivadas.

É possível enviar cancelamentos parciais pela API de Cancelamento?

Sim. É possível enviar um ou mais cancelamentos parciais de uma mesma transação pela API. As solicitações serão efetivadas respeitando o saldo disponível na transação e as regras de cancelamento de cada Bandeira.

Débito Mastercard só permite um cancelamento parcial por transação. Em caso de 2ª solicitação de cancelamento, ela será rejeitada por regra da bandeira.

Qual o prazo de efetivação de cancelamento?

Cancelamentos solicitados no mesmo dia da venda terão o status final disponível a partir das 8h da manhã de D2.

Cancelamentos solicitados após a data da venda, caso solicitados até as 18h30 terão seu status final disponível a partir das 8h da manhã de D1.

Qual a diferença entre API de Cancelamento e a API E-Commerce?

API Única de Cancelamento e a API E-commerce são soluções diferentes com propósitos e integrações diferentes.

A API E-commerce é uma solução de captura que também permite solicitação de cancelamentos de vendas e-commerce. Só é permitido cancelar vendas e-commerce do EC integrado

A API Única de cancelamento é uma solução cujo objetivo é permitir clientes centralizarem cancelamentos de diversas soluções de captura oferecidas pelas Cielo (TEF, POS, E-commerce, LIO). A integração é por Raiz de CNPJ e é possível cancelar vendas de todos os ECs que compõem essa Raiz.