Idempotency-KeyRéessayez la requête, pas le débit.
Réutilisez la même clé et le même corps pour une opération. Une autre opération nécessite une autre clé.
MTN MoMo et Orange Money, via une API. Gardez votre expérience client, connectez le paiement et ramenez le résultat dans votre activité.
Parlons de votre intégration ↗La documentation développeur publique est en préparation. Elle sera bientôt disponible.
curl -X POST https://api.kwiknkap.com/v1/payments \
-H "X-API-Key: $KWIKNKAP_API_KEY" \
-H "Idempotency-Key: order-demo-1042" \
-H "Content-Type: application/json" \
-d '{
"amount": 5000,
"phone_number": "237670000001",
"payment_method": "mobile_money",
"metadata": { "order_id": "DEMO-1042" }
}'const response = await fetch(
"https://api.kwiknkap.com/v1/payments",
{
method: "POST",
headers: {
"X-API-Key": process.env.KWIKNKAP_API_KEY,
"Idempotency-Key": "order-demo-1042",
"Content-Type": "application/json"
},
body: JSON.stringify({
amount: 5000,
phone_number: "237670000001",
payment_method: "mobile_money",
metadata: { order_id: "DEMO-1042" }
})
}
);
if (!response.ok) throw new Error("Request failed");
const payment = await response.json();
// PENDING is not a paid order.{
"id": "knpay_test_example",
"status": "PENDING",
"amount": 5000,
"currency": "XAF",
"payment_method": "mobile_money",
"environment": "SANDBOX",
"metadata": {
"order_id": "DEMO-1042"
}
}{
"id": "knpay_test_example",
"status": "SUCCESS",
"environment": "SANDBOX",
"metadata": {
"order_id": "DEMO-1042"
}
}{
"id": "evt_example",
"type": "payment.success",
"created": 1794528000,
"data": {
"id": "knpay_test_example",
"status": "SUCCESS",
"amount": 5000,
"currency": "XAF",
"environment": "SANDBOX",
"metadata": {
"order_id": "DEMO-1042"
}
}
}Votre serveur envoie le montant, le téléphone du client et le portefeuille choisi. La clé identifie votre entreprise et détermine l’environnement Sandbox ou Live.
/v1/paymentsUn paiement créé n’est pas un paiement terminé. En Live, le client valide la demande dans son portefeuille Mobile Money. Gardez la commande en attente pendant ce temps.
Demande acceptée ≠ paiement terminéConsultez l’état avec l’identifiant du paiement. SUCCESS, PENDING et FAILED décrivent des résultats différents. Utilisez metadata pour retrouver votre référence de commande.
/v1/payments/{paymentId}/statusEnregistrez le webhook dans le portail. Vérifiez la signature sur le corps brut, gérez les livraisons répétées et répondez en 2xx. Mettez ensuite la commande à jour selon le résultat vérifié.
Votre endpoint webhook HTTPSVotre intégration appartient à un compte professionnel. Le portail permet de gérer les accès, distinguer les tests de l’argent réel et examiner les résultats.
Ouvrez Développeurs et renseignez un e-mail de contact si demandé. Le mode révèle les commandes techniques et le sélecteur Sandbox / Live.
Choisissez Clés API dans Sandbox. Accordez uniquement les scopes nécessaires. Gardez le secret sur le serveur, jamais dans le navigateur ou une application mobile.
Ajoutez votre URL webhook HTTPS et choisissez les événements dans le portail. Consultez les tentatives, les réponses et les actions de renvoi dans les journaux.
Testez le cycle complet, y compris l’attente et l’échec. Terminez les vérifications requises, puis contrôlez clés Live, endpoints et permissions avant de traiter de l’argent réel.
Un paiement personnalisé, une page partageable ou une facture. Reliez chaque parcours au même compte professionnel.
POST /v1/paymentsDéclenchez un paiement MTN MoMo ou Orange Money depuis votre parcours. Le client garde le contrôle de la validation.
02POST /v1/payment-linksCréez une page à partager avec le client, puis gérez le lien et suivez ses paiements.
03POST /v1/invoicesCréez la facture, publiez-la lorsqu’elle est prête, envoyez-la et récupérez son PDF via l’API.
Idempotency-KeyRéutilisez la même clé et le même corps pour une opération. Une autre opération nécessite une autre clé.
metadata.order_idAjoutez des métadonnées textuelles au paiement. Retrouvez-les dans l’historique et le webhook pour rapprocher la commande.
X-KN-SignatureVérifiez la signature sur le corps brut d’origine. Rendez le traitement sûr en cas de répétition avant d’accuser réception.
error.request_idUtilisez les erreurs structurées et conservez l’identifiant pour l’assistance. Consultez les journaux webhook dans le portail.
Nous préparons les guides d’intégration et la référence API publics. En attendant, présentez votre produit, votre parcours de paiement et vos besoins à notre équipe.
Parler à l’équipe d’intégration ↗