Guide de démarrage rapide

Intégrez Fidoren à votre système en 5 minutes.

1

Créer un compte marchand

Si vous n'avez pas encore de compte, inscrivez-vous gratuitement. L'API est disponible dès le plan Starter.

Créer un compte
2

Générer une clé API

Depuis votre tableau de bord, accédez au portail développeur et créez une nouvelle clé API.

  1. Connectez-vous à votre compte
  2. Allez dans Développeurs > Mes clés API
  3. Cliquez sur Nouvelle clé API
  4. Choisissez un nom et les permissions
  5. Copiez immédiatement le secret (il ne sera plus visible)
3

Tester l'authentification

Vérifiez que votre clé fonctionne avec une simple requête. 

# Avec cURL
curl -X GET "https://votre-domaine.com/api/v1/merchant/stores/" \
  -H "Authorization: ApiKey lf_votre_cle:votre_secret"

# Réponse attendue
{
  "success": true,
  "stores": [
    {
      "id": 1,
      "name": "Ma Boutique",
      ...
    }
  ]
}
4

Intégrer dans votre code

Voici des exemples d'intégration dans différents langages. 

# Python avec requests
import requests

API_KEY = "lf_votre_cle"
API_SECRET = "votre_secret"
BASE_URL = "https://votre-domaine.com/api/v1"

headers = {
    "Authorization": f"ApiKey {API_KEY}:{API_SECRET}"
}

# Ajouter un tampon
response = requests.post(
    f"{BASE_URL}/loyalty/stamps/add/",
    headers=headers,
    json={
        "store_id": 1,
        "customer_id": 42,
        "stamps": 1
    }
)

print(response.json())
// JavaScript avec fetch
const API_KEY = 'lf_votre_cle';
const API_SECRET = 'votre_secret';
const BASE_URL = 'https://votre-domaine.com/api/v1';

// Ajouter un tampon
const response = await fetch(`${BASE_URL}/loyalty/stamps/add/`, {
  method: 'POST',
  headers: {
    'Authorization': `ApiKey ${API_KEY}:${API_SECRET}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    store_id: 1,
    customer_id: 42,
    stamps: 1
  })
});

const data = await response.json();
console.log(data);
// PHP avec cURL
$api_key = 'lf_votre_cle';
$api_secret = 'votre_secret';
$base_url = 'https://votre-domaine.com/api/v1';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "{$base_url}/loyalty/stamps/add/",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: ApiKey {$api_key}:{$api_secret}",
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'store_id' => 1,
        'customer_id' => 42,
        'stamps' => 1
    ])
]);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));
5

Cas d'usage courants

Voici les intégrations les plus fréquentes :

Scanner un client
Quand un client présente son QR code, appelez /loyalty/scan/ pour récupérer ses infos et son solde.
Valider un achat
Après un achat, appelez /loyalty/stamps/add/ ou /loyalty/points/add/.
Échanger une récompense
Quand le client utilise une récompense, appelez /loyalty/redeem/.
Consulter les stats
Affichez les statistiques dans votre back-office via /merchant/stats/.

Prêt à aller plus loin ?

Consultez la documentation complète ou testez les endpoints avec Swagger.

Documentation complète Swagger UI