---
updatedAt: 2026-09-30T14:50:14.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/cielo-smart/llms.txt
---

# Política de integração: Camada de abstração obrigatória 

Esta política se aplica aos terminais Cielo Smart e LIO

Conheça as interfaces oficiais da Cielo e a nossa política de integração. Dessa forma, você entende o que é permitido e o que é proibido, garantindo uma integração segura com nossas soluções.

# O que é proibido?

É proibido acessar diretamente o hardware do terminal LIO usando o SDK ou as bibliotecas do fabricante do equipamento. Essa restrição vale para todas as funcionalidades do terminal, incluindo:

* Pagamento;
* Cancelamento;
* Consulta de pedidos;
* Impressão;
* Leitura/escrita de cartão Mifare (*cashless*)

# O que é obrigatório?&#x20;

Toda integração deve passar pela camada de abstração oferecida pela Cielo:

* **Pagamentos, pedidos e impressão** — via Deep Link` lio://`, fornecido pelo componente UriApp, com as actions: payment, payment-reversal, order, orders, print, products, enabledproducts, establishments, terminalinfo.
* **Cartão Mifare / cashless&#x20;**— via o app dedicado `cielo.lio.cashless`, acionado por Intent (não por deep link), com suas próprias actions e códigos de retorno.

# Por que essa política existe? &#x20;

O fabricante do terminal pode mudar, e a Cielo já trata internamente as diferenças entre eles dentro da sua camada de abstração. O integrador não precisa saber qual fabricante está por trás do terminal.

Ao chamar o SDK do fabricante diretamente, o integrador perde essa proteção, já que a integração passa a depender de um hardware específico e pode quebrar em outro modelo de terminal. Além disso, as regras de negócio e segurança aplicadas pela camada da Cielo (validações, controle de sessão, formato de callback, tratamento de erro) deixam de ser respeitadas, de forma que a integração deixa de ser suportada pelo time de integração da Cielo.

<Callout icon="⚠️" theme="warn">
  ### Resumo da Política de integração

  - Não é permitido usar SDK/lib do fabricante do hardware para qualquer finalidade (pagamento, impressão, cashless/Mifare);

  - É obrigatório consumir a camada de abstração da Cielo, Deep Link `lio://` para pagamento, pedidos e impressão, e a Intent `cielo.lio.cashless` para Mifare.

  - Qualquer necessidade não coberta por essas duas interfaces deve ser registrada como demanda junto à Cielo, e não resolvida com acesso direto ao fabricante.
</Callout>