API El-B

De votre code à un paiement attesté

Créez des liens de paiement depuis votre boutique, votre bot ou votre back-office. El-B vérifie les deux descriptions de l’accord avant de montrer votre RIP, et prévient votre serveur, par un message signé, dès que le numéro de transaction arrive.

  • API gratuite, mêmes crédits que l’application
  • L’expéditeur ne paie rien
  • Webhooks signés et renvoyés pour vous
Ce que fait l’API

Tout ce que fait un destinataire, depuis votre code

Le même paiement, les mêmes vérifications et le même reçu que dans l’application. Votre système s’occupe simplement de la routine.

Créer des liens de paiement

Scellez ce que vous livrez et où, choisissez qui peut rejoindre, et recevez le lien à envoyer à l’expéditeur.

Suivre chaque étape

Consultez chaque paiement que vous recevez : qui a rejoint, si l’accord concorde, le numéro de transaction.

Webhooks signés

Chaque événement est signé avec votre secret et renvoyé si votre serveur ne répond pas.

Confirmer les virements vérifiés

Dès que vous voyez le virement dans votre historique BaridiMob, confirmez-le depuis vos propres outils. Le reçu est émis aussitôt.

Des crédits maîtrisés

Calculez le coût d’un montant avant de créer un paiement, consultez votre solde et chaque écriture.

Une utilisation visible

Requêtes, erreurs, temps de réponse et livraisons webhook, jour par jour, sur la page API de votre compte.

Bien démarrer

En service en quatre étapes

Ni contrat ni frais d’installation : un compte vérifié et une clé.

  1. 1

    Vérifiez votre compte

    Envoyez un document officiel depuis votre profil. L’API est réservée aux comptes vérifiés par un document officiel.

  2. 2

    Générez votre clé

    Une clé par compte, affichée une seule fois. El-B n’en conserve qu’une empreinte.

  3. 3

    Créez votre premier paiement

    Une requête avec le montant et ce que vous livrez. Envoyez le lien reçu en réponse.

  4. 4

    Attendez le numéro de transaction

    Un webhook vous prévient de son arrivée. Vérifiez votre historique BaridiMob, puis confirmez.

Ouvrir le guide de démarrage
POST /api/v1/payments
curl -X POST https://el-b.com/api/v1/payments \
  -H "Authorization: Bearer $ELB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_dzd": 45000,
    "deliverable": "iPhone 13, 128 GB",
    "fulfillment_target": "Bab Ezzouar, Algiers",
    "label": "Order #1042"
  }'
HTTP/1.1 201 Created

{
  "data": {
    "code": "Kx7pR2mQ9a",
    "url": "https://el-b.com/pay/Kx7pR2mQ9a",
    "status": "open",
    "credit_state": "held"
  }
}
Cas d’usage

Pensée pour les destinataires qui vendent chaque jour

Partout où vous concluez un accord, votre système peut envoyer le lien attesté.

Boutiques en ligne

Chaque commande reçoit son propre lien de paiement au moment de la commande, avec son numéro comme libellé.

Bots de discussion

Votre bot Messenger, Telegram ou WhatsApp envoie le lien et annonce lui-même chaque étape suivante.

Back-offices

Associez chaque numéro de transaction à une commande et clôturez-la dès que le virement est confirmé.

Prestataires de services

Indépendants et agences envoient un lien attesté par facture et commencent le travail une fois le virement confirmé.

Confidentialité dès la conception

Ce que l’API ne partage jamais

El-B protège votre numéro de compte et l’accord lui-même. L’API suit les mêmes règles que l’application.

  • Votre RIP reste à l’écart

    Il ne figure jamais dans une réponse de l’API ni dans un webhook. L’expéditeur le voit dans son navigateur, une fois les deux descriptions concordantes.

  • L’accord reste scellé

    Vous recevez le nom de l’expéditeur et savez si son compte est vérifié, jamais sa propre description de l’accord.

  • Des clés en empreintes

    Votre clé est affichée une fois et conservée sous forme d’empreinte. Régénérez-la ou mettez-la en pause à tout moment.

  • Aucun argent entre vous

    El-B ne détient jamais d’argent : l’expéditeur vire dans BaridiMob, directement sur votre compte.

Questions

Questions des développeurs

Une autre question ? Écrivez-nous depuis la page de contact.

L’API est-elle gratuite ?

Oui. Les appels sont gratuits. Un paiement créé via l’API coûte les mêmes crédits qu’un paiement créé dans l’application, et l’expéditeur ne paie rien.

Qui peut obtenir une clé API ?

Les comptes vérifiés par un document officiel et disposant d’un RIP. Chaque compte a une clé, générée depuis la page API du compte.

El-B reçoit-il ou détient-il l’argent ?

Non. El-B est un témoin numérique, pas une banque, un portefeuille ni un prestataire de paiement. L’expéditeur vire dans BaridiMob, directement sur votre compte.

Mon système peut-il confirmer les virements seul ?

Votre système peut appeler le point d’accès de confirmation, mais vous seul pouvez consulter votre historique BaridiMob : confirmez un paiement seulement après y avoir vu le virement. Sans réponse, un paiement se confirme de lui-même après 72 heures.

Mon RIP passe-t-il par l’API ?

Non. Votre RIP et vos données d’identité ne figurent jamais dans les réponses de l’API ni dans les webhooks. L’expéditeur voit votre RIP uniquement dans son navigateur, une fois les deux descriptions de l’accord concordantes.

En quelle langue est la documentation ?

En anglais, avec des exemples en cURL, PHP, JavaScript et Python. Cette page existe en arabe, en français et en anglais.

Votre premier lien de paiement est à une requête

Générez votre clé depuis votre compte, puis suivez le guide de démarrage.