📌 Documentation API - Transfert

Endpoint

URL : /app/api/entreprise/transfert

Méthode : POST

Description : Permet d’effectuer un transfert d’argent vers un bénéficiaire. Le bénéficiaire reçoit un code par SMS pour retirer les fonds.

📦 Payload JSON attendu

{
  "api_key":"9333629b6",
  "amount":500,
  "transaction_id":"1781480036693",
  "sender_name":"ALI MASALL",
  "beneficiary_phone":"99999999",
  "beneficiary_name":"GUEU PACOME",
  "beneficiary_nni":"34567898765",
  "action":"transfer",
  "mode":"live",
  "api_public_key":"p.19e2b8a9253.11643",
  "token":"TXRHNnlwb3dCS3TY1NFBPK1ZFR09QaWxvejdt..."
}

🗂️ Détails des champs

Champ	Type	Obligatoire	Description
api_key	string	✅	Clé privée d’authentification du marchand
amount	float/int	✅	Montant du transfert
transaction_id	string	✅	Identifiant unique de la transaction
sender_name	string	✅	Nom de l’expéditeur
beneficiary_phone	string	✅	Téléphone du bénéficiaire
beneficiary_name	string	✅	Nom du bénéficiaire
beneficiary_nni	string	✅	Numéro NNI du bénéficiaire
action	string	✅	Action de la transaction : "transfer"
mode	string	✅	Mode de transaction : "live" ou "test"
api_public_key	string	✅	Clé publique associée au marchand
token	string	✅	Jeton sécurisé signé

📤 Exemple de requête

curl -X POST /app/api/entreprise/transfert \
-H "Content-Type: application/json" \
-d '{
  "api_key":"9333679b6",
  "amount":500,
  "transaction_id":"1781480036693",
  "sender_name":"ALI MASALL",
  "beneficiary_phone":"99999999",
  "beneficiary_name":"GUEU PACOME",
  "beneficiary_nni":"34567898765",
  "action":"transfer",
  "mode":"live",
  "api_public_key":"p.19e2b8a9271771708053.11643",
  "token":"TXRHNnlwb3dC1NFBPK1ZFR09QaWxvejdt..."
}'

📥 Exemple de réponse JSON

{
  "success": true,
  "message": "Success, the beneficiary will receive the transaction code on his phone by sms",
  "transaction_id": "1781480036693",
  "amount_sent": 500,
  "fees": 25,
  "total": 525,
  "marchant_gain": 0,
  "marchant_currency": "MRU",
  "payment_date": "2026-06-14 23:33:56",
  "transaction_mode": "live",
  "token_used": "TXRHNnlwb3dCS3JqajBZMTRCQTFyT2JFOVYrOGc5SUE5KzdJRTY1NFBPK1ZFR09QaWxvejdt...",
  "error_code": 0
}