Pular para o conteúdo principal

Delphi

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

Atenção!

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


Pré Requisitos

  • Aplicações que usarão a SDK devem ser compiladas na plataforma Windows 32-bit.
  • Apenas aplicações Desktop.
Observações

Originalmente, as SDK´s de Delphi foram executados e desenvolvidas no Delphi Rio Community Edition 10.3.

Lembrando que esta SDK, foi desenvolvida para ser retrocompatível, ou seja, compatível tanto com as versões mais recentes do Delphi quanto as versões mais antigas, no entanto, a Efí somente irá dar suporte à aplicações desktop win-32 desenvolvidas no Delphi Rio Community Edition 10.3.


Download da SDK Delphi

Todo o código de demonstração está disponível em nosso repositório no GitHub da Efí. Após concluir o download descompacte o arquivo em alguma pasta de sua preferência e a SDK estará pronta para uso.


Execução Demo

Após realizar o download e extrair os arquivos, abra a pasta Api Compilada e lá terá o arquivo a ser executado:

ApisEFI.exe

Usando a SDK da Efí

Para utilização da SDK, basta adicionar as classes ao seu projeto e chama-las conforme suas necessidades.

DLL's

Dependendo do Endpoint a ser utilizado, será necessário adicionar as DLL´s (Disponíveis em: \Api Compilada) e classes externas (Disponíveis em: \Code\External) ao seu projeto também.


A API sempre irá retornar uma string JSON, portanto, qualquer tipo de argumento passado para as funções da SDK devem ser do tipo String.

Antes de consumir qualquer endpoint da API, é necessário autenticar na API usando a SDK. Para isso, você irá fornecer os seus dados:

  • Client_Id;
  • Client_Secret;
  • Ambiente (sandbox ou produção);
  • Certificado em modo .p12 (Apenas a API Pix).
Observação

O ambiente "sandbox" (ou "homologação") é o local que a Efí disponibiliza ao integrador para testar sua integração.

Já o ambiente de "produção" é o ambiente "real" que sua aplicação deverá estar para gerar cobranças (ou "transações") "reais".

LEMBRE-SE: caso você ativar o "sandbox", utilize _Client_Id_ e _Client_Secret_ de homologação, assim como, se estiver usando ambiente de produção, use _Client_Id_ e _Client_Secret_ do referido ambiente.

O ambiente "sandbox" (ou "homologação") é o local que a Efí disponibiliza ao integrador para testar sua integração.


Dependências externas do Projeto

Para desenvolvimento da SDK, foi utilizada algumas classes externas disponíveis em:


Observação

Essas classes externas já se encontram dentro de nosso projeto na pasta "Utils/External".