Démarrage rapide

Ce guide vous permet d'accepter vos premiers paiements Orange Money Sierra Leone en une dizaine de minutes, même si vous n'avez jamais intégré de paiement auparavant.

Disponible en : Sierra Leone (Orange Money, leone — SLE). Lisez Intégrer en Sierra Leone pour la devise, les numéros de téléphone et l'expérience du payeur.

---

Le processus en un coup d'œil

Voici comment l'argent passe du compte Orange Money de votre client à votre compte :

graph LR
    A[Votre site] -- 1. Le client clique sur Payer --> B(SOAMTAR)
    B -- 2. Demande de paiement sur le téléphone du client --> C{Orange Money}
    C -- 3. Le client confirme avec son code PIN --> B
    B -- 4. Webhook signé --> A

---

Étape 1 : créer votre compte (2 min)

1. Inscrivez-vous gratuitement sur SOAMTAR Business.
2. Dans votre tableau de bord, allez dans Développeurs > Clés API.
3. Copiez votre clé publique (elle commence par pk_test_...). Elle identifie votre compte dans le navigateur.

---

Étape 2 : ajouter le bouton sur votre site (5 min)

Pas besoin de savoir programmer : copiez ce code et collez-le là où vous voulez voir le bouton.

Méthode copier-coller (sans JavaScript à écrire)

<!-- 1. Charger la bibliothèque SOAMTAR -->
<script src="https://app.so-amtar.com/sdk/soamtar.js"></script>

<!-- 2. Ajouter le bouton de paiement -->
<button
  data-soamtar
  data-soamtar-public-key="pk_test_VOTRE_CLE_ICI"
  data-soamtar-amount="50.00"
  data-soamtar-currency="SLE"
  data-soamtar-description="Achat de mon produit"
  style="background: #2ecc71; color: white; padding: 15px 30px; border: none; border-radius: 5px; cursor: pointer; font-size: 18px;">
  Payer Le 50.00
</button>

Astuce : remplacez pk_test_VOTRE_CLE_ICI par la clé copiée à l'étape 1.

Quand le client paie, Orange Money envoie une demande de paiement sur son téléphone ; il la confirme avec son code PIN Orange Money.

---

Étape 3 : vérifier que tout fonctionne (3 min)

Une fois le bouton cliqué et un paiement réussi simulé :

1. Retournez dans votre dashboard SOAMTAR.
2. Ouvrez l'onglet Paiements.
3. Votre transaction apparaît avec le statut Réussi.

---

Passer en production

Quand vos tests fonctionnent et que vous voulez recevoir de l'argent réel :

1. Dans le dashboard, basculez l'interrupteur en haut à droite sur Mode LIVE.
2. Complétez vos informations professionnelles (KYC).
3. Copiez votre nouvelle clé pk_live_....
4. Remplacez la clé de test par la clé live dans votre code. C'est fini.

Avant de basculer, parcourez la checklist de mise en production.

---

Quelle méthode d'intégration choisir ?

Si vous utilisez...	Utilisez cette méthode...
WordPress / WooCommerce	Installez notre plugin WordPress (0 ligne de code).
Un site sur mesure (HTML)	Utilisez le bouton de paiement ci-dessus.
Une application complète	Utilisez nos SDK pour développeurs et l'API Paiements.

Ensuite : recevez le résultat sur votre serveur avec les webhooks, et remboursez un paiement avec l'API Remboursements.

Besoin d'aide ?

Nos ingénieurs vous aident gratuitement à intégrer SOAMTAR. Écrivez-nous via le support !