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>

Instalação 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í.

Última atualização em