Per iniziare, dovrai scegliere una libreria SDK in base al linguaggio di programmazione che usi.
Se ancora non è disponibile nel linguaggio che desideri, richiedi al nostro supporto tecnico informazioni.
Scarica il Software Development Kit nel linguaggio di tuo interesse:
Scarica il Software Development Kit e scompattalo nella cartella FidApi. Se
FlourishLib non è presente nell'archivio, dovrai scaricarlo dal
sito ufficiale.
<?php
// Creiamo un sistema capace di caricare automaticamente le classi che inizializzeremo
function __autoload($class_name)
{
// Personalizza questa directory, con quella che stai usando tu.
$base_root = dirname(__FILE__) ."/FidApi/";
if (file_exists($base_root."/flourishlib/". $class_name .".php"))
{
include $base_root."/flourishlib/". $class_name .".php";
return;
}
elseif (file_exists($base_root."/". $class_name .".php"))
{
include $base_root."/". $class_name .".php";
return;
}
throw new Exception("La classe $class_name non può essere caricata!");
}
?>
Fatto ciò, avremo bisogno della chiave pubblica che ci consentirà di comunicare con il server (CRT), e del certificato per firmare le richieste (CSR): questi due file potranno essere generati dal software FidElí seguendo la procedura che segue.
Apriamo il pannello di configurazione:
Selezioniamo la scheda API:
Clicca sul pulsante "Rigenera tutte le chiavi":
Ora, tramite il pulsante "Scarica chiave pubblica" che si visualizzerà solo se tutte le procedure sono state eseguite con successo, potremo scaricare i certificati che il software ha appena generato per la nostra azienda o il nostro punto vendita.
Scaricati i certificati, otteremo un archivio zip che, scompattato, produrrà due file:
pbl.crt e
pbl.csr. Copiali entrambi nella cartella
FidApi/certificati della libreria FidApi del Software Development Kit.
Infine, inizializza la classe PHP che ti consentirà di indirizzare le richieste al software FidElít.
<?php
// Inizializziamo la classe
$api = new FidApi(
// API KEY dalla scheda "API"
"A9bb8e7769bda2c2d7f42fcc506178561",
// API Secret dalla scheda "API"
"127.0.0.1~~29~~wPHqQQ1GdHo1CxI6A8fqDJJj6vExIcj2EZe...",
dirname(__FILE__) . "/FidApi/certificati/pbl.crt"
);
?>
"
API Key" ed "
API Secret" potranno essere estratti dalla scheda "API".
Ora non ti resta che eseguire l'API Route di cui avrai bisogno.
<?php
// Eseguiamo l'API Route e stampiamo il risultato a video
echo $api->route("Card/Azione/StornaCartaPrepagata", array("card_codice"=>"123467890", "valore"=>175.03));
?>