Guide d'utilisation

Production
Comment ça marche ?
Le guide complet pour comprendre et utiliser la plateforme Neka Paie.

Vue d'ensemble du parcours

Pour l'administrateur Neka Paie
  1. Configurer une filiale (pays + credentials Orange OAuth)
  2. Créer un marchand (raison sociale + API Key/Secret générés)
  3. Activer le compte après validation KYC
  4. Surveiller les transactions et alertes en temps réel
  5. Lancer la réconciliation J+1 chaque matin
  6. Auditer les opérations dans le journal d'audit
Pour le marchand intégrateur
  1. Récupérer ses clés API dans l'espace marchand
  2. Configurer son URL webhook HTTPS
  3. Signer ses requêtes en HMAC-SHA256
  4. Appeler POST /payments/cashin depuis son backend
  5. Gérer le webhook reçu et mettre à jour sa commande
  6. Réconcilier via GET /transactions/export

Schéma global du flux Cash-In

FLUX┌──────────┐                    ┌──────────┐                    ┌──────────┐
│ Site     │  1. POST /cashin   │ Neka Paie │  2. OAuth + init   │  Orange  │
│ Marchand ├───────────────────►│ API      ├───────────────────►│  Money   │
│          │                    │          │                    │          │
│          │  3. payment_url    │          │                    │          │
│          │◄───────────────────┤          │                    │          │
└──────────┘                    └──────────┘                    └─────┬────┘
     │                                                                 │
     │ 4. redirect client                                              │
     ▼                                                                 │
┌──────────┐                                                          │
│  Client  │  5. saisie PIN USSD ou paiement Web                      │
│  final   ├───────────────────────────────────────────────────────►  │
└──────────┘                                                          │
                                                                       │
                                ┌──────────┐  6. webhook              │
                                │ Neka Paie │◄─────────────────────────┘
                                │ Webhook  │
                                │ Receiver │  7. déduplication +
                                └────┬─────┘     mise à jour
                                     │
                                     │ 8. signature HMAC + POST
                                     ▼
                                ┌──────────┐
                                │ Webhook  │  9. acquittement 2xx
                                │ Marchand │
                                └──────────┘