You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _i18n/pt/_posts/cielo-lio/2017-01-01-cielo-lio.md
+98-22Lines changed: 98 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,7 +98,7 @@ Datas importantes:
98
98
-**29/08:** Fim do suporte a apps não adaptados (sem Deeplink ou SDK < 2.1.0).
99
99
-**15/10:** Corte definitivo — apps não adaptados poderão deixar de funcionar.
100
100
101
-
><asideclass="warning">Se o seu app não for adaptado, o terminal poderá ficar indisponível e não será possível publicar ou atualizar versões antigos. A partir de outubro todas as trocas de terminais e novas contratações serão feitas exclusivamente com terminais Cielo Smart.</aside>
101
+
<asideclass="warning">Se o seu app não for adaptado, o terminal poderá ficar indisponível e não será possível publicar ou atualizar versões antigos. A partir de outubro todas as trocas de terminais e novas contratações serão feitas exclusivamente com terminais Cielo Smart.</aside>
102
102
103
103
Para migrar:
104
104
- Utilize a integração via Deeplink.
@@ -118,7 +118,7 @@ Com a Cielo Smart, você aproveita:
118
118
-**Mais robustez e velocidade**: Melhorias significativas no desempenho e no tempo de aprovação de pagamentos.
119
119
-**Smart first**: Todas as novas funcionalidades e atualizações serão lançadas exclusivamente para a Cielo Smart.
120
120
121
-
><asideclass="warning">O uso de WebView não é permitido na nova Cielo Smart.</aside>
121
+
<asideclass="warning">O uso de WebView não é permitido na nova Cielo Smart.</aside>
122
122
123
123
124
124
**Conheça os benefícios da integração via Deeplink**
@@ -139,48 +139,124 @@ Se você já utiliza a integração via Deeplink, veja abaixo como se adaptar ao
139
139
140
140
2. Certifique-se de que seu app está em conformidade com os requisitos do Android 10, incluindo permissões, notificações, criação de intents, entre outros.
141
141
142
-
><asideclass="warning">Informamos que o SDK foi descontinuado. A partir de agora, serão disponibilizados apenas patches com correções pontuais. Caso ainda esteja utilizando o SDK da Cielo, é essencial garantir o uso da versão 2.1.0 ou superior. </aside>
142
+
<asideclass="warning">Informamos que o SDK foi descontinuado. A partir de agora, serão disponibilizados apenas patches com correções pontuais. Caso ainda esteja utilizando o SDK da Cielo, é essencial garantir o uso da versão 2.1.0 ou superior. </aside>
143
143
144
144
Recomendamos fortemente a migração para a integração via Deeplink, que oferece uma solução mais leve, flexível e segura para o seu app. Ao eliminar a dependência de SDKs, a integração se torna mais rápida, personalizável e compatível com diferentes dispositivos e versões. Além disso, reduz conflitos com bibliotecas externas, facilita a manutenção e melhora o desempenho, ao evitar a sobrecarga de código de terceiros.
145
145
146
146
Para saber mais, acesse a [documentação de integração via DeepLink](https://developercielo.github.io/manual/cielo-lio#credenciais).
147
147
148
-
# Visão Geral da Plataforma
148
+
# VISÃO GERAL TÉCNICA
149
149
150
-
## Cielo LIO
150
+
## Funcionalidades
151
151
152
-
É uma plataforma aberta que fornece controle e gestão de negócios indo além de um sistema de pagamentos tradicional. Essa solução suporta aplicativos desenvolvidos para sistema Android, possibilitando que desenvolvedores parceiros possam criar aplicativos especializados para diversos segmentos e qualquer porte de cliente.
152
+
A Cielo Smart oferece funcionalidades exclusivas que agregam valor à experiência do cliente. Entre os principais destaques, estão:
153
153
154
-
### L300 - Positivo
154
+
-**Impressora térmica**: Permite a impressão da 1ª e 2ª via do comprovante após a finalização do pagamento. Além disso, aplicações parceiras podem utilizar os recursos da impressora para gerar documentos relevantes ao negócio do cliente.
155
+
156
+
<asideclass="warning"><spanstyle="color: green;">A impressora térmica do terminal LIO ON deve ser utilizada com bobinas que atendam às seguintes especificações: papel azul com gramatura de 48 g/m², comprimento de 12 metros, diâmetro máximo de 30 milímetros e largura de 57 milímetros.</span></aside>
157
+
158
+
-**Tecnologia NFC**: Compatível com pagamentos por aproximação (*contactless*), oferecendo mais agilidade e praticidade nas transações.
159
+
-**Cielo Store**: Loja de aplicativos integrada com mais de 50 apps voltados para gestão de vendas, estoque, equipe, entre outros.
160
+
-**Multiconexão (Wi-Fi + 4G)**: Garante conectividade em diferentes ambientes, permitindo mobilidade e vendas em qualquer ponto da loja.
161
+
-**Frente de caixa móvel**: Pode ser usada como um ponto de venda portátil, ideal para atendimento em movimento.
162
+
-**Leitor de código de barras**: Facilita o cadastro e a venda de produtos com leitura rápida e precisa.
163
+
-**Calculadora integrada**: Para facilitar o cálculo de valores antes de finalizar a venda.
164
+
-**Múltiplas formas de pagamento**: Inclui débito, crédito (à vista e parcelado), voucher, Pix, QR Code e mais de 80 bandeiras de cartões.
165
+
-**Integração com sistemas de automação comercial**: Via SDK e APIs REST, permitindo que desenvolvedores criem soluções personalizadas para o terminal.
166
+
**NFC**: tecnologia presente permitindo o pagamento utilizando cartões com tecnologia contactless
167
+
168
+
<asideclass="warning"><spanstyle="color: green;">A Cielo LIO é compatível com periféricos de hardware como impressoras Bluetooth (parceiros utilizam impressoras das marcas Zebra, Datex e Leopardo) e leitores RFID. A conexão e o pareamento desses dispositivos são de responsabilidade do aplicativo do parceiro.</span></aside>
169
+
170
+
## Arquitetura
171
+
172
+
A plataforma Cielo LIO é baseada em Android que consiste em:
173
+
174
+
- Uma loja de aplicativos [Cielo Store](https://developercielo.github.io/manual/cielo-lio#cielo-store) para os desenvolvedores publicarem seus aplicativos e os disponibilizarem para os estabelecimentos comerciais (lojistas).
175
+
- Uma plataforma com arquitetura em nuvem e APIs REST que permite a integração com sistemas de automação comercial de parceiros.
176
+
Acesse a [documentação da integração remota](https://developercielo.github.io/manual/cielo-lio#integra%C3%A7%C3%A3o-remota)
177
+
- Chamadas via intent, de forma que aplicativos de parceiros possam se integrar com as funcionalidades de pagamento da Cielo LIO.
178
+
Acesse a [documentação da integração via Deeplink](https://developercielo.github.io/manual/cielo-lio#integra%C3%A7%C3%A3o-via-deeplink7)
179
+
180
+
<asideclass="warning"><spanstyle="color: green;">A Cielo Smart já vem configurada com um SIM Card. A operadora do SIM Card é definida de acordo com o endereço de cadastro do estabelecimento comercial. A Cielo envia o SIM Card da melhor operadora de acordo com o endereço de cadastro do terminal solicitado. Esse SIM Card permite a conexão com a tecnologia 3G/4G da Cielo Smart e possui um pacote de dados ilimitado. </span></aside>
181
+
182
+
## Terminais e características da Cielo Smart
183
+
184
+
Atualmente, dois terminais da Cielo Smart estão disponíveis: Cielo LIO (L300) e DX 8000.
| Sensores | Acelerômetro, Proximidade e Luminosidade | Acelerômetro, Prox. e Lumin | Acelerômetro, Prox. e Lumin |
219
+
| Saída de áudio | Audio Jack 3.5mm | Audio Jack 3.5mm | - |
220
+
| Peso | 507 g | 417 g | 450 g |
221
+
| Altura | 46mm | 70mm | 198mm |
222
+
| Largura | 81mm | 82mm | 83mm |
223
+
| Comprimento | 228mm | 205mm | 62.5mm |
224
+
225
+
## Boas práticas para desenvolvedores
163
226
164
-
A LIO ON possui algumas funcionalidades exclusivas como por exemplo:
227
+
Aqui, estão reunidas orientações essenciais para garantir que sua integração aconteça de forma eficiente, segura e alinhada à experiência esperada na Cielo Smart.
165
228
166
-
**Impressora térmica**: o cliente poderá ter a 1ª e 2ª via impressa após o pagamento realizado. Além disso, as aplicações parceiras poderão utilizar os métodos disponíveis da impressora para imprimir dados importantes ou necessários para o negócio do cliente.
- Proteja dados sensíveis de clientes e funcionários.
232
+
- Nunca exponha tokens de autenticação ou senhas.
170
233
171
-
**NFC**: tecnologia presente permitindo o pagamento utilizando cartões com tecnologia contactless
234
+
**Rate limiting e performance**
172
235
173
-
## Arquitetura
236
+
- Escalone as solicitações da Automação Comercial ou PDV para evitar picos de tráfego.
237
+
- Utilize cache para dados grandes ou para armazenar valores especializados.
238
+
- Evite chamadas POST em multi-threading para prevenir deadlocks.
239
+
- Minimize o uso de dados, considerando conexões móveis limitadas.
240
+
- Otimize as operações visando o baixo consumo de bateria.
174
241
175
-
### Sobre
242
+
**Qualidade de código**
176
243
177
-
A plataforma Cielo LIO é baseada em Android que consiste em:
244
+
- O aplicativo deve seguir as boas práticas de desenvolvimento Java e Android, conforme as diretrizes oficiais para desenvolvedores da plataforma Android.
245
+
- Aplique os princípios Design Orientado a Objetos (S.O.L.I.D.) e diretrizes de estilo Java.
246
+
- Entenda e configure corretamente compileSdkVersion, targetSdkVersion e minSdkVersion.
247
+
- Aproveite os botões nativos do Android, como os botões “Voltar” e “Início”.
178
248
179
-
- Uma loja de aplicativos [Cielo Store](https://developercielo.github.io/manual/cielo-lio#cielo-store) para os desenvolvedores publicarem seus aplicativos e os disponibilizarem para os estabelecimentos comerciais (lojistas).
180
-
- Uma plataforma com arquitetura em nuvem e APIs REST que permite a integração com sistemas de automação comercial de parceiros.
181
-
Acesse Documentação da [Integração Remota](https://developercielo.github.io/manual/cielo-lio#integra%C3%A7%C3%A3o-remota)
182
-
- Chamadas via intenet, de forma que aplicativos de parceiros possam se integrar com as funcionalidades de pagamento da Cielo LIO.
183
-
Acesse Documentação da [Integração via Deeplink](https://developercielo.github.io/manual/cielo-lio#integra%C3%A7%C3%A3o-via-deeplink7)
249
+
**Usabilidade e experiência do usuário**
250
+
251
+
- Utilize ícones com dimensionamento padrão Android. Siga [esta guideline](https://m3.material.io/styles/icons/overview)
252
+
- Implemente ferramentas de monitoramento de falhas em seus produtos Android com o objetivo de manter a consciência operacional do produto. Sugerimos a utilização do Crashlytics [LINK: Firebase Crashlytics ]
253
+
- Colete métricas de uso do aplicativo para melhorar o produto.
254
+
- Priorize clareza e acessibilidade no design do seu aplicativo: contraste, fontes legíveis e texto grande.
255
+
- Esclareça os termos de uso da aplicação e ofereça suporte adequado ao usuário.
256
+
- Seu aplicativo será usado em condições de trabalho de ritmo rápido em ambientes dinâmicos, portanto, construa fluxos de fácil com o mínimo de passos possível.
257
+
- Ao adaptar um aplicativo desenvolvido para outra plataforma, mantenha apenas os recursos e botões relevantes para o usuário da Cielo Smart.
258
+
259
+
<asideclass="warning"><spanstyle="color: green;">Recomenda-se o uso do Material Design [LINK: Material Design 3 - Google's latest open source design system] no desenvolvimento de aplicações para a Cielo Smart, promovendo a adoção de boas práticas de design e melhorando a experiência em dispositivos móveis. </span></aside>
184
260
185
261
### Modelos de integração com a plataforma Cielo LIO
0 commit comments