📌 Documentation API - Deposit

Endpoint

URL : /app/api/entreprise/deposit

Méthode : POST

Description : Permet d’effectuer un dépôt (top‑up) sur le compte d’un client via l’API entreprise.

📦 Payload JSON attendu

{
  "api_key":"933367984f98ada329b6",
  "transaction_id":"1781480065668",
  "client_id":"999999999",
  "amount":500,
  "action":"deposit",
  "mode":"live",
  "api_public_key":"p.19e2b8a9271771708053.11643",
  "token":"TXk4RHRQK2hGMVIxNlVCSk9Dc0pZakxtV2hyd25zbzBWVjBjWUg4U1JuUW9L..."
}

🗂️ Détails des champs

Champ Type Obligatoire Description
api_keystring✅Clé privée d’authentification du marchand
transaction_idstring✅Identifiant unique de la transaction (souvent généré en millisecondes)
client_idstring✅Identifiant du client bénéficiaire
amountfloat/int✅Montant du dépôt
actionstringâś…Action de la transaction : "deposit"
modestringâś…Mode de transaction : "live" ou "test"
api_public_keystring✅Clé publique associée au marchand
tokenstring✅Jeton sécurisé signé

📤 Exemple de requête

curl -X POST /app/api/entreprise/deposit \
-H "Content-Type: application/json" \
-d '{
  "api_key":"933367984f98ada329b6",
  "transaction_id":"1781480065668",
  "client_id":"999999999",
  "amount":500,
  "action":"deposit",
  "mode":"live",
  "api_public_key":"p.19e2b8a9271771708053.11643",
  "token":"TXk4RHRQK2hGMVIxNlVCSk9Dc0pZakxtV2hyd25zbzBWVjBjWUg4U1JuUW9L..."
}'

📥 Exemple de réponse JSON

{
  "success": true,
  "message": "Deposit accepted",
  "transaction_id": "1781480065668",
  "amount_topuped": 500,
  "fees": 25,
  "total": 525,
  "marchant_gain": 0,
  "marchant_currency": "MRU",
  "payment_date": "2026-06-14 23:34:25",
  "transaction_mode": "live",
  "token_used": "TXk4RHRQK2hGMVIxNlVCSk9Dc0pZakxtV2hyd25zbzBWVjBjWUg4U1JuUW9L...",
  "error_code": 0
}