Prérequis
Avant de commencer, assurez-vous d’avoir :
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
Connectez-vous à votre Dashboard
Accédez aux clés API
Cliquez sur Paramètres > Clés API dans la barre latérale
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": "jean@example.com",
"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éphone | Comportement |
|---|
242000000001 | Réussit toujours |
242000000002 | Échoue toujours (fonds insuffisants) |
242000000003 | En 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 :
Complétez la vérification du compte
Soumettez vos documents d’entreprise dans le Dashboard
Passez aux clés de production
Remplacez sk_test_ par sk_live_ dans votre code
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
