Passer au contenu principal

​
Prérequis

Avant de commencer, assurez-vous d’avoir :

Compte Yabetoo

Créez un compte si ce n’est pas déjà fait

Clés API

Obtenez vos clés API de test depuis le Dashboard
Ne partagez jamais votre clé API secrète publiquement. Utilisez des variables d’environnement pour les stocker en toute sécurité.

​
Étape 1 : Obtenez vos clés API

1

Connectez-vous à votre Dashboard

Allez sur app.yabetoo.com et connectez-vous à votre compte
2

Accédez aux clés API

Cliquez sur Paramètres > Clés API dans la barre latérale
3

Copiez vos clés de test

Copiez votre clé secrète de test (commence par sk_test_)
Les clés de test vous permettent de simuler des paiements sans argent réel. Utilisez-les pendant le développement.

​
Étape 2 : Installez un SDK (optionnel)

Choisissez votre langage préféré : 
npm install @yabetoo/sdk-js

​
Étape 3 : Créez votre premier paiement

​
Option A : Page de paiement hébergée (Recommandé)

Le moyen le plus rapide d’accepter des paiements. Redirigez vos clients vers une page hébergée par Yabetoo. 
curl -X POST https://buy.api.yabetoopay.com/v1/sessions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_test_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -d '{
    "total": 5000,
    "currency": "xaf",
    "accountId": "acct_xxxxxxxx",
    "successUrl": "https://votre-site.com/succes",
    "cancelUrl": "https://votre-site.com/annuler",
    "items": [{
      "productId": "prod_123",
      "productName": "Plan Premium",
      "quantity": 1,
      "price": 5000
    }]
  }'

​
Option B : Intégration personnalisée

Pour un contrôle total sur l’expérience de paiement, utilisez l’API Payment Intent. 
# Étape 1 : Créer l'intention de paiement
curl https://pay.sandbox.yabetoopay.com/v1/payment-intents \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_test_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -d '{
    "amount": 5000,
    "currency": "xaf",
    "description": "Abonnement Plan Premium"
  }'

# Étape 2 : Confirmer avec le moyen de paiement du client
curl https://pay.sandbox.yabetoopay.com/v1/payment-intents \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_test_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -d '{
    "client_secret": "pi_xxx_secret_yyy",
    "first_name": "Jean",
    "last_name": "Dupont",
    "receipt_email": "[email protected]",
    "payment_method_data": {
      "type": "momo",
      "momo": {
        "country": "cg",
        "msisdn": "242123456789",
        "operator_name": "mtn"
      }
    }
  }'

​
Étape 4 : Testez votre intégration

Utilisez ces numéros de téléphone de test en mode sandbox :
Numéro de téléphoneComportement
242000000001Réussit toujours
242000000002Échoue toujours (fonds insuffisants)
242000000003En attente 30 secondes, puis réussit
Consultez votre Dashboard pour voir toutes les transactions de test en temps réel.

​
Étape 5 : Passez en production

Quand vous êtes prêt à accepter de vrais paiements :
1

Complétez la vérification du compte

Soumettez vos documents d’entreprise dans le Dashboard
2

Passez aux clés de production

Remplacez sk_test_ par sk_live_ dans votre code
3

Mettez à jour les endpoints webhook

Pointez les webhooks vers votre serveur de production
Félicitations ! Vous êtes maintenant prêt à accepter des paiements avec Yabetoo.

​
Prochaines étapes

Gérer les Webhooks

Soyez notifié quand les paiements sont complétés

Explorer les SDKs

Découvrez toutes les fonctionnalités des SDKs

Référence API

Documentation API complète

Gestion des erreurs

Gérez les erreurs avec élégance