API PayCaapPuissante & Simple
Intégrez facilement les paiements mobiles africains avec notre API REST. Documentation complète, exemples de code et support technique inclus.
curl -X POST https://api.paycaap.com/v1/payments \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "currency": "XOF", "phone": "+225123456789", "provider": "orange_money", "description": "Achat produit" }'
Intégration rapide
Prêt en 5 minutes
100% Sécurisé
Chiffrement SSL
Prêt en 3 étapes simples
Suivez ce guide pour intégrer PayCaap dans votre application en moins de 10 minutes
Inscription & Clés API
Créez votre compte développeur et obtenez vos clés d'API
# Clés disponibles dans votre dashboard
PAYCAAP_PUBLIC_KEY=pk_test_...
PAYCAAP_SECRET_KEY=sk_test_...
Installation
Installez notre SDK ou utilisez directement l'API REST
# SDK PHP
composer require paycaap/php-sdk
# SDK JavaScript
npm install @paycaap/sdk
# SDK Python
pip install paycaap
Premier paiement
Effectuez votre première transaction de test
const paycaap = new PayCaap(process.env.PAYCAAP_SECRET_KEY);
const payment = await paycaap.payments.create({
amount: 1000,
currency: 'XOF',
phone: '+225123456789',
provider: 'orange_money'
});
Besoin d'aide pour commencer ?
Notre équipe technique est disponible pour vous accompagner dans l'intégration
Authentification API
PayCaap utilise des clés API pour authentifier les requêtes. Vos clés sont disponibles dans votre dashboard développeur.
Clé publique
Utilisée côté client pour les paiements sécurisés. Commence par pk_
pk_test_1234567890abcdef
Clé secrète
Utilisée côté serveur uniquement. Commence par sk_
sk_test_abcdef1234567890
Sécurité
Ne jamais exposer votre clé secrète côté client ou dans le code source public.
- • Variables d'environnement
- • Serveur backend uniquement
- • Rotation régulière
Exemples d'authentification
Ajoutez le header Authorization avec votre clé secrète à toutes vos requêtes API
curl -X GET https://api.paycaap.com/v1/account \
-H "Authorization: Bearer sk_test_your_secret_key_here" \
-H "Content-Type: application/json"
Environnements de test et production
🧪 Test
Utilisez les clés de test pour développer et tester votre intégration
- • Aucune transaction réelle
- • Simulation des opérateurs
- • Données de test disponibles
🚀 Production
Passez en production avec vos clés live après validation
- • Transactions réelles
- • Connexion aux opérateurs
- • Support technique 24/7
Endpoints disponibles
Découvrez tous les endpoints de l'API PayCaap pour intégrer les paiements dans votre application
Paiements
/v1/payments
Créer un nouveau paiement
/v1/payments/{id}
Récupérer les détails d'un paiement
/v1/payments/{id}/verify
Vérifier le statut d'un paiement
Utilisateurs
/v1/users
Créer un nouvel utilisateur
/v1/users/{id}
Récupérer un utilisateur
/v1/users/{id}
Mettre à jour un utilisateur
Transactions
/v1/transactions
Lister toutes les transactions
/v1/transactions/{id}
Détails d'une transaction
Exemples de requêtes
Testez nos endpoints avec ces exemples de code dans différents langages
curl -X POST https://api.paycaap.com/v1/payments \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 5000,
"currency": "XOF",
"phone": "+225123456789",
"provider": "orange_money",
"description": "Achat produit"
}'
Explorez l'API complète
Plus de 25 endpoints disponibles pour gérer les paiements, utilisateurs, webhooks et bien plus
Exemples d'intégration
Intégrez PayCaap dans votre stack technologique avec ces exemples prêts à utiliser
React/Next.js
Intégration moderne avec React Hooks
import { useState } from 'react';
import { PayCaapProvider, usePayCaap } from '@paycaap/react';
function PaymentForm() {
const [amount, setAmount] = useState(1000);
const { processPayment, isLoading } = usePayCaap();
const handlePayment = async () => {
try {
const result = await processPayment({
amount,
currency: 'XOF',
phone: '+225123456789',
provider: 'orange_money'
});
console.log('Paiement réussi:', result);
} catch (error) {
console.error('Erreur:', error);
}
};
return (
<div className="payment-form">
<input
type="number"
value={amount}
onChange={(e) => setAmount(e.target.value)}
placeholder="Montant"
/>
<button
onClick={handlePayment}
disabled={isLoading}
>
{isLoading ? 'Traitement...' : 'Payer maintenant'}
</button>
</div>
);
}
Templates de démarrage
Projets complets avec PayCaap pré-configuré pour chaque framework
SDKs officiels
Librairies maintenues par PayCaap pour tous les langages populaires
Demos interactives
Testez nos intégrations directement dans votre navigateur
Votre framework n'est pas listé ?
Notre API REST fonctionne avec tous les langages de programmation. Contactez-nous pour un exemple personnalisé.
Notifications en temps réel
Recevez des notifications instantanées sur les événements de paiement dans votre application
Comment ça marche
Configuration
Configurez l'URL de votre endpoint dans votre dashboard
Événement
Un événement se produit (paiement réussi, échec, etc.)
Notification
PayCaap envoie une requête POST sécurisée à votre endpoint
Traitement
Votre application traite l'événement et répond 200 OK
Sécurité
Signatures HMAC
Chaque webhook est signé avec votre secret pour garantir l'authenticité
HTTPS obligatoire
Tous les webhooks sont envoyés uniquement vers des URLs HTTPS
Retry automatique
Jusqu'à 5 tentatives avec backoff exponentiel en cas d'échec
Idempotence
Chaque événement a un ID unique pour éviter les doublons
Événements disponibles
Liste complète des événements que vous pouvez recevoir via webhooks
payment.succeeded
Paiement réussi et confirmé
payment.failed
Échec du paiement
payment.pending
Paiement en attente de confirmation
payment.cancelled
Paiement annulé par l'utilisateur
Exemples d'implémentation
Code prêt à utiliser pour gérer les webhooks dans votre application
// Configuration de votre endpoint webhook
const express = require('express');
const crypto = require('crypto');
const app = express();
app.use(express.raw({ type: 'application/json' }));
app.post('/webhooks/paycaap', (req, res) => {
const sig = req.headers['x-paycaap-signature'];
const payload = req.body;
// Vérification de la signature
const expectedSig = crypto
.createHmac('sha256', process.env.PAYCAAP_WEBHOOK_SECRET)
.update(payload)
.digest('hex');
if (sig !== expectedSig) {
return res.status(400).send('Signature invalide');
}
const event = JSON.parse(payload);
switch (event.type) {
case 'payment.succeeded':
handlePaymentSucceeded(event.data);
break;
case 'payment.failed':
handlePaymentFailed(event.data);
break;
default:
console.log('Événement non géré:', event.type);
}
res.status(200).send('OK');
});
Bonnes pratiques
- • Vérifiez toujours la signature pour garantir l'authenticité
- • Idempotence : Traitez chaque événement une seule fois
- • Répondez rapidement : Timeout de 30 secondes maximum
- • Gestion d'erreur : Implémentez une logique de retry côté client
- • Logging : Enregistrez tous les événements pour le débogage
Intégrez en quelques lignes
SDKs maintenus par PayCaap pour tous les langages populaires. Installation rapide, documentation complète.
JavaScript
@paycaap/sdk
SDK officiel pour Node.js, React, Vue.js et autres frameworks JS
Fonctionnalités :
- TypeScript support
- Promesses/async-await
- Middleware Express
- Validation automatique
npm install @paycaap/sdk
PHP
paycaap/php-sdk
SDK pour PHP 7.4+ avec support Laravel, Symfony et frameworks populaires
Fonctionnalités :
- PSR-4 autoload
- Support Laravel
- Guzzle HTTP
- Validation Symfony
composer require paycaap/php-sdk
Python
paycaap
SDK Python 3.7+ avec support Django, Flask et FastAPI
Fonctionnalités :
- Type hints
- Async/await
- Django integration
- Pydantic models
pip install paycaap
Go
github.com/paycaap/go-sdk
SDK Go avec support des contextes et erreurs typées
Fonctionnalités :
- Context support
- Typed errors
- HTTP client
- JSON marshaling
go get github.com/paycaap/go-sdk
Démarrage rapide avec les SDKs
Exemples de code pour créer votre premier paiement avec chaque SDK
import PayCaap from '@paycaap/sdk';
const paycaap = new PayCaap(process.env.PAYCAAP_SECRET_KEY);
// Créer un paiement
const payment = await paycaap.payments.create({
amount: 5000,
currency: 'XOF',
phone: '+225123456789',
provider: 'orange_money',
description: 'Achat produit'
});
console.log('Paiement créé:', payment.id);
// Vérifier le statut
const updatedPayment = await paycaap.payments.retrieve(payment.id);
console.log('Statut:', updatedPayment.status);
Open Source
Tous nos SDKs sont open source et acceptent les contributions
Mises à jour
Nouvelles fonctionnalités et corrections de bugs régulières
Votre langage ?
Demandez un SDK pour votre langage préféré
Support et communauté
Rejoignez notre communauté de développeurs et obtenez de l'aide pour vos intégrations
Environnement de test
Testez votre intégration PayCaap avec nos outils de développement et données de test
Testeur d'API interactif
Testez nos endpoints directement depuis cette page
Numéros de test Mobile Money
Cartes de test
Outils de développement
Accélérez votre développement avec nos outils dédiés
Postman Collection
Collection complète pour tester tous nos endpoints
Simulateur
Interface web pour simuler tous les scénarios
Validateur
Vérifiez vos webhooks et signatures
CLI Tool
Outil en ligne de commande pour les développeurs
Prêt pour la production ?
Une fois vos tests terminés, passez en mode production avec vos vraies clés API