Démarrage rapide

1. Obtenez votre clé API

Connectez-vous sur app.alphapay.me et copiez votre clé API secrète depuis la section Développeur de votre tableau de bord.

Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx

Utilisez une clé sk_test_... pour tester sans argent réel, sk_live_... une fois prêt à encaisser en production.

2. Découvrez les pays et réseaux supportés

Avant d’initier un paiement, vérifiez quels réseaux mobile money sont disponibles dans le pays de votre client. Cet appel ne nécessite aucune authentification.

curl https://api.alphapay.me/api/v1/countries/

Repérez le code du réseau qui vous intéresse (ex. mtn_bj pour MTN Bénin) via Liste des réseaux.

3. Encaissez un paiement

Deux façons d’encaisser sont disponibles selon votre intégration.

Softpay (direct)
Checkout hébergé

Poussez directement une demande de paiement sur le téléphone du client — idéal si vous avez déjà son numéro et son réseau.

curl -X POST https://api.alphapay.me/api/v1/payments/softpay/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -d '{
    "amount": "2500.00",
    "currency": "XOF",
    "country": "BJ",
    "network": "mtn_bj",
    "description": "Abonnement mensuel",
    "customer": {
      "email": "client@example.com",
      "first_name": "Awa",
      "last_name": "Sossou",
      "phone": "+22997505050"
    }
  }'

Réponse

{ "message": "Payment pushed successfully", "id": "b1f2c3d4-...", "status": "PENDING", "checkout_url": "" }

checkout_url est vide ici parce que MTN Bénin fonctionne en push. Sur Wave, Orange Money, Djamo ou une carte bancaire, elle sera non vide et vous devrez y rediriger votre client — sinon aucun paiement n’a lieu. Testez toujours ce champ.

Le header Idempotency-Key est optionnel, mais vivement recommandé ici : sans lui, un retry réseau crée un second paiement réel. Générez un identifiant unique (UUID par exemple) par tentative. Voir Idempotence.

Le client reçoit l’invite de paiement directement sur son téléphone (USSD ou notification, selon le réseau). Suivez ensuite l’étape 4 pour connaître le résultat.

Générez une page de paiement à laquelle rediriger votre client — idéal si vous ne voulez pas gérer l’interface de paiement vous-même.

curl -X POST https://api.alphapay.me/api/v1/checkout-sessions/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5000.00",
    "currency": "XOF",
    "description": "Facture #1042",
    "customer_email": "client@example.com",
    "customer_name": "Awa Sossou",
    "return_url": "https://votre-site.com/merci"
  }'

Réponse

{ "id": "c9a1...", "slug": "kZ2v9rT4bQxL8mNpYw==", "checkout_url": "https://pay.alphapay.me/checkout/kZ2v9rT4bQxL8mNpYw==", "status": "PENDING" }

Redirigez votre client vers checkout_url — il y choisit son réseau et confirme le paiement lui-même.

return_url est optionnel mais fortement recommandé : sans lui, votre client reste bloqué sur la page de succès AlphaPay après paiement, sans moyen de revenir chez vous. Si vous le fournissez, il est automatiquement redirigé vers cette URL 3 secondes après un paiement réussi. Ce n’est pas encore le cas sur un paiement échoué — dans ce cas le client voit un bouton “Réessayer” et doit fermer l’onglet lui-même.

4. Vérifiez le résultat

Ne faites jamais confiance à un simple délai — interrogez toujours le statut réel avant de considérer un paiement comme réussi.

curl https://api.alphapay.me/api/v1/payments/b1f2c3d4-.../verify/ \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx"

Réponse

{ "message": "Payment transaction fetched successfully", "id": "b1f2c3d4-...", "status": "SUCCESS", "net_amount": "2500.00", "currency": "XOF" }

Plutôt que d’interroger cet endpoint en boucle, configurez un webhook pour être notifié en temps réel dès que le statut change.

Prochaines étapes

Paiements

Softpay, checkout hébergé, retry, confirmation OTP

Retraits

Payer un bénéficiaire en mobile money

Webhooks

Recevez vos événements en temps réel

Créer un compte

Inscription, KYC, première clé API

​1. Obtenez votre clé API

​2. Découvrez les pays et réseaux supportés

​3. Encaissez un paiement

​4. Vérifiez le résultat

​Prochaines étapes

Paiements

Retraits

Webhooks

Créer un compte

1. Obtenez votre clé API

2. Découvrez les pays et réseaux supportés

3. Encaissez un paiement

4. Vérifiez le résultat

Prochaines étapes