Documentation API

Intégrez MOBILE-🟢PAY dans votre application avec notre API REST complète et bien documentée.

Démarrage rapide

1. Authentification

Obtenez une clé API et authentifiez-vous avec vos identifiants

2. Faire un appel

Utilisez nos endpoints REST pour effectuer des opérations

3. Webhooks

Recevez des notifications en temps réel des événements

Authentification

Bearer Token

Toutes les requêtes API doivent inclure un header d'autorisation avec votre token Bearer :

Authorization: Bearer YOUR_API_TOKEN

Remplacez YOUR_API_TOKEN par votre clé API réelle.

Exemple d'authentification

curl -X GET https://api.mobile-pay.ci/api/v1/balance \
  -H "Authorization: Bearer sk_live_abc123def456" \
  -H "Content-Type: application/json"

Endpoints API

POST/api/v1/auth/login

Authentifier un utilisateur

Paramètres :

emailpassword
curl -X POST https://api.mobile-pay.ci/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"password123"}'
POST/api/v1/transfers/local

Effectuer un transfert local

Paramètres :

recipient_phoneamountdescription
curl -X POST https://api.mobile-pay.ci/api/v1/transfers/local \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"recipient_phone":"+225XXXXXXXXX","amount":10000,"description":"Payment"}'
POST/api/v1/transfers/international

Effectuer un transfert international

Paramètres :

recipient_countryrecipient_phoneamount
curl -X POST https://api.mobile-pay.ci/api/v1/transfers/international \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"recipient_country":"SN","recipient_phone":"+221XXXXXXXXX","amount":50000}'
POST/api/v1/payments/qr

Créer un paiement QR code

Paramètres :

amountdescriptionmerchant_id
curl -X POST https://api.mobile-pay.ci/api/v1/payments/qr \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":25000,"description":"Purchase","merchant_id":"MERCHANT123"}'
GET/api/v1/transactions

Récupérer l'historique des transactions

Paramètres :

limitoffsetstart_dateend_date
curl -X GET "https://api.mobile-pay.ci/api/v1/transactions?limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_TOKEN"
GET/api/v1/balance

Récupérer le solde du compte

curl -X GET https://api.mobile-pay.ci/api/v1/balance \
  -H "Authorization: Bearer YOUR_TOKEN"

Webhooks

Recevez des notifications en temps réel lorsque des événements se produisent dans MOBILE-🟢PAY. Configurez votre URL de webhook pour recevoir les événements.

transfer.completed

Un transfert a été complété avec succès

{
  "event": "transfer.completed",
  "timestamp": "2026-02-26T10:30:00Z",
  "data": {
    "transfer_id": "TRF123456",
    "amount": 10000,
    "currency": "FCFA",
    "status": "completed"
  }
}

payment.received

Un paiement a été reçu

{
  "event": "payment.received",
  "timestamp": "2026-02-26T10:30:00Z",
  "data": {
    "payment_id": "PAY123456",
    "amount": 25000,
    "payer": "+225XXXXXXXXX",
    "status": "received"
  }
}

transaction.failed

Une transaction a échoué

{
  "event": "transaction.failed",
  "timestamp": "2026-02-26T10:30:00Z",
  "data": {
    "transaction_id": "TXN123456",
    "error_code": "INSUFFICIENT_FUNDS",
    "error_message": "Solde insuffisant"
  }
}

Limites de taux

Gratuit

100

par heure

Marchand

1 000

par heure

Entreprise

Illimitée

avec SLA

Si vous dépassez les limites de taux, vous recevrez une réponse HTTP 429 (Too Many Requests). Attendez avant de réessayer.

Besoin d'aide ?

Consultez notre documentation complète ou contactez notre équipe de support.