Documentation API Mbongo.io

Intégrez facilement nos services de paiement dans vos applications, sites web et plateformes.

Authentification

Votre Clé d'API

Toutes les requêtes API nécessitent une clé d'API. Vous pouvez générer et gérer vos clés depuis votre tableau de bord marchand.

Votre clé d'API doit être incluse dans l'en-tête (header) de chaque requête, comme suit :

Authorization: Bearer VOTRE_CLE_API_SECRETE

Important : Ne partagez jamais votre clé d'API secrète et ne l'exposez pas côté client (navigateur, application mobile).

Endpoints de l'API

POST

/v1/pay

Initier un nouveau paiement vers un destinataire.

Exemple de Requête (cURL)

curl -X POST https://api.mbongo.io/v1/pay \
-H "Authorization: Bearer VOTRE_CLE_API_SECRETE" \
-H "Content-Type: application/json" \
-d '{
  "amount": 5000,
  "currency": "CDF",
  "recipient": "+243812345678",
  "description": "Paiement pour commande #123",
  "external_id": "YOUR_UNIQUE_ID_12345"
}'

Corps de la Requête (JSON)

{
  "amount": 5000,
  "currency": "CDF",
  "recipient": "+243812345678",
  "description": "Paiement pour commande #123",
  "external_id": "YOUR_UNIQUE_ID_12345"
}

Réponse en Cas de Succès (200 OK)

{
  "status": "success",
  "transaction_id": "txn_1a2b3c4d5e6f7g8h",
  "message": "Paiement initié avec succès."
}

Types d'Intégration

API REST (JSON)

L'intégration standard pour la plupart des cas d'utilisation. Idéale pour les applications web et mobiles, elle offre une flexibilité maximale.

Webhooks

Recevez des notifications en temps réel sur l'état de vos transactions (ex: paiement confirmé, échec). Utile pour synchroniser votre base de données (PostgreSQL, MySQL, etc.).