Pular para o conteúdo principal

Android

Saiba como instalar e configurar nossa SDK de Android para utilizar as APIs da Efí

Atenção!

As requisições feitas às APIs da Efí, utilizando a sdk de Android precisam do certificado gerado em sua conta Efí no formato .pem.

Confira aqui o passo a passo para converter seu certificado P12 para o formato PEM.


Pré-requisitos

Android 7.0+


Instalação via gradle

implementation 'br.com.gerencianet.mobile:gn-api-sdk-android:1.0.0'

Nossa SDK também está disponível em nosso repositório no Github.


Testado com

Android 7.0 e 11.0


Uso Básico

Requer o módulo e os pacotes:

import br.com.gerencianet.mobile.Gerencianet;
try {
/* code */
} catch(GerencianetException e) {
/* Gerencianet's api errors will come here */
} catch(Exception ex) {
/* Other errors will come here */
}

Para ambiente de homologação

Instanciar o módulo passando seu Client_Id, Client_Secret e sandbox sendo igual a true:

HashMap<String, Object> options = new HashMap<String Object>();
options.put("client_id", "client_id ");
options.put("client_secret", "client_secret");
options.put("sandbox", true);
Gerencianet gn = new Gerencianet(options);

Para ambiente de produção

Para alterar o ambiente para produção, basta definir o terceiro sandbox como false, e seu Client_Id e Client_Secret de produção:

HashMap<String, Object> options = new HashMap<String Object>();
options.put("client_id", "client_id ");
options.put("client_secret", "client_secret");
options.put("sandbox", false);
Gerencianet gn = new Gerencianet(options);

API PIX

Para utilizar a API PIX, é necessário informar o caminho do certificado, no formato .12 dentro da pasta assets e passar como parâmetro o assets do contexto.

HashMap<String, Object> options = new HashMap<String Object>();
options.put("client_id", "client_id ");
options.put("client_secret", "client_secret");
options.put("pix_cert", "./cert.p12");
options.put("sandbox", false);
Gerencianet gn = new Gerencianet(options, context.getAssets());