Java
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
e20.0
Instalação via gradle
- Efí Pay
implementation 'br.com.efipay.efisdk:sdk-java-apis-efi:1.0.3'
Instalação via maven
- Efí Pay
<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í.
- Efí Pay
$ git clone https://github.com/efipay/sdk-java-examples-apis-efi.git
Começando
Requer o módulo e os pacotes:
- Efí Pay
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:
- Efí Pay
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
- Map
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);
Map<String, Object> options = new HashMap<String, Object>();
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
- Map
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);
Map<String, Object> options = new HashMap<String, Object>();
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í.