Documentation développeur
Des paiements qui continuent quand le réseau lâche
PayVault est une infrastructure de paiement pour les réseaux peu fiables. Votre application peut accepter et effectuer des paiements sans signal, avec un risque fixé à l'avance, et tout est rapproché et réglé au retour de la connexion.
Ce qu'est PayVault
PayVault est une couche technologique B2B pour les banques, les opérateurs de mobile money, les fintechs, les prestataires de services de paiement et les agences humanitaires en Afrique. Vous gardez vos clients, votre marque et votre registre. PayVault fournit le protocole hors ligne, la bibliothèque cliente, le rapprochement côté serveur et les événements qui indiquent à vos systèmes quoi régler.
En production, le partenaire agréé est le dépositaire des fonds et le prêteur de référence pour tout découvert. L'application de référence de ce dépôt inclut aussi un registre hébergé de bac à sable, pour essayer le parcours complet sans registre propre.
Deux couches
La couche 1 est la fiabilité. Chaque paiement est un message signé et chaîné par hachage, conservé durablement sur l'appareil, transmis par code QR, envoyé dès que quelqu'un a du signal, et dédoublonné par le serveur. Un paiement peut être rejoué, relayé par un coursier ou envoyé deux fois sans être compté deux fois.
La couche 2 est l'acceptation hors ligne garantie. Un commerçant peut accepter un paiement sans réseau parce que la valeur sous-jacente a été bloquée à l'avance (le coffre hors ligne) et, en option, parce que le partenaire a accordé un découvert limité. Le commerçant vérifie entièrement le paiement sur l'appareil. S'il est valide, le commerçant est payé, quoi qu'il arrive ensuite.
À qui il s'adresse
- Les opérateurs de mobile money et les réseaux d'agents qui perdent des ventes à cause des coupures.
- Les banques, fintechs et prestataires de paiement qui veulent l'acceptation hors ligne dans leurs applications et parcours de caisse existants.
- Les programmes de transferts humanitaires et publics qui paient dans des zones peu connectées.
- Les transports, la billetterie et les marchés, avec de nombreux petits paiements fréquents.
Le parcours en cinq étapes
- Émettre : votre serveur demande à PayVault de signer une allocation pour la clé de l'appareil d'un client, après avoir bloqué les fonds dans votre registre.
- Demander : l'appareil du commerçant affiche une demande de paiement sous forme de code QR.
- Payer : l'appareil du client signe un paiement, chaîné au précédent, et le réaffiche en code QR.
- Vérifier : l'appareil du commerçant contrôle signatures, limites, révocations et chaîne, hors ligne, puis accepte ou refuse.
- Rapprocher : dès que l'un des deux a du signal, les paiements sont envoyés. PayVault les dédoublonne, affecte chacun à la valeur préfinancée, au découvert ou au fonds de risque, détecte les bifurcations et émet des événements pour votre registre.
Le bac à sable
PayVault est aujourd'hui un prototype. L'API et la console accessibles fonctionnent en mode bac à sable : aucun argent réel ne circule, aucun fonds n'est détenu, et le même format de clé d'API est utilisé partout. Tous les packs pays sont marqués concept et leurs limites sont des valeurs indicatives, non validées par un régulateur.
Pour essayer, créez un compte partenaire dans la console, créez une clé d'API et suivez le démarrage rapide. Dans ces pages, $PAYVAULT_URL désigne l'origine qui sert l'API.