Collect with your own affiliations, through one API.
Konnect orchestrates your payment providers (ClicToPay, Flouci, IZI, MPGS, Pluxee) behind one API, one hosted payment page and ready-made plugins. Konnect never holds your funds.
Documentation contents
Your first payment in one call
Create the payment from your server, redirect the buyer to payUrl, then confirm the status with GET /api/v2/payments/{paymentId} when your webhook is called. Amounts are in millimes: 120000 is 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
- Quick startCollect a first payment in the sandbox: API key, payment creation, redirect, webhook, status check.
- WebhooksBe told when each payment ends: the v3 events signed with HMAC SHA-256, and the current v2 webhook.
- Errors and idempotencyRead a v2 or v3 error, know when to retry, and replay a creation without duplicates with Idempotency-Key.
- Migrating from v2 to v3What stays the same, what will change and in which order to move from v2 to v3, without downtime.
- Testing with the sandboxA complete environment with fictitious affiliations and test cards, to try everything without real money.
- Going liveThe checklist to run before collecting real payments.