API PayCaapPuissante & Simple

Intégrez facilement les paiements mobiles africains avec notre API REST. Documentation complète, exemples de code et support technique inclus.

API Request
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

Guide de démarrage

Prêt en 3 étapes simples

Suivez ce guide pour intégrer PayCaap dans votre application en moins de 10 minutes

1

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_...
2

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
3

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

Sécurité

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
API Reference

Endpoints disponibles

Découvrez tous les endpoints de l'API PayCaap pour intégrer les paiements dans votre application

Paiements

POST
/v1/payments

Créer un nouveau paiement

amount
currency
phone
provider
GET
/v1/payments/{id}

Récupérer les détails d'un paiement

id
POST
/v1/payments/{id}/verify

Vérifier le statut d'un paiement

id

Utilisateurs

POST
/v1/users

Créer un nouvel utilisateur

name
email
phone
GET
/v1/users/{id}

Récupérer un utilisateur

id
PUT
/v1/users/{id}

Mettre à jour un utilisateur

id
name
phone

Transactions

GET
/v1/transactions

Lister toutes les transactions

limit
offset
status
GET
/v1/transactions/{id}

Détails d'une transaction

id

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

Intégrations

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é.

Webhooks

Notifications en temps réel

Recevez des notifications instantanées sur les événements de paiement dans votre application

Comment ça marche

1

Configuration

Configurez l'URL de votre endpoint dans votre dashboard

2

Événement

Un événement se produit (paiement réussi, échec, etc.)

3

Notification

PayCaap envoie une requête POST sécurisée à votre endpoint

4

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
SDKs Officiels

Intégrez en quelques lignes

SDKs maintenus par PayCaap pour tous les langages populaires. Installation rapide, documentation complète.

🟡

JavaScript

@paycaap/sdk

v2.1.0
15.2k1.2k

SDK officiel pour Node.js, React, Vue.js et autres frameworks JS

Fonctionnalités :

  • TypeScript support
  • Promesses/async-await
  • Middleware Express
  • Validation automatique
Installation
npm install @paycaap/sdk
🐘

PHP

paycaap/php-sdk

v1.8.3
8.7k891

SDK pour PHP 7.4+ avec support Laravel, Symfony et frameworks populaires

Fonctionnalités :

  • PSR-4 autoload
  • Support Laravel
  • Guzzle HTTP
  • Validation Symfony
Installation
composer require paycaap/php-sdk
🐍

Python

paycaap

v1.5.2
6.3k567

SDK Python 3.7+ avec support Django, Flask et FastAPI

Fonctionnalités :

  • Type hints
  • Async/await
  • Django integration
  • Pydantic models
Installation
pip install paycaap
🔵

Go

github.com/paycaap/go-sdk

v0.9.1
2.1k234

SDK Go avec support des contextes et erreurs typées

Fonctionnalités :

  • Context support
  • Typed errors
  • HTTP client
  • JSON marshaling
Installation
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

Test & Debug

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

+225000000001
orange money
Paiement réussi
+225000000002
orange money
Paiement échoué
+225000000003
mtn money
Paiement en attente
+225000000004
wave
Paiement annulé

Cartes de test

4242424242424242
Visa - Succès
CVC: 123 | Exp: 12/25
4000000000000002
Visa - Décliné
CVC: 123 | Exp: 12/25
5555555555554444
Mastercard - Succès
CVC: 123 | Exp: 12/25

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