lahsab encaisse par CCP et BaridiMob pour le compte de votre application, et vous notifie par webhook quand l’argent est confirmé. Software-only, sans détention des fonds : l’argent va directement du compte de l’acheteur au vôtre.
Ces pages couvrent l’intégration serveur-à-serveur. Pour le produit et le pourquoi, voir lahsab.com.
Base et authentification
- Base URL :
https://api.lahsab.com - Authentification : en-tête
x-api-key. L’environnement est déduit du préfixe de la clé (lsk_sandbox_…en sandbox,lsk_live_…en production). Vos clés se gèrent dans la console Développeurs du tableau de bord. - Montants : entiers en dinars (DZD, sans centimes).
Deux façons d’encaisser
| Pour | Point d’entrée | Événement d’accès | |
|---|---|---|---|
| Paiement ponctuel | Une somme, une fois | POST /payments/intents → checkoutUrl | payment.confirmed |
| Abonnement | Un encaissement qui se répète | POST /subscriptions → hostedInvoiceUrl | invoice.paid |
Dans les deux cas, le parcours est le même : vous créez l’objet, redirigez l’acheteur vers la page hébergée par lahsab, il paie sur son CCP ou BaridiMob et dépose une preuve, vous confirmez que l’argent est arrivé, et votre application reçoit un webhook. Le webhook est l’élément central : c’est votre signal pour accorder l’accès ou expédier.
Par où commencer
- Un premier paiement de bout en bout : Démarrage rapide.
- Recevoir et vérifier les événements : Webhooks.
- Vendre un abonnement : Abonnements.
- Tous les endpoints, champs et erreurs : Référence API.