📌 Documentation API - Historique des Transactions

Endpoint

URL : /app/api/entreprise/history

Méthode : POST

Description : Récupère l’historique des transactions d’une entreprise avec filtres et pagination.

📦 Payload JSON attendu

{
  "api_key": "933329b6",
  "api_public_key": "p.19e2b8a9208053.11643",
  "transaction_mode": "",
  "transaction_action": "",
  "beneficiary_id": "",
  "transaction_id": "",
  "date_from": "2026-06-01",
  "date_to": "2026-06-15",
  "page": 1,
  "limit": 50,
  "token": "ZXd5MThDZkdsek15aDZV..."
}

🗂️ Détails des champs

Champ	Type	Obligatoire	Description
api_key	string	✅	Clé privée d’authentification du marchand
api_public_key	string	✅	Clé publique associée au marchand
transaction_mode	string	❌	Mode : "live" ou "test"
transaction_action	string	❌	Action : "deposit", "withdraw", "transfer"
beneficiary_id	string	❌	Identifiant du bénéficiaire
transaction_id	string	❌	Identifiant unique de la transaction
date_from	date	❌	Date de début (YYYY-MM-DD)
date_to	date	❌	Date de fin (YYYY-MM-DD)
page	integer	❌	Numéro de page (défaut 1)
limit	integer	❌	Résultats par page (défaut 20)
token	string	✅	Jeton sécurisé signé

📤 Exemple de requête

curl -X POST /app/api/entreprise/history \
-H "Content-Type: application/json" \
-d '{
  "api_key": "933367984f98ada329b6",
  "api_public_key": "p.19e2b8a9271771708053.11643",
  "transaction_mode": "live",
  "transaction_action": "deposit",
  "beneficiary_id": "CLT-12345",
  "transaction_id": "",
  "date_from": "2026-06-01",
  "date_to": "2026-06-15",
  "page": 1,
  "limit": 50,
  "token": "ZXd5MThDZkdsek15aDZV..."
}'

📥 Exemple de réponse JSON

{
  "success": true,
  "page": 1,
  "limit": 50,
  "total": 120,
  "pages": 3,
  "count": 50,
  "data": [
    {
      "transaction_id": "TXN-20260615-0001",
      "transaction_mode": "live",
      "transaction_action": "deposit",
      "num_card": "CARD-987654321",
      "beneficiary_id": "CLT-12345",
      "montant_to": 60550.00,
      "frais": 2.50,
      "total": 60552.50,
      "date_trans": "2026-06-15 15:40:00",
      "details": "Dépôt|Agence Abidjan|Client123"
    }
  ]
}