Documentation
Acceptez Mobile Money, cartes et virements en Afrique avec une seule API. Wajub choisit le prestataire de chaque transaction, et passe à un autre quand l'un d'eux échoue pour une raison technique réessayable.
npm install -g @wajub/cli
wajub login
wajub listen --forward-to localhost:3000/webhooks/wajubDémarrage rapide
Compte, API keys, un appel et un webhook. Votre premier paiement de bout en bout.
Choisir une intégration
Page hébergée, composants intégrés, liens de paiement ou l'API en direct.
Sandbox et live
Deux environnements isolés, choisis par le préfixe de l'API key que vous envoyez.
API keys
API keys publiques, secrètes et restreintes, et où placer chacune.
Faire circuler l'argent
Paiements
Encaissez par Mobile Money, carte et virement en un seul appel.
Cycle de vie d'un paiement
Les neuf états que traverse un paiement, et que faire dans chacun.
Remboursements
Remboursements totaux et partiels, ce qu'ils coûtent et ce qui peut encore échouer.
Payouts et transferts
Envoyez des fonds à vos bénéficiaires, en masse ou un par un.
Liens de paiement
Encaissez un paiement sans écrire la moindre ligne de code.
Clients
Réutilisez un payeur d'un paiement à l'autre, avec ses moyens de paiement et son historique.
Choisissez votre client
PHP
Package Composer, à l'aise dans une application Laravel ou Symfony.
Node.js
Client typé, ESM et CommonJS, pour Express, Nest ou Next.
WordPress
Plugin compatible WooCommerce, sans code.
Python
Client indépendant du framework pour Django, Flask et FastAPI.
Go
Un seul module, sans dépendance tierce.
Ruby
Gem qui tient en trois lignes dans un initializer Rails.
C#
Package NuGet pour .NET 8 et versions ultérieures.
Toutes les bibliothèques
Mobile, Java, Kotlin et les conventions qu'elles partagent.
Comment fonctionne Wajub
Comment un paiement arrive jusqu'au client
Un seul appel renvoie une page hébergée déjà routée. Le client choisit son opérateur, confirme sur son téléphone, puis revient sur votre URL de callback.
Comment le routage choisit un prestataire
Les paliers de priorité fixent l'ordre, un score départage les ex æquo au sein d'un palier. Un prestataire qui ne répond pas à temps passe le paiement au suivant sans que le client ne s'en aperçoive.
Comment connaître le résultat
La redirection ne prouve rien. Votre registre doit se fier aux cinq tentatives de webhook réparties sur seize minutes, livrées au moins une fois et sans ordre garanti.
Plateforme
Webhooks
Vérification de signature, nouvelles tentatives, doublons et ordre.
Orchestration
Paliers de priorité, règles de routage et sélection au moindre coût.
Cascade et repli
Ce qui se passe quand un prestataire ne répond pas à temps, et quand la cascade ne s'applique pas.
Konsole
Chaque requête, décision de routage et livraison de webhook, journalisée.
Shield
Score de risque fondé sur des règles pour les transactions que vous acceptez.
Tests
Forcez n'importe quelle issue en sandbox, échecs compris.
Référence
Référence API
Chaque endpoint, paramètre, réponse et code d'erreur.
Gestion des erreurs
Ce que signifie chaque code, et lesquels méritent une nouvelle tentative.
Idempotence
Rejouez un appel sans risque, sans débiter un client deux fois.
Gestion des versions
Versions datées et en-tête X-Wajub-Version.
Passer en live
Ce qu'il faut vérifier avant de passer aux API keys live.
Changelog
Ce qui a changé dans l'API, et quand.