FAQ

Compte et onboarding

Combien de temps prend l'ouverture d'un compte ?

L'inscription prend quelques minutes. Le résultat de la vérification KYC est communiqué une fois le dossier complet (documents d'enregistrement de l'entreprise, pièce d'identité du dirigeant, coordonnées bancaires). Voir Intégrer en Sierra Leone.

Quels documents pour le KYC ?

Trois niveaux de vérification progressifs déterminent les opérations autorisées :

Niveau	Documents
1	Téléphone vérifié
2	Niveau 1 + pièce d'identité + selfie
3	Niveau 2 + coordonnées bancaires + justificatif de domicile

Les plafonds de chaque niveau sont affichés dans votre dashboard une fois le compte activé.

Mon dossier KYC est rejeté, que faire ?

Le dashboard affiche le motif. Déposez les pièces corrigées dans la section KYC. Pas de pénalité, pas de délai de carence.

Tarification

Combien coûte SOAMTAR ?

Les frais et conditions commerciales figurent dans votre contrat marchand et sont visibles dans les paramètres de votre dashboard.

Quand suis-je payé ?

Le rythme des reversements dépend du canal de paiement. Il est affiché dans votre dashboard, où vous pouvez aussi fixer un seuil minimum de reversement. Les reversements arrivent sur votre compte bancaire en Sierra Leone (numéro de compte — la Sierra Leone n'utilise pas l'IBAN).

Technique

Pourquoi envoyer une Idempotency-Key ?

Pour ne jamais faire payer un client deux fois après un timeout réseau. Sans clé explicite, SOAMTAR en dérive une de votre merchant_ref ; envoyer votre propre clé vous donne un contrôle précis. Voir Idempotence.

Que doit répondre mon endpoint de webhook ?

N'importe quel 2xx en quelques secondes. Le corps est ignoré. Tout autre code, ou un timeout, déclenche un réessai.

Combien de réessais pour un webhook ?

5 tentatives au maximum : la livraison initiale, puis des réessais après 60 s, 5 min, 30 min et 2 h. Vous pouvez relancer une livraison depuis le dashboard. Après un certain nombre d'échecs consécutifs, l'endpoint est suspendu et vous recevez un email.

Comment renvoyer un webhook manuellement ?

Dashboard → Webhooks → Logs → cliquez sur Resend sur la ligne voulue.

Puis-je avoir plusieurs endpoints de webhook ?

Oui. Chaque endpoint a son propre secret et son propre filtre d'événements.

Que se passe-t-il si je perds mon secret de webhook ?

Faites une rotation depuis le dashboard ; le nouveau secret s'affiche une seule fois. Vous pouvez aussi le récupérer via GET/v1/webhooks/{endpoint_id}/secret avec votre clé secrète (protégé par OTP en mode live depuis le dashboard).

Les clés de test et de production voient-elles les mêmes données ?

Non. Chaque clé ne voit que les objets de son mode : une clé de test ne peut pas lire un objet live, et inversement.

Puis-je rejouer une transaction sandbox en production ?

Non. Le même merchant_ref peut exister dans les deux environnements (unicité propre à chaque mode), mais les identifiants sont distincts.

Quel format pour les numéros de téléphone ?

E.164 : +232 suivi du numéro national à 8 chiffres, ex. +23276000001. Sans espace ni tiret. Les paiements sortants exigent le + initial.

Cas métier

Comment utiliser une page de paiement hébergée sans backend ?

Créez un lien de paiement depuis le dashboard. L'URL se partage directement (WhatsApp, SMS, email).

Un client en Sierra Leone peut-il payer en USD ou en EUR ?

L'API accepte SLE, USD et EUR. Orange Money Sierra Leone encaisse en leones ; si la devise demandée est différente, le taux de change est figé à l'initiation.

Combien de splits par transaction ?

Plusieurs bénéficiaires sont pris en charge. Pour un grand nombre de bénéficiaires, contactez le support.

Puis-je rembourser un paiement Orange Money ?

Oui. Appelez POST/v1/refunds avec le transaction_id du paiement (omettez amount pour un remboursement total, ou passez un montant inférieur pour un remboursement partiel). SOAMTAR recrédite l'argent sur le numéro Orange Money du payeur et le débite de votre solde. Le crédit est asynchrone : écoutez refund.success / refund.failed. Votre clé API doit avoir le scope can_refund. Voir Remboursements.

Puis-je faire un abonnement payé par Orange Money ?

Pas encore en prélèvement automatique : la tokenisation mobile money n'est pas disponible. Les abonnements peuvent fonctionner avec une demande de paiement envoyée au client à chaque échéance.

Comment résilier un abonnement ?

DELETE/v1/subscriptions/{id} (immédiat) ou ?at_period_end=true (à la fin du cycle en cours).

Conformité

SOAMTAR est-il réglementé ?

SOAMTAR opère en Sierra Leone, avec Orange Money Sierra Leone comme canal de paiement, et applique des contrôles AML (surveillance des transactions, déclarations de soupçon). Les informations réglementaires sont communiquées sur demande aux marchands institutionnels.

Les fonds des marchands sont-ils protégés ?

Les fonds en attente de reversement sont suivis dans des comptes dédiés, distincts des fonds de fonctionnement de la société.

SOAMTAR stocke-t-il des mots de passe Orange Money ?

Non. SOAMTAR utilise l'API marchand d'Orange Money avec des identifiants dédiés, jamais les codes PIN ni les identifiants de vos payeurs.

Aide

Comment contacter le support ?

• Email : support@so-amtar.com
• Chat dans le dashboard : aux heures ouvrées (heure de Freetown, GMT)