Documentation Cartflox v2.0

Introduction à l'API Cartflox

Cartflox est une API de paiement panafricaine qui vous permet d'accepter des paiements Mobile Money (Orange Money, Wave, MTN MoMo, Moov) et carte bancaire, ainsi que d'effectuer des transferts d'argent dans plus de 15 pays africains — avec une seule intégration.

✓ Bon à savoirL'API Cartflox est disponible en mode sandbox et production. Utilisez vos clés sandbox pour tester sans effectuer de vrais paiements.

Fonctionnalités principales

Paiements Mobile Money

Orange Money, Wave, MTN MoMo, Moov, Airtel, Free Money…

Paiements par carte

Visa, Mastercard via notre passerelle sécurisée PCI DSS

Smart Routing

5 algorithmes (Priority, Volume Split, DSL, Dynamic) + fallback automatique

Transferts d'argent

Envoi de fonds vers des comptes Mobile Money et bancaires

Webhooks temps réel

Notifications instantanées sur l'état de vos transactions

Personnalisation

Page de paiement entièrement brandée à votre identité

SDKs multi-langages

Node.js, Python, PHP, Flutter, React Native

Audit log complet

Traçabilité de chaque décision de routage pour debug en prod

Base URL

Toutes les requêtes API doivent être effectuées en HTTPS :

Endpoints

# Sandbox (tests)
https://sandbox.api.afriflow.com/v2

# Production
https://api.afriflow.com/v2

Format des réponses

Toutes les réponses sont au format JSON avec la structure suivante :

Réponse type

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_01HXYZ...",
    "timestamp": "2026-03-01T12:00:00Z"
  }
}

// En cas d'erreur :
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Le solde du compte est insuffisant.",
    "details": {}
  }
}

Environnements

Sandbox

Pour les tests. Aucun vrai argent n'est débité. Utilisez les numéros de test fournis.

Production

Pour les vrais paiements. Nécessite la validation KYB de votre compte.