Introduction

Cartflox est un orchestrateur de paiement panafricain : une seule intégration pour encaisser par Mobile Money (Orange Money, Wave, MTN MoMo, Moov…) et carte bancaire dans plus de 15 pays, en passant par vos propres comptes agrégateurs : 22 passerelles prises en charge (PayDunya, PawaPay, Hub2, Wave Business, Djamo, CinetPay, Stripe, Paystack, Flutterwave, FedaPay, Magma OnePay, PayTech, iPay Money…), la liste complète est sur la page Passerelles prises en charge.

Votre argent ne transite jamais par Cartflox

Vous branchez vos propres clés d’agrégateurs dans le tableau de bord. Chaque paiement est encaissé directement sur vos comptes. Cartflox se charge du routage, de la page de paiement, du suivi et des webhooks.

Cartflox est open source

Le moteur est publié sous licence AGPL-3.0 : github.com/uvan00/cartflox. Vous pouvez lire le code, vérifier ce qui se passe avec vos clés, et l’héberger vous-même sur votre propre serveur. L’espace géré, où Cartflox encaisse pour votre compte, ne fait pas partie de la version ouverte.

Ce que fait l’API

Sessions de paiement

Créez une session en un appel, redirigez votre client vers la page de paiement hébergée, récupérez le résultat par webhook ou en interrogeant le statut.

Liens de paiement

Générez un lien à partager par WhatsApp, e-mail ou réseaux sociaux, sans écrire une ligne de code côté client.

Routage multi-passerelles

Chaque opérateur et chaque pays est dirigé vers la passerelle de votre choix, avec bascule automatique si elle échoue.

Webhooks signés

Chaque changement de statut est poussé vers votre serveur avec une signature HMAC-SHA256 que vous vérifiez.

Base URL

Toutes les requêtes se font en HTTPS vers l’adresse ci-dessous. Les endpoints versionnés sont préfixés par /v1.

Base URL

https://cartflox.com/api

Format des réponses

Les réponses sont en JSON. Une erreur renvoie un code HTTP 4xx ou 5xx et un objet { "error": "..." } (ou { "success": false, "message": "..." } sur les endpoints de la page de paiement). Les montants sont des entiers dans la plus petite unité courante de la devise : 5000 vaut 5 000 XOF.

Environnements

Il n’y a pas d’hôte « sandbox » séparé : ce sont vos clés qui font le monde. Chaque espace a deux jeux de clés, af_test_... pour construire et vérifier votre intégration sans appeler d’agrégateur (l’issue du paiement se choisit sur la page), af_live_... pour encaisser. Les données de test restent à l’écart de la production. Tout est décrit dans Mode test. Une passerelle peut aussi, de son côté, être branchée avec les clés sandbox de votre agrégateur : le tableau de bord le signale (bandeau orange).

Numéros de test

En mode test Cartflox, n’importe quel numéro valide convient : l’issue se choisit sur la page. Avec les clés sandbox d’un agrégateur, utilisez ses numéros et cartes de test (PayDunya, CinetPay, Stripe…).