Prestataires

Une connexion à un prestataire correspond à votre propre compte chez un prestataire de paiement, conservé par Wajub et utilisé en votre nom. En dehors de son propre réseau, décrit plus bas, Wajub ne revend l'accès au réseau de personne. Vous signez avec CinetPay, Flutterwave ou MTN, vous collez vos identifiants ici, puis Wajub effectue les débits par leur intermédiaire, selon votre contrat et vos tarifs négociés.

Tout ce que le routage utilise d'une connexion se trouve sur sa page sous Orchestration, Fournisseurs. Cette page explique le rôle de chaque champ.

Connecter un prestataire

L'assistant comporte quatre étapes. Seules les deux premières dépendent du prestataire choisi.

Credentials. Chaque prestataire déclare ses propres champs, car le site_id de CinetPay n'a pas d'équivalent chez Stripe. Le formulaire demande exactement ce dont le prestataire a besoin, rien de plus. Les valeurs sont chiffrées au repos et ne vous sont ensuite jamais renvoyées entièrement.

Channels. Les fonctionnalités du prestataire que vous souhaitez utiliser pour le routage par cette connexion. Ne modifiez rien pour obtenir tout ce que le prestataire prend globalement en charge, à l'exception des canaux qu'il doit d'abord activer pour votre compte.

Routing. Les quatre nombres au coeur de cette page : la priorité, le poids et votre tarif négocié.

Review. Rien n'est enregistré avant cette étape. Un test devient ensuite disponible sur la page de la connexion. Il appelle le prestataire avec vos identifiants et vous indique s'ils fonctionnent avant qu'un véritable payeur n'en dépende.

Ce qu'une connexion peut traiter

Deux listes restreignent une connexion et fonctionnent de la même manière : une liste vide signifie tout, pas rien.

Canaux. Un paiement ne passe par la connexion que si le prestataire peut techniquement traiter le canal du paiement et que votre propre liste de canaux l'autorise. Si vous n'avez jamais défini de liste, toutes les fonctionnalités du prestataire sont acceptées. La restriction est un choix.

Devises. Même règle. Une liste de devises vide accepte toutes les devises que le prestataire peut régler. Vous la réglez dans l'assistant de connexion et sur la page de la connexion, sous Devises.

Le canal utilisé ici est un slug exact, le canal d'opérateur sur lequel les paiements sont routés : cm.mtn, sn.wave, ke.mpesa, card. Aucun paiement n'est routé sur des valeurs de niveau produit comme mobile_money ou bank_transfer. Choisir une liste de canaux revient à sélectionner les réseaux des opérateurs un par un.

Configuration du routage

Quatre champs qui ont des effets très différents.

Utilisez la priorité lorsque vous connaissez la réponse souhaitée pour tous les paiements. Lorsque la réponse dépend du pays, du canal, de la devise ou du montant, une règle de routage l'exprime plus précisément et s'applique en premier, et une politique de canal peut ordonner un canal d'opérateur à part. Sans politique de canal, les trois autres champs ne sont pris en compte qu'à l'intérieur d'un palier, une fois que la priorité a regroupé vos connexions. Avec une politique, le tarif et les frais fixes alimentent aussi son objectif Coût le plus bas et son plafond de coût, et le poids répartit le trafic entre les connexions qu'elle laisse à égalité.

Prenons un exemple : deux connexions peuvent traiter cm.mtn, l'une avec une priorité de 10 et l'autre de 0, sans règle ni politique sur le canal. La première est toujours appelée en premier, quels que soient le coût et les performances de la seconde. Placez-les toutes les deux sur 10 : le coût et la réussite récente commencent alors à décider, et vos tarifs à compter.

Le catalogue et la signification d'une présence dans celui-ci

La liste des prestataires du Dashboard présente ceux que vous pouvez connecter. Trois conditions doivent être réunies avant qu'un prestataire puisse traiter un paiement live.

Si vous avez connecté un prestataire qui n'apparaît jamais dans une décision de routage, passez son canal, sa devise et un montant dans le simulateur de routage, disponible à partir du plan Growth : il indique pourquoi chaque connexion a été écartée.

Vous pouvez aujourd'hui connecter 24 prestataires : le réseau Wajub (sur demande, voir plus bas), Stripe, PayPal, Flutterwave, Paystack, PawaPay, CinetPay, InTouch, FedaPay, Kkiapay, Maviance, My-CoolPay, Monetbil, Campay, Neero, Notch Pay, Taramoney, Fapshi, Nokash, MTN MoMo, Orange Money, Wave, Djamo et Express Union Mobile Money. Les autres prestataires du catalogue sont marqués Bientôt disponible et ne peuvent pas encore être connectés.

Les connexions étant live, une connexion live refuse les clés de test d'un prestataire : une clé Stripe ou Paystack commençant par sk_test_ ou pk_test_, une clé Flutterwave contenant _TEST-. Le Dashboard les refuse à l'enregistrement, car ces prestataires répondent à un test de connexion avec une clé de test et la connexion paraîtrait saine alors que chaque vrai paiement échouerait.

