Android
Saiba como instalar e configurar nossa SDK de Android para utilizar as APIs da Efí
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;
- Android
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
:
- Homologação
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:
- 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.
- API Pix
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());