Idempotence stricte
La même clé d’idempotence ne crée jamais deux paiements — et elle est refusée si on la réutilise pour un montant différent.
Développeurs — API
Six routes. C’est un choix.
Créer un paiement, le lire, le lister, le rembourser, lire son compte, verser une part. Tout le reste — boutiques, caisses, plugins — n’est qu’un adaptateur au-dessus de ces routes.
La surface complète
| Méthode | Route | Ce qu’elle fait |
|---|---|---|
| POST | /paiements | Créer un paiement — rend l’adresse de sa page |
| GET | /paiements/:code | Lire un paiement et son état |
| GET | /paiements | Lister ses paiements |
| POST | /paiements/:code/remboursements | Rembourser |
| GET | /compte | Lire son compte |
| POST | /repartition/versements | Verser une part (secteur public) |
Créer un paiement
POST /v1/paiements
Authorization: Bearer sk_test_************
Content-Type: application/json
{
"montant": 150000,
"motif": "Commande n° 48",
"cle_idempotence": "commande-48"
}
→ 201
{
"code": "2*******",
"etat": "en_attente",
"url_checkout": "https://pay.fadjia.com/c/2*******"
}Aperçu illustratif — la documentation complète arrive avec l’espace développeur.
Les règles qui tiennent en production
Une clé publique ne peut pas encaisser
Les routes d’argent exigent une clé secrète. Une clé publique y est refusée, explicitement.
Des erreurs qui se lisent
Toujours du JSON structuré — code et message. Jamais une page HTML là où votre code attend une réponse.
Test et production séparés
Aucun franc réel ne passe par une clé de test. Vous développez sans risque, puis vous basculez.