Encaisser des paiements

Encaisser un paiement avec Wajub repose toujours sur la même transaction. Ce qui change entre les quatre modes d'intégration, c'est qui affiche l'écran où le client confirme, et donc la part de l'expérience de paiement que vous possédez et devez maintenir.

Choisissez sur ce seul critère. Tout le reste, les opérateurs que vous atteignez, les webhooks que vous recevez, les remboursements que vous pouvez émettre, est identique pour les quatre.

Quatre points d'entrée

Chaque mode produit un écran différent pour votre client, et c'est toute la différence. Voici à quoi ressemble concrètement chacun une fois en ligne.

Vous hésitez ? Choisir une intégration compare les quatre sur le code, la personnalisation et les cas d'usage. Si vous préférez en voir un fonctionner avant de choisir, le Démarrage rapide mène un paiement sandbox de zéro jusqu'à un webhook vérifié.

Moyens de paiement

Le Mobile Money est la colonne vertébrale : MTN, Orange, Wave, Airtel, Moov et M-Pesa, dans une douzaine de pays. Les cartes et les virements bancaires domestiques sont disponibles là où l'opérateur les prend en charge. Les canaux sont nommés country.operator : cm.mtn est MTN Mobile Money au Cameroun et sn.wave est Wave au Sénégal.

La matrice complète des pays et des opérateurs se trouve dans Moyens de paiement et canaux, et les formats de numéro acceptés par chaque opérateur dans Formats de numéros de téléphone. Un mauvais format de numéro fait échouer le paiement avant même que le client voie une demande de confirmation : cette deuxième page mérite d'être lue une fois.

Les deux appels

Créer un paiement ne débite jamais personne. POST /payments enregistre l'intention, la garde en pending, et vous renvoie l'URL d'une page hébergée et un jeton de session utilisable dans le navigateur. Rien n'a encore atteint un opérateur.

C'est le second appel qui débite, et trois des quatre modes le font pour vous. Le Checkout hébergé le fait quand le client appuie sur confirmer sur la page Wajub, les Composants intégrés le font depuis votre page, et un lien de paiement le fait sur sa propre page hébergée. Seule l'API directe vous le laisse : vous collectez vous-même le numéro de téléphone ou la carte, puis vous envoyez POST /payments/{id} avec un channel et les détails du paiement, et la demande de confirmation part vers le téléphone du client.

Ressources de l'API

Les paiements partagent une seule API avec tous les autres produits. Voici les ressources qu'ils appellent ; les paramètres et les réponses complets se trouvent dans la Référence API.

Les appels de paiement standard n'ont besoin d'aucun en-tête propre au produit. Une marketplace qui attribue le paiement à l'un de ses sous-comptes ajoute X-Sync: acc_… au même appel, comme décrit dans Sync → Ressources de l'API.

Après le paiement