Skip to main content
GET
/
v1
/
payments
/
search
Rechercher un paiement
curl --request GET \
  --url https://api.example.com/v1/payments/search

​
Rechercher un paiement

Permet de retrouver un paiement en utilisant votre propre référence (client_reference). Cet endpoint est particulièrement utile pour la réconciliation automatique.

​
Query Parameters

ParamètreTypeRequisDescription
client_referencestring✅Votre référence interne (ex: ID de commande)

​
Exemple

curl -X GET "https://api.sahelpay.ml/v1/payments/search?client_reference=order_123" \
  -H "Authorization: Bearer sk_live_xxx"

​
Réponse

Retourne le paiement le plus récent correspondant à cette référence. 
{
  "success": true,
  "data": {
    "id": "txn_8f525b9f",
    "client_reference": "order_123",
    "status": "SUCCESS",
    "amount": 5000,
    "currency": "XOF",
    "payment_method": "ORANGE_MONEY",
    "created_at": "2025-12-19T10:00:00Z",
    "updated_at": "2025-12-19T10:05:00Z"
  }
}

​
Erreurs

CodeDescription
MISSING_REFERENCELe paramètre client_reference est requis
NOT_FOUNDAucun paiement trouvé avec cette référence