Liens de paiement

Un lien de paiement est une page hébergée à montant fixe, à partager par WhatsApp, e-mail ou réseaux sociaux. Vous pouvez les créer depuis le tableau de bord ou par l’API.

POST/v1/payment-linksCréer un lien de paiement

Paramètre	Type	Requis	Description
title	string	Oui	Titre affiché au client
amount	number	Oui	Montant fixe
currency	string	Non	XOF par défaut
description	string	Non	Détail du produit ou service

curl

curl -X POST https://cartflox.com/api/v1/payment-links \
  -H "Authorization: Bearer af_live_sec_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Formation Odoo", "amount": 25000, "currency": "XOF" }'

200 OK

{
  "success": true,
  "id": "cmf3lz...",
  "url": "https://cartflox.com/pay/k3j9x2ab",
  "slug": "k3j9x2ab",
  "amount": 25000,
  "currency": "XOF"
}

GET/v1/payment-links/{id}/checkSavoir si le lien a été payé

200 OK

{
  "success": true,
  "paid": true,
  "status": "SUCCESS",
  "transaction": {
    "id": "cmf3m1...",
    "amount": 25000,
    "customerName": "Awa Koné",
    "customerEmail": "awa@example.com"
  }
}

Tant qu’aucun paiement n’a abouti, la réponse est { "success": true, "paid": false, "status": "WAITING" } (ou le statut de la dernière tentative). Le téléphone du client est toujours demandé sur la page, pour le Mobile Money.