Introduction

Cartflox is a pan-African payment orchestrator: one integration to accept Mobile Money (Orange Money, Wave, MTN MoMo, Moov…) and card payments in more than 15 countries, through your own aggregator accounts: 22 supported gateways (PayDunya, PawaPay, Hub2, Wave Business, Djamo, CinetPay, Stripe, Paystack, Flutterwave, FedaPay, Magma OnePay, PayTech, iPay Money…). The full list is on the Supported gateways page.

Your money never passes through Cartflox

You plug your own aggregator keys into the dashboard. Each payment is collected directly on your accounts. Cartflox handles routing, the payment page, tracking and webhooks.

Cartflox is open source

The engine is published under the AGPL-3.0 licence: github.com/uvan00/cartflox. You can read the code, check what happens to your keys, and host it yourself on your own server. The managed workspace, where Cartflox collects on your behalf, is not part of the open version.

What the API does

Payment sessions

Create a session in one call, redirect your customer to the hosted payment page, and get the result through a webhook or by checking the status.

Payment links

Generate a link to share on WhatsApp, by email or on social media, without writing a single line of client-side code.

Multi-gateway routing

Each operator and each country is routed to the gateway of your choice, with automatic failover if it fails.

Signed webhooks

Every status change is pushed to your server with an HMAC-SHA256 signature that you verify.

Base URL

All requests are made over HTTPS to the address below. Versioned endpoints are prefixed with /v1.

Base URL

https://cartflox.com/api

Response format

Responses are JSON. An error returns a 4xx or 5xx HTTP status code and an object { "error": "..." } (or { "success": false, "message": "..." } on the payment page endpoints). Amounts are integers in the smallest common unit of the currency: 5000 means 5,000 XOF.

Environments

There is no separate “sandbox” host: your keys decide the world. Each workspace has two sets of keys, af_test_... to build and verify your integration without calling any aggregator (the outcome of the payment is chosen on the page), af_live_... to collect real payments. Test data stays apart from production. Everything is described in Test mode. A gateway can also, on its side, be connected with your aggregator’s sandbox keys: the dashboard flags it (orange banner).

Test numbers

In Cartflox test mode, any valid number will do: the outcome is chosen on the page. With an aggregator’s sandbox keys, use its test numbers and cards (PayDunya, CinetPay, Stripe…).