Pular para o conteúdo principal

Java

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

Atenção!

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


Pré Requisitos

  • Java >=7.0

Testado com

  • Java 7.0, 8.0, 13.0 e 20.0

Instalação via gradle

implementation 'br.com.efipay.efisdk:sdk-java-apis-efi:1.0.3'

Instalação via maven

<dependency>
<groupId>br.com.efipay.efisdk</groupId>
<artifactId>sdk-java-apis-efi</artifactId>
<version>1.0.3</version>
</dependency>

Instalando via Git a Sdk de exemplos

Nossa SDK de examplos está disponível em nosso repositório no Github da Efí.

$ git clone https://github.com/efipay/sdk-java-examples-apis-efi.git

Começando

Requer o módulo e os pacotes:

import br.com.efi.efisdk.EfiPay;
import br.com.efi.efisdk.exceptions.EfiPayException;

Embora as respostas dos serviços da Web estejam no formato json, a SDK converterá qualquer resposta do servidor para um JSONObject ou um Map <String, Object>. O código deve estar dentro de um try-catch e as exceções podem ser tratadas da seguinte forma:

try {
/* code */
} catch(EfiPayException e) {
/* EfiPay'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:

JSONObject options = new JSONObject();
options.put("client_id", "client_id");
options.put("client_secret", "client_secret");
options.put("certificate", "./certs/developmentCertificate.p12");
options.put("sandbox", true);

EfiPay efi = new EfiPay(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:

JSONObject options = new JSONObject();
options.put("client_id", "client_id");
options.put("client_secret", "client_secret");
options.put("certificate", "./certs/productionCertificate.p12");
options.put("sandbox", false);

EfiPay efi = new EfiPay(options);

Executando testes

Para executar o conjunto de testes com coverage:

mvn clean test jacoco:report

Executando exemplos

Para executar alguns exemplos existentes siga as etapas descritas em nosso Github da Efí.