Delphi
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.
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:
- Efí Pay
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.
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).
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:
- Classe Super Object: https://github.com/onryldz/x-superobject
- Classe ZXingQRCode: https://github.com/foxitsoftware/DelphiZXingQRCode/tree/master/Source
- Classe Chilkat: https://www.chilkatsoft.com/delphiDll.asp
Essas classes externas já se encontram dentro de nosso projeto na pasta "Utils/External".