Lorsque Wajub met un prestataire en Maintenance, le routage ignore toutes les connexions vers lui jusqu'à son retour, et la connexion suivante prend le paiement. La décision enregistre cette mise à l'écart avec le motif provider_in_maintenance. Seul un prestataire Disponible ou en Bêta reçoit des paiements : un prestataire marqué Bientôt disponible ou Désactivé est écarté de la même façon, avec le motif provider_unavailable, même si une connexion vers lui est encore active.

Il existe six types de prestataires, et leur type indique leur nature : aggregator, mobile_money, card, wallet, bank, crypto. Un agrégateur atteint plusieurs opérateurs avec un seul contrat. Une connexion à un agrégateur peut donc remplir toute une colonne de la matrice. Une connexion Mobile Money directe accède au réseau d'un seul opérateur.

Wajub exploite également une connexion interne au Cameroun, le réseau Wajub. Elle est accordée après une demande sous Orchestration, Wajub rail, pas en collant des identifiants, et uniquement une fois votre compte vérifié. Vous choisissez les canaux, vous consultez les tarifs proposés et vous signez le contrat dans le Dashboard. Wajub examine ensuite la demande : elle est approuvée, approuvée pour une partie des canaux seulement, ou refusée. Le contrat signé se télécharge une fois la demande acceptée. Une seule demande est examinée à la fois, et vous pouvez demander d'autres canaux ensuite. Une fois en place, le réseau se comporte comme toutes les autres connexions, y compris pour la priorité et le poids.

Nombre de connexions autorisées

Votre plan définit le plafond. C'est la seule limite qui détermine ce que l'orchestration peut faire pour vous.

Le réseau Wajub ne compte pas dans ce plafond : en Pay as you go, vous pouvez avoir deux connexions à vous et le réseau Wajub.

Deux connexions constituent le minimum nécessaire à une cascade. Avec une seule connexion, Wajub enregistre toujours une décision de routage, mais la liste ne contient qu'une ligne et un échec du côté du prestataire met fin au paiement.

Lorsqu'une connexion rencontre un problème

Deux mécanismes agissent seuls, à des échelles de temps différentes. Vous ne configurez aucun des deux.

Le health badge de la connexion présente les transactions créditées qui l'ont empruntée au cours des dernières 24 heures. Il est vert à partir de 95 %, orange à partir de 80 %, rouge en dessous et gris tant que cinq paiements n'ont pas été traités. Il évalue la dernière journée à votre intention.

Le coupe-circuit agit en quelques minutes. Lorsqu'une connexion échoue de façon répétée sur un canal, Wajub la met en pause sur ce canal pendant quelques minutes et la remet automatiquement en service dès qu'elle fonctionne de nouveau. Seuls votre compte et ce canal sont concernés : une connexion qui échoue sur cm.mtn continue donc de traiter normalement cm.orange. Cascade et repli décrit ce que vous voyez pendant ce temps.

Ce que vous seul pouvez corriger est signalé sur la connexion elle-même. Lorsqu'elle n'a pas d'identifiants pour un canal, ou que le prestataire refuse sa clé, la connexion affiche Connexion refusée dans la liste, la page du prestataire affiche l'erreur avec Corriger la connexion, et votre équipe reçoit un e-mail à ce sujet dans les cinq minutes environ. Un autre n'arrive que si la connexion est de nouveau signalée après la levée du signalement. Le signalement disparaît lorsque vous enregistrez des identifiants différents, lorsqu'un test de connexion réussit, ou au prochain paiement que la connexion prend en charge. Cascade et repli décrit l'effet d'une telle connexion sur un paiement.

Ce que votre intégration peut consulter

Vos connexions sont accessibles depuis l'API, volontairement sans leur configuration de routage.

La réponse donne, pour chaque connexion active, l'identifiant, le slug, le nom, le logo, le type, un is_active donc toujours true, et les canaux réellement disponibles. Ces canaux correspondent à l'intersection entre ceux pris en charge par le prestataire et ceux que vous avez activés. La priorité, le poids, les tarifs et les identifiants n'y figurent pas. Aucun endpoint ne permet de les modifier.

Chaque entrée de channels est le même objet que celui renvoyé par GET /channels, avec tous ses champs. Une connexion avec six canaux en contient donc six. L'exemple ci-dessous est abrégé à une connexion et à quelques champs d'un de ses canaux.

Les modifications d'une connexion sont envoyées à vos endpoints de webhook. Votre backend peut ainsi rester à jour sans interroger régulièrement cette liste.

Si votre checkout affiche les moyens de paiement, utilisez les événements de canal plutôt qu'une liste codée en dur. Ils sont émis pour l'ensemble exact sur lequel Wajub route les paiements.

Demander un prestataire absent de la liste

Écrivez à [email protected] en indiquant le prestataire, les pays et les canaux dont vous avez besoin. L'ajout d'un prestataire est un développement de notre côté, pas une modification de configuration, et les pays que vous indiquez nous aident à le prioriser.