# Cartflox

> Cartflox est un orchestrateur de paiement pour l'Afrique : Mobile Money (Orange Money, Wave, MTN MoMo, M-Pesa, Airtel Money...) et cartes, a travers 22 agregateurs, avec une seule API, une page de paiement hebergee, des webhooks signes, des liens de paiement, des transferts sortants et un mode test.
> Cartflox is a payment orchestration platform for Africa: Mobile Money and cards through 22 aggregators, one API, a hosted payment page, signed webhooks, payment links, outgoing transfers and a test mode.

Base URL: https://cartflox.com/api (routes under /v1). Authentication: `Authorization: Bearer af_live_sec_...` (or `af_test_sec_...` for test mode).

## Documentation (francais)

- [Authentification](https://cartflox.com/docs/authentification/): Clé publique, clé secrète, en-têtes acceptés et rotation des clés API Cartflox.
- [Démarrage rapide](https://cartflox.com/docs/demarrage/demarrage-rapide/): Cinq minutes pour encaisser un premier paiement avec Cartflox.
- [Introduction](https://cartflox.com/docs/demarrage/introduction/): Ce que fait l'API Cartflox, la base URL, le format des réponses et les environnements.
- [Mode test](https://cartflox.com/docs/demarrage/mode-test/): Clés de test af_test_..., paiements simulés depuis la page de paiement, webhooks avec livemode false, données isolées et effacées après 90 jours.
- [Documentation Cartflox](https://cartflox.com/docs/): Encaissez par Mobile Money et carte bancaire partout en Afrique, avec vos propres passerelles. Une API, un widget, SoftPay, WooCommerce.
- [Sans code : lien et bouton de paiement](https://cartflox.com/docs/integrations/sans-code/): Encaisser sans développeur avec un lien de paiement Cartflox, sur Wix, Webflow, Shopify, WordPress, Linktree, WhatsApp ou e-mail.
- [SoftPay : le paiement natif, avec votre design](https://cartflox.com/docs/integrations/softpay/): Le formulaire de paiement dans votre page, stylable par variables CSS, ou entièrement dessiné par vous en mode headless.
- [Widget JavaScript](https://cartflox.com/docs/integrations/widget/): Deux lignes de code pour ouvrir la page de paiement Cartflox par-dessus votre site, avec votre clé publique.
- [WordPress et WooCommerce](https://cartflox.com/docs/integrations/woocommerce/): Le plugin officiel Cartflox pour WooCommerce, installation en cinq minutes, sans code.
- [Créer une session de paiement](https://cartflox.com/docs/paiements/creer-une-session/): POST /v1/checkout/sessions, paramètres, en-têtes, exemples curl, Node.js, PHP et Python, réponse.
- [Liens de paiement](https://cartflox.com/docs/paiements/liens-de-paiement/): Créer un lien de paiement par l'API et savoir s'il a été payé.
- [Moyens de paiement d'une session](https://cartflox.com/docs/paiements/moyens-de-paiement/): GET /v1/checkout/sessions/{id}/methods, la liste des opérateurs disponibles pour une session, filtrée par pays.
- [Passerelles prises en charge](https://cartflox.com/docs/paiements/passerelles/): Les 22 agrégateurs que Cartflox sait piloter avec vos propres clés, pays par pays, et ce que voit votre client au moment de payer.
- [Vérifier le statut d'une session](https://cartflox.com/docs/paiements/verifier-le-statut/): GET /v1/checkout/sessions/{id}/status et la liste des statuts possibles.
- [Changelog](https://cartflox.com/docs/reference/changelog/): Les évolutions notables de la plateforme et de l'API Cartflox.
- [Codes d'erreur](https://cartflox.com/docs/reference/erreurs/): Les codes HTTP renvoyés par l'API Cartflox et leur signification.
- [Feuille de route](https://cartflox.com/docs/reference/feuille-de-route/): Ce qui arrive sur Cartflox, et ce qui n'existe pas encore.
- [Limites de taux](https://cartflox.com/docs/reference/limites/): Les limites de requêtes par minute de l'API Cartflox.
- [OpenAPI et SDK](https://cartflox.com/docs/reference/sdks/): Spécification OpenAPI 3.1, collection Postman et SDK officiels Node.js, PHP et Python de l'API Cartflox, avec la vérification des webhooks.
- [Orchestration multi-passerelles](https://cartflox.com/docs/routage/): Brancher plusieurs passerelles, choisir laquelle encaisse par opérateur et par pays, et laisser Cartflox basculer en cas d'échec.
- [Envoyer de l'argent](https://cartflox.com/docs/transferts/envoyer-de-l-argent/): POST /v1/transfers, envoyer une somme vers un compte Mobile Money, pays et opérateurs, statuts, idempotence, webhooks transfer.succeeded et transfer.failed.
- [Configurer votre webhook](https://cartflox.com/docs/webhooks/configuration/): Renseigner l'URL de réception, par le tableau de bord ou par l'API, et comprendre les nouvelles tentatives.
- [Événements](https://cartflox.com/docs/webhooks/evenements/): Les événements envoyés par Cartflox et le corps de la requête de webhook.
- [Journal et rejeu](https://cartflox.com/docs/webhooks/livraisons/): Chaque webhook envoyé est journalisé, rejoué jusqu'à 10 fois sur 72 heures, et se renvoie à la main depuis le tableau de bord ou l'API.
- [Vérifier la signature](https://cartflox.com/docs/webhooks/signature/): Vérifier la signature HMAC-SHA256 des webhooks Cartflox en Node.js, PHP et Python.

## Documentation (English)

- [Authentication](https://cartflox.com/docs/en/authentification/): Public key, secret key, accepted headers and rotation of Cartflox API keys.
- [Quickstart](https://cartflox.com/docs/en/demarrage/demarrage-rapide/): Five minutes to accept your first payment with Cartflox.
- [Introduction](https://cartflox.com/docs/en/demarrage/introduction/): What the Cartflox API does, the base URL, the response format and the environments.
- [Test mode](https://cartflox.com/docs/en/demarrage/mode-test/): af_test_... test keys, simulated payments from the payment page, webhooks with livemode false, isolated data deleted after 90 days.
- [Cartflox documentation](https://cartflox.com/docs/en/): Accept Mobile Money and card payments across Africa, with your own gateways. One API, a widget, SoftPay, WooCommerce.
- [No code: payment link and button](https://cartflox.com/docs/en/integrations/sans-code/): Get paid without a developer using a Cartflox payment link, on Wix, Webflow, Shopify, WordPress, Linktree, WhatsApp or email.
- [SoftPay: native payment, with your design](https://cartflox.com/docs/en/integrations/softpay/): The payment form inside your page, stylable with CSS variables, or fully designed by you in headless mode.
- [JavaScript widget](https://cartflox.com/docs/en/integrations/widget/): Two lines of code to open the Cartflox payment page on top of your website, with your public key.
- [WordPress and WooCommerce](https://cartflox.com/docs/en/integrations/woocommerce/): The official Cartflox plugin for WooCommerce, installed in five minutes, no code.
- [Create a payment session](https://cartflox.com/docs/en/paiements/creer-une-session/): POST /v1/checkout/sessions, parameters, headers, curl, Node.js, PHP and Python examples, response.
- [Payment links](https://cartflox.com/docs/en/paiements/liens-de-paiement/): Create a payment link through the API and find out whether it has been paid.
- [Payment methods of a session](https://cartflox.com/docs/en/paiements/moyens-de-paiement/): GET /v1/checkout/sessions/{id}/methods, the list of operators available for a session, filtered by country.
- [Supported gateways](https://cartflox.com/docs/en/paiements/passerelles/): The 22 aggregators Cartflox can drive with your own keys, country by country, and what your customer sees when paying.
- [Check the status of a session](https://cartflox.com/docs/en/paiements/verifier-le-statut/): GET /v1/checkout/sessions/{id}/status and the list of possible statuses.
- [Changelog](https://cartflox.com/docs/en/reference/changelog/): Notable changes to the Cartflox platform and API.
- [Error codes](https://cartflox.com/docs/en/reference/erreurs/): The HTTP codes returned by the Cartflox API and their meaning.
- [Roadmap](https://cartflox.com/docs/en/reference/feuille-de-route/): What is coming to Cartflox, and what does not exist yet.
- [Rate limits](https://cartflox.com/docs/en/reference/limites/): The per-minute request limits of the Cartflox API.
- [OpenAPI and SDKs](https://cartflox.com/docs/en/reference/sdks/): OpenAPI 3.1 specification, Postman collection and official Node.js, PHP and Python SDKs for the Cartflox API, with webhook verification.
- [Multi-gateway orchestration](https://cartflox.com/docs/en/routage/): Connect several gateways, choose which one collects payments per operator and per country, and let Cartflox fail over when one fails.
- [Send money](https://cartflox.com/docs/en/transferts/envoyer-de-l-argent/): POST /v1/transfers, send money to a Mobile Money account, countries and operators, statuses, idempotency, transfer.succeeded and transfer.failed webhooks.
- [Configure your webhook](https://cartflox.com/docs/en/webhooks/configuration/): Set the receiving URL, from the dashboard or through the API, and understand retries.
- [Events](https://cartflox.com/docs/en/webhooks/evenements/): The events sent by Cartflox and the body of the webhook request.
- [Log and retries](https://cartflox.com/docs/en/webhooks/livraisons/): Every webhook sent is logged, retried up to 10 times over 72 hours, and can be resent manually from the dashboard or the API.
- [Verify the signature](https://cartflox.com/docs/en/webhooks/signature/): Verify the HMAC-SHA256 signature of Cartflox webhooks in Node.js, PHP and Python.

## Machine-readable

- [OpenAPI 3.1 (JSON)](https://cartflox.com/docs/openapi.json)
- [OpenAPI 3.1 (YAML)](https://cartflox.com/docs/openapi.yaml)
- [Postman collection](https://cartflox.com/docs/cartflox.postman_collection.json)
- [Full documentation in one file](https://cartflox.com/docs/llms-full.txt)