🔌 API TAAMA — Réservation en marque blanche

Mets le moteur de réservation TAAMA directement sur ton site

Une seule API pour la recherche, la réservation et le paiement : bus, train, vols locaux, envoi de colis et fret. Ton site, ta marque — notre moteur, notre logistique.

Activation rapide · Bac à sable gratuit sans engagement

POST /public_api.php?action=bookings.create
// Authentification par en-têtes — jamais dans l'URL
X-Taama-Api-Key:    ak_live_7f2a1c9e...
X-Taama-Api-Secret: sk_live_••••••••••••

// Corps de la requête
{
  "convoiId": "CVI-8B21",
  "classId": "CLS-VIP",
  "passengers": [{ "fullName": "Awa Koné" }],
  "contact": { "phone": "+225 07 xx xx xx xx" }
}

// Réponse
{
  "ok": true,
  "data": {
    "ref": "TAAMA-4F2A1C",
    "status": "en_attente_paiement",
    "price": 7500
  }
}
5
Verticales couvertes
bus · train · avion · colis · fret
2
Moyens de paiement intégrés
Carte (Paystack) · Wave / mobile money
24-48h
Délai de réponse
après ta demande de souscription
100%
Isolé par abonné
tes données ne sont jamais mélangées
Pourquoi l'API TAAMA

Un moteur déjà éprouvé, prêt pour ton site

Pas besoin de recoder la recherche d'itinéraires, la gestion des sièges, le calcul des prix ou la vérification des paiements — tout est déjà là.

⚙️

Le vrai moteur TAAMA

La même logique qui fait tourner l'application TAAMA (recherche, plan de sièges, tarification, politique d'annulation) — pas une version simplifiée.

🔒

Paiement vérifié, jamais déclaratif

Carte bancaire vérifiée serveur à serveur via Paystack, ou Wave/mobile money avec preuve validée par la compagnie — aucune confiance aveugle au navigateur.

🧩

Isolation multi-abonnés

Chaque site voit et gère uniquement les réservations qu'il a lui-même créées — jamais celles d'un autre abonné, même au sein de la même compagnie.

🚌

5 verticales, une seule clé

Bus, train, vols locaux, colis et fret : les mêmes identifiants donnent accès à l'ensemble du moteur de réservation TAAMA.

🎯

Un périmètre adapté à ton profil

Compagnie de transport : uniquement tes propres lignes. Agent de voyage : toutes les compagnies actives, exactement comme dans l'application TAAMA.

🧪

Bac à sable gratuit

Teste de vrais appels de recherche avant même de souscrire — aucune carte, aucun engagement, aucune donnée personnelle exposée.

Fonctionnalités

Toute la chaîne, du moteur de recherche au billet payé

  • ✓ Recherche d'itinéraires par ville, date et mode de transport (bus, train, vol local)
  • ✓ Liste des départs disponibles et plan de sièges en temps réel, quand la compagnie l'a activé
  • ✓ Réservation multi-passagers avec création automatique du compte client TAAMA
  • ✓ Paiement carte (Paystack, vérifié) ou Wave/mobile money (preuve vérifiée par la compagnie)
  • ✓ Annulation selon la politique réellement configurée par la compagnie (crédit ou espèces)
Actions disponibles
routes.searchroutes.convoisroutes.seatmap bookings.createbookings.paybookings.getbookings.cancel
  • ✓ Liste des services et catégories de colis proposés par la compagnie, avec tarifs
  • ✓ Création d'un envoi avec expéditeur, destinataire et assurance en option
  • ✓ Paiement carte ou Wave, exactement comme pour la billetterie
  • ✓ Suivi de l'envoi (statuts, historique de tracking) via le numéro de suivi
Actions disponibles
parcels.servicesparcels.createparcels.payparcels.get
  • ✓ Création d'une demande de fret (type de marchandise, poids/volume, trajet)
  • ✓ Tarification appliquée automatiquement selon les grilles de la compagnie
  • ✓ Paiement carte ou Wave, suivi du statut de la demande
Actions disponibles
freight.createfreight.payfreight.get
Mise en route

De la demande au site en ligne

Licence

Une licence annuelle unique, tout compris

Le tarif est communiqué directement lors de l'étude de ta demande — il dépend de ton profil (compagnie de transport ou agent de voyage).

Licence API TAAMA

Tarif communiqué à la souscription

Pour une compagnie de transport ou un agent de voyage.

  • ✓ Accès complet aux 5 verticales (billetterie, colis, fret)
  • ✓ Clé publique + secret API, régénérable à tout moment
  • ✓ Bac à sable illimité pour tester avant et après la mise en ligne
  • ✓ Site modèle PHP fourni, prêt à personnaliser
  • ✓ Suivi et gestion de licence depuis ton tableau de bord TAAMA
Demander mon tarif
ℹ️ Agent de voyage : la licence agent classique reste requise en plus de la licence API — les deux doivent être actives pour que l'API accepte tes requêtes. Compagnie de transport : ton périmètre reste toujours limité à tes propres lignes, jamais à celles d'une autre compagnie.
🧪 Bac à sable public

Teste une vraie recherche, sans compte

Ce bac à sable appelle le vrai moteur TAAMA en lecture seule — aucune réservation, aucun paiement, aucune donnée personnelle. Idéal pour se faire une idée avant de souscrire.

Renseigne une ville de départ et d'arrivée pour lancer une recherche.
🔒 Lecture seule : ce bac à sable ne crée jamais de réservation et n'expose aucune donnée client. Pour réserver et payer réellement, une clé API active est nécessaire (voir la documentation).
Questions fréquentes

Encore une question ?

Le paiement par carte est-il vraiment sécurisé côté API ?

Oui. Tout paiement par carte est revérifié serveur à serveur auprès de Paystack, montant recalculé de notre côté — jamais sur la seule foi d'un callback du navigateur. Un paiement Wave/mobile money passe par la file de vérification de la compagnie, exactement comme dans l'application TAAMA.

Puis-je vendre les billets d'autres compagnies avec mon abonnement ?

Cela dépend de ton profil. Une compagnie de transport ne peut vendre que ses propres lignes — jamais celles d'une autre compagnie. Un agent de voyage garde un périmètre global, comme dans l'application TAAMA.

Un aller-retour se réserve-t-il en un seul appel ?

Pas encore dans cette première version de l'API : un aller-retour nécessite deux appels séparés (un par sens de trajet). C'est documenté dans la référence technique.

Qui développe le site qui va utiliser l'API ?

Toi, ton équipe technique, ou l'équipe technique TAAMA sur devis. Dans tous les cas, un site modèle PHP complet et fonctionnel t'est fourni comme point de départ.

La licence API remplace-t-elle la licence agent ?

Non. Ce sont deux licences séparées et cumulatives : la licence agent donne accès à l'application TAAMA, la licence API donne en plus accès à l'API pour ton propre site. Pour une compagnie, seule la licence API est nécessaire. Les tarifs te sont communiqués lors de l'étude de ta demande.

Prêt à connecter ton site au moteur TAAMA ?

Documentation complète, exemples de code et bac à sable — tout est prêt pour démarrer.