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?

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 — 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?

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.

⚠️

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.


Did this page help you?