Aller au contenu
Cartflox

Démarrage rapide

Cinq minutes suffisent pour encaisser un premier paiement.

  1. Créez votre compte et branchez votre agrégateur.

    Créez un compte, puis dans Passerelles, ajoutez les clés API de votre agrégateur. Cartflox vérifie les clés auprès du fournisseur avant de les enregistrer. Dans Moyens de paiement, activez les opérateurs que vos clients pourront utiliser.

  2. Récupérez vos clés API.

    Dans API et Logs, vous trouvez votre clé publique af_live_pub_... et votre clé secrète af_live_sec_.... La clé secrète authentifie vos appels serveur : ne la mettez jamais dans une page web ou une application mobile.

  3. Créez une session de paiement.

    curl
    curl -X POST https://cartflox.com/api/v1/checkout/sessions \
      -H "Authorization: Bearer af_live_sec_VOTRE_CLE" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: commande-1042" \
      -d '{
        "amount": 5000,
        "currency": "XOF",
        "customer_name": "Awa Koné",
        "customer_email": "awa@example.com",
        "customer_phone": "+2250700000000",
        "description": "Commande #1042",
        "success_url": "https://maboutique.com/merci",
        "cancel_url": "https://maboutique.com/panier",
        "metadata": { "order_id": "1042" }
      }'

    La réponse contient l’adresse de la page de paiement : redirigez-y votre client.

    Réponse 201
    {
      "id": "cmf3k2p1x0001abcd9e8f7g6h",
      "object": "checkout.session",
      "url": "https://checkout.cartflox.com/cmf3k2p1x0001abcd9e8f7g6h",
      "order_id": "CS-MF3K2A-9X1QZ",
      "amount": 5000,
      "currency": "XOF",
      "status": "pending",
      "created": "2026-09-02T10:15:00.000Z"
    }

  4. Recevez la confirmation.

    Renseignez l’URL de votre serveur dans API et Logs, ou par l’API (voir Webhooks). Dès que le paiement aboutit, Cartflox envoie l’événement payment.completed, signé. Vous pouvez aussi interroger le statut de la session à tout moment.

  5. Passez en production.

    Remplacez les clés sandbox de votre passerelle par les clés de production. Complétez votre vérification d’identité : elle est obligatoire pour une plateforme de paiement.