NeptuneRegistre des logos marchands
Langue: Français

Développeurs

Un registre ouvert à toute banque, tout portefeuille, toute fintech ou application : un seul fichier JSON décrit chaque entreprise, avec ses logos sur un CDN. Gratuit, sans clé ni inscription. Géré par Neptune, et pas réservé à ses propres applications.

Démarrage rapide

Index
https://logos-cdn.neptune.ly/v1/index.json
Logo
https://logos-cdn.neptune.ly/v1/logo/{logo}-{96|256}.webp
Schéma
JSON Schema de l’index
curl -s https://logos-cdn.neptune.ly/v1/index.json
const base = 'https://logos-cdn.neptune.ly/v1/';
const idx = await (await fetch(base + 'index.json')).json();
const m = idx.merchants.find((m) => m.id === 'amazon');
const logo = base + idx.logoPath
  .replace('{logo}', m.logo).replace('{size}', 96);

Format de l’index

Chaque entreprise a un id stable, des names (l’arabe d’abord), des aliases (noms alternatifs et formes des relevés de carte comme AMZN Mktp), des tags, une category, des accounts au format bank:15-digit, des merchantIds au format network:id, et logo, l’empreinte de l’image. La définition complète est dans le schéma.

Cache et mises à jour

  • Récupérez l’index au plus une fois par jour, avec If-None-Match ; vous recevez 304 s’il n’a pas changé. Le CDN le garde quelques minutes et revalide.
  • Les fichiers de logo portent l’empreinte de leur contenu, ils ne changent donc jamais (immutable) ; gardez-les en cache sans limite.
  • L’index et les logos envoient Access-Control-Allow-Origin: *, ils fonctionnent donc depuis n’importe quel site ou application.
  • Une entreprise retirée disparaît de l’index suivant ; supprimez ce que vous aviez gardé d’elle lors de la mise à jour.

Associer une transaction à une entreprise

  1. Le compte d’abord. Un IBAN libyen, ou un numéro de compte avec le code de sa banque. Une correspondance de compte tranche.
  2. Puis le nom, normalisé. En minuscules ; les formes de la hamza, le yaa et le taa marbouta deviennent chacun une seule lettre ; P=B et V=F ; les mots comme « société », Ltd et l’article arabe sont retirés.
  3. Les fautes sont pesées. Une voyelle en trop, manquante ou inversée (Libyna, Libiana, برستو) est pardonnée dès 5 lettres ; changer une consonne fait un autre mot (Almadar / Almadak), ce n’est donc pardonné que dans les noms longs.
  4. Une correspondance approchée doit expliquer tout le nom. Elle ne compte que si elle couvre 80 % des lettres du nom, hors ville ou pays : « BARDEM AL MADAK » est un autre commerce.
  5. Le type de lieu doit concorder. Un nom qui dit « café », « pharmacie » ou « hôtel » ne prend jamais le logo d’une entreprise d’un autre secteur.
  6. Dans le doute, pas de logo. Si deux marchands sont aussi proches l’un que l’autre, aucun n’est affiché. Un mauvais logo est pire que pas de logo.

La spécification complète de la correspondance, que suivent nos propres applications, avec les cas de test partagés.

Stabilité et versions

  • Dans schema: 1, les changements sont uniquement additifs : de nouveaux champs facultatifs ou de nouvelles catégories peuvent apparaître, et aucun champ existant ne change de sens. Ignorez ce que vous ne connaissez pas.
  • Tout changement incompatible sort en schema: 2 sous /v2/, et /v1/ continue de fonctionner.
  • Les adresses des logos publiés ne changent jamais, et l’id d’une entreprise n’est jamais réutilisé.

Conditions d’utilisation

  • Gratuit pour tout usage, commercial ou non, sans clé.
  • Les logos sont des marques de leurs propriétaires. Affichez-les uniquement pour identifier l’entreprise dans une transaction ou une liste, jamais dans une publicité ni d’une façon qui suggère un partenariat ou un soutien.
  • Nous retirons tout logo à la demande de son propriétaire : mettez votre copie à jour chaque jour.
  • Citer la source (« Logos du registre Neptune ») est apprécié, pas obligatoire.
  • Le service est fourni tel quel, sans garantie. Ne l’utilisez pas de façon illégale ni pour usurper l’identité d’une entreprise.

Identifiez votre application

Envoyez avec chaque requête un en-tête User-Agent qui nomme votre application, comme le demandent les règles d’OpenStreetMap et de Wikimedia :

User-Agent: YourApp/1.0 (com.your.app; dev@your.app)

Il nous dit qui dépend du registre, pour prévenir avant tout changement. Nous comptons seulement des totaux quotidiens par application et par pays, sans adresse IP ni donnée sur les personnes. Une requête sans en-tête fonctionne normalement.

Confidentialité

Faites la correspondance sur l’appareil de l’utilisateur. N’envoyez jamais son relevé ni ses transactions à un serveur, le nôtre compris : l’index complet est chez vous, et nous n’avons pas besoin de savoir ce que chacun achète.

Contact et état

Questions d’intégration, erreur sur une entreprise ou demande de retrait : logos@neptune.ly.

Dernière publication de l’index : 2026-11-18 20:02 UTC. Le champ version de l’index porte la même valeur ; servez-vous-en pour savoir si votre copie est à jour.