Integração via Deep Link

Você pode desenvolver seu aplicativo utilizando Java ou Kotlin, integrando diretamente com o SDK.

Sim. Disponibilizamos um aplicativo de exemplo no GitHub para que os desenvolvedores possam entender como funcionam as chamadas do SDK.

Não. O emulador tem como finalidade simular o sistema dos terminais e, por isso, deve ser instalado apenas em dispositivos como tablets, celular ou em emuladores Android (AVD) com as versões 7.1 ou 10 do sistema operacional.

A instalação do emulador em terminais debug não é permitida em nenhuma hipótese, pois pode comprometer o funcionamento do equipamento.

Sim. A Cielo Smart trabalha com o conceito de Order (pedido). O fluxo básico é:

1. Criar uma ordem com status draft

2. Adicionar os itens à ordem

3. Preparar a ordem para pagamento (place order)

4. Executar o checkout

Se o seu app trabalha com diversos produtos, é recomendável criar itens separados para facilitar os relatórios do lojista no Cielo Smart.

Não. A Cielo oferece um emulador que simula o ambiente do Smart em dispositivos Android. Com ele, você pode testar os métodos do SDK e fazer o debug da sua aplicação sem precisar do hardware físico. Clique aqui para aprender mais sobre o emulador

Sim. É necessário se cadastrar no Portal de desenvolvedores da Cielo para obter os tokens de acesso e testar sua aplicação.

Esse erro geralmente ocorre porque o aplicativo não possui as permissões necessárias para salvar a imagem no diretório:

Além disso, é importante lembrar que o emulador funciona corretamente apenas até a versão Android 10. Versões superiores podem apresentar incompatibilidades. Outro erro comum é o integrador salvar a imagem em um diretório e, no momento da impressão, informar um caminho (path) diferente no request. Isso faz com que o sistema não encontre a imagem. Para evitar esse problema, verifique se o caminho da imagem informado no request de impressão é exatamente o mesmo onde ela foi salva. E certifique-se de que não há aspas alteradas ou prefixos incorretos, como uri://, no path enviado.

Em integrações locais, todas as transações realizadas nos terminais devem retornar ao aplicativo de integração. A exceção ocorre quando o terminal é desligado antes do retorno da transação, com o app de pagamento da Cielo em foreground. Um cenário comum é o encerramento do app de integração pelo Android durante o fluxo de pagamento, devido ao gerenciamento de memória, especialmente quando o app está em segundo plano. Para evitar esse problema, é essencial que a chamada de pagamento seja realizada dentro de um serviço Android com notificação ativa (foreground service).

Esse erro ocorre quando o aplicativo não declara o metadata obrigatório para apps de integração na loja Cielo.
Para resolver o problema, é necessário adicionar no arquivo AndroidManifest.xml um metadata com o nome cs_integration_type e o valor uri, dentro da configuração da aplicação. Essa declaração deve ficar na mesma área onde são configuradas as informações globais do aplicativo, antes das definições de activities. Sem esse metadata, o mecanismo de integração da Cielo não consegue identificar o tipo de comunicação utilizado pelo aplicativo, o que impede o funcionamento correto da integração via Deep Link.