Guide d'intégration

Ce qu'il faut savoir pour connecter votre application à DarePay : prérequis, authentification et cycle de vie d'un paiement.

Présentation de DarePay

DarePay est une API de paiement qui permet à une application cliente d'initier des paiements, de consulter leur statut et de recevoir automatiquement le résultat final d'une transaction.

L'intégration est conçue pour rester simple : votre application communique uniquement avec l'API DarePay. La gestion technique des opérateurs de paiement, des comptes de règlement et des règles de redistribution est prise en charge directement par DarePay.

Initier Créez une transaction avec POST /api/payments. Consulter Lisez le statut courant à partir de votre référence. Recevoir Obtenez le résultat final sur votre URL de callback.

Deux façons de recevoir l'argent

Mode Pour qui ? Où va l'argent payé ?
Classique La plupart des applications DarePay le répartit automatiquement entre les bénéficiaires prévus avec vous, dès que le paiement réussit.
E-commerce Boutiques en ligne, places de marché, livraison DarePay le conserve sur son compte. Votre application l'envoie ensuite à qui elle veut (vendeur, livreur, client), quand elle le décide.

Vous avez une application de vente en ligne ?Le mode e-commerce s'active sur demande auprès du support DarePay, sur WhatsApp au 074 76 97 98. Découvrir l'envoi d'argent

Avant l'intégration

Réunissez ces quatre éléments avant d'écrire la première ligne de code.

L'URL de base de l'API https://darepay.devetu.org/api
Votre clé API DarePay Attribuée à votre application par DarePay.
Votre URL de callback A founir à l'admin DarePay et qui doit être accessible en HTTPS.
Une référence métier unique Un identifiant différent pour chaque paiement.

La clé API reste côté serveurElle ne doit jamais être intégrée directement dans une application frontend publique (site web, application mobile, JavaScript exécuté dans le navigateur).

Authentification

Les routes protégées de DarePay s'authentifient avec l'en-tête HTTP X-API-Key. Envoyez ces trois en-têtes avec chaque requête :

En-têtes HTTP 
X-API-Key: VOTRE_CLE_API
Content-Type: application/json
Accept: application/json
En-tête Obligatoire Description
X-API-Key Oui Clé d'authentification attribuée à votre application.
Content-Type Oui pour les requêtes JSON Utiliser application/json.
Accept Recommandé Utiliser application/json.

Une clé absente ou invalide renvoie HTTP 401. Vérifiez alors l'en-tête X-API-Key. Voir tous les codes d'erreur.

Cycle d'un paiement

Un paiement passe par sept étapes, de la création de votre référence à la réception du callback. Cliquez sur une étape pour la situer dans le schéma.

Votre application Serveur · clé API
POST /api/payments
réponse · statut initial
callback · SUCCESS / FAILED
API DarePay Validation et suivi
initialisation
 
résultat final
Opérateurs gérés par DarePay

Statuts de paiement

Un paiement démarre en PENDING et se termine dans l'un des deux états finaux. Un état final ne change plus : DarePay empêche le remplacement de SUCCESS par FAILED, et inversement.

PENDING

Le paiement est encore en cours de traitement.

SUCCESSfinal

Le paiement a été effectué avec succès.

FAILEDfinal

Le paiement a échoué. Le motif est indiqué dans failure_reason lorsqu'il est disponible.

PENDING n'est pas un paiement réussiNe livrez rien et ne validez aucune commande tant que vous n'avez pas reçu SUCCESS par callback ou via la route de statut.

Premier appel

Voici la requête d'initiation complète. Choisissez votre langage : le choix est mémorisé sur toutes les pages.

Réponse attendue

Réponse 200 
{
  "success": true,
  "message": "Paiement initié avec succès.",
  "payment": {
    "id": 15,
    "reference": "CMD2026001",
    "transaction_id": "PAY1009261274771",
    "status": "PENDING",
    "amount": "10000.00",
    "currency": "XAF"
  }
}

Conservez le transaction_id retourné, puis attendez le callback. Pour modifier les paramètres et observer les réponses, utilisez le simulateur de la référence API.