Glossaire
| Terme | Définition |
|---|---|
| Agrégateur | Plateforme qui expose des canaux de paiement derrière une seule API. SOAMTAR en est un. |
| Clé API | Jeton Bearer qui authentifie les requêtes : sk_test_... / sk_live_... sur votre serveur, pk_test_... / pk_live_... dans le navigateur. |
| Client (Customer) | Profil payeur persistant, propre à un marchand. |
| Code PIN | Code secret que le client saisit sur son téléphone pour confirmer un paiement Orange Money. SOAMTAR ne le voit jamais. |
| Disputed | Statut d'une transaction faisant l'objet d'un litige ouvert. |
| E.164 | Format international des numéros. En Sierra Leone : +232 suivi de 8 chiffres, ex. +23276000001. |
| Endpoint | URL à laquelle SOAMTAR envoie les webhooks d'un marchand. |
| Fee amount | Frais facturés au marchand par SOAMTAR. |
| Heure de Freetown | Africa/Freetown, GMT toute l'année (pas d'heure d'été). |
| HMAC | Hash-based Message Authentication Code, l'algorithme de signature des webhooks. |
| Idempotency-Key | Header sur POST/PUT/PATCH/DELETE qui rend les réessais sûrs. |
| Internal ref | Référence SOAMTAR d'une transaction (TXN-...). |
| KYC | Know Your Customer : vérification d'identité par niveaux progressifs. |
Leone (SLE) | Monnaie de la Sierra Leone. Deux décimales (0,01 SLE est la plus petite unité). S'écrit Le 1,250.00. |
| Litige (chargeback) | Contestation d'un paiement par le client. |
| livemode | Booléen présent dans les réponses de l'API : true = production, false = sandbox. |
| Merchant ref | Référence libre choisie par le marchand (idempotence métier). |
| Orange Money Sierra Leone | Le service mobile money qu'utilise SOAMTAR pour les encaissements et les paiements sortants (orange_money_sl). |
| Page de paiement hébergée | Page de paiement hébergée par SOAMTAR (hosted checkout). |
| Paiement sortant (payout) | Virement du solde marchand vers un compte Orange Money. |
| Rapprochement | Vérification périodique auprès d'Orange Money pour rattraper les webhooks perdus. |
| Remboursement | Restitution des fonds d'une transaction success — créée avec POST/v1/refunds (totale ou partielle) et recréditée sur le portefeuille Orange Money du payeur. |
| Reversement (settlement) | Virement du solde marchand vers le compte bancaire du marchand. |
| Salone | Nom courant de la Sierra Leone en krio. |
| Sandbox | Environnement de test, clés sk_test_..., aucun argent réel ne circule. |
| SLL | Ancien code du leone. Le leone a été redénominé en 2022 (1 SLE = 1 000 SLL) ; envoyez toujours SLE. |
| Soft delete | Suppression logique : aucun enregistrement n'est effacé physiquement. |
| Split | Répartition d'une transaction entre plusieurs marchands bénéficiaires. |
| Abonnement | Facturation récurrente sur un plan. |
| Webhook | Notification HTTP signée envoyée par SOAMTAR à un endpoint marchand. |