Centro sviluppatori

A chi è indicato

Le API con SSL consentono di far dialogare due o più server (o PC) in modo sicuro. Attualmente è l'unico sistema di integrazione supportato, ma prossimamente saranno disponibili anche API non cifrate.

Questo tipo di API è indicato a chi vuole la massima sicurezza nelle comunicazioni per integrare il proprio software (o sito internet) con FidElít. L'integrazione tra il vostro software e FidElít avverrà grazie ad un SDK da noi fornito, che sarà possibile scaricare nella sezione "Come iniziare".



Come iniziare

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:

Integrazione SDK PHP

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&ograve; 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));
?>