Encaissez avec vos propres affiliations, une seule API.
Konnect orchestre vos prestataires de paiement (ClicToPay, Flouci, IZI, MPGS, Pluxee) derrière une API, une page de paiement et des plugins prêts à installer. Konnect ne détient jamais vos fonds.
Sommaire de la documentation
- GuidesDu premier paiement à la mise en production, pas à pas.
- Référence APIChaque route, ses paramètres, ses réponses et des exemples en cURL, PHP, Node et Python.
- PluginsWooCommerce, PrestaShop et WHMCS : téléchargement, somme de contrôle et installation.
- ChangelogCe qui change dans l'API, version par version.
Votre premier paiement en un appel
Créez le paiement depuis votre serveur, redirigez l'acheteur vers payUrl, puis confirmez le statut avec GET /api/v2/payments/{paymentId} quand votre webhook est appelé. Les montants sont en millimes : 120000 vaut 120,000 TND.
curl -X POST "https://api.preprod.konnect.network/api/v2/payments/init-payment" \
-H "x-api-key: $KONNECT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"receiverWalletId": "5f7a209aeb3f76490ac4a3d1",
"amount": 120000,
"token": "TND",
"description": "Order 1001",
"orderId": "order-1001",
"webhook": "https://shop.example.com/konnect/webhook"
}'Guides
- Démarrage rapideEncaisser un premier paiement en sandbox : clé API, création du paiement, redirection, webhook, vérification du statut.
- WebhooksÊtre prévenu à la fin de chaque paiement : les événements v3 signés en HMAC SHA-256, et le webhook v2 actuel.
- Erreurs et idempotenceLire une erreur v2 ou v3, savoir quand réessayer, et rejouer une création sans créer de doublon avec Idempotency-Key.
- Migrer de la v2 à la v3Ce qui ne change pas, ce qui changera et dans quel ordre passer de la v2 à la v3, sans interruption.
- Tester avec la sandboxUn environnement complet avec des affiliations fictives et des cartes de test, pour tout essayer sans argent réel.
- Mise en productionLa checklist à dérouler avant d’encaisser de vrais paiements.