API Orange Money Sénégal 2025 — Guide développeur complet

Avec plusieurs millions d'abonnés au Sénégal, Orange Money est un canal de paiement incontournable pour toute entreprise qui veut toucher l'ensemble du marché. L'API Orange Money eWallet permet d'initier des collectes et des virements directement depuis votre application.

Comment fonctionne le paiement Orange Money

Contrairement à Wave (qui utilise un lien de redirection), Orange Money fonctionne via un système d'OTP (One Time Password). Le client génère un code en composant #144#391*code_secret# sur son téléphone, puis vous saisissez ce code dans votre formulaire.

Votre formulaire demande le numéro de téléphone et l'OTP au client
Le client compose #144#391*code_secret# sur son téléphone pour générer l'OTP
Votre serveur appelle l'API Paydeck avec le numéro, l'OTP et le montant
Orange Money valide immédiatement — la réponse est synchrone
Vous recevez status: 'success' en retour direct (pas de webhook nécessaire)

📱 Le flux OTP : votre client compose #144#391*CODE_SECRET# sur son téléphone Orange Money pour générer un code à usage unique valable quelques minutes.

Intégration avec Paydeck

javascript

const payment = await client.payments.collect({
  amount: 10000,
  currency: 'XOF',
  provider: 'orange_money_sn',
  phone: '+221776543210',
  otp: '123456',              // Code OTP saisi par le client
  reference: 'facture_2025_001',
})

if (payment.status === 'success') {
  // Paiement confirmé immédiatement !
  console.log('Paiement reçu :', payment.transactionId)
}

Gérer le formulaire côté client

Le formulaire de paiement Orange Money doit guider l'utilisateur pour générer son OTP. Voici un exemple d'UI React qui explique la démarche :

jsx

function OrangeMoneForm({ onSubmit }) {
  return (
    <form onSubmit={onSubmit}>
      <div className="otp-instructions">
        <p>Composez <strong>#144#391*votre_code_secret#</strong> sur votre téléphone Orange.</p>
        <p>Un code à 6 chiffres s'affiche. Saisissez-le ci-dessous.</p>
      </div>
      <input
        type="tel"
        placeholder="Numéro Orange Money"
        pattern="^\+221[0-9]{9}$"
        required
      />
      <input
        type="text"
        placeholder="Code OTP (6 chiffres)"
        maxLength={6}
        inputMode="numeric"
        required
      />
      <button type="submit">Payer avec Orange Money</button>
    </form>
  )
}

Virements sortants Orange Money

L'API Paydeck supporte aussi les virements vers des numéros Orange Money (disbursement). Utile pour les remboursements, paiements de salaires ou de commissions.