Passer au contenu principal

​
Bienvenue dans l’API Yabetoo

L’API Yabetoo est organisée autour des principes REST, avec des URL orientées ressources prévisibles, des corps de requête et de réponse JSON, et des codes de réponse HTTP standard. Notre API est conçue pour être simple, sécurisée et conviviale pour les développeurs.

URL de base

Toutes les requêtes API doivent être effectuées vers : https://api.yabetoopay.com

​
Démarrage rapide

Commencez avec l’API Yabetoo en quelques minutes :
1

Obtenez vos clés API

Inscrivez-vous et obtenez vos clés API depuis le tableau de bord développeur
2

Effectuez votre première requête

Testez l’API en créant une session de checkout ou une intention de paiement
3

Gérez les webhooks

Configurez des webhooks pour recevoir des notifications en temps réel sur les événements de paiement

​
Authentification

Tous les endpoints de l’API nécessitent une authentification en utilisant votre clé API secrète. Incluez votre clé dans l’en-tête Authorization de chaque requête : 
Authorization: Bearer votre_cle_secrete_ici
N’exposez jamais vos clés API secrètes dans le code côté client. Effectuez toujours les appels API depuis votre serveur.

​
Format des requêtes

L’API Yabetoo accepte des corps de requête au format JSON et retourne des réponses JSON. Incluez toujours l’en-tête Content-Type approprié : 
Content-Type: application/json

​
Exemple de requête

curl -X POST "https://api.yabetoopay.com/v1/checkout-sessions" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2000,
    "currency": "EUR",
    "success_url": "https://votresite.com/success",
    "cancel_url": "https://votresite.com/cancel"
  }'

​
Ressources principales

​
Sessions de checkout

Créez des pages de paiement hébergées sécurisées pour accepter les paiements sans gérer les données de carte sensibles.

Sessions de checkout

Créez et gérez des sessions de checkout pour les paiements hébergés

​
Intentions de paiement

Construisez des flux de paiement personnalisés avec un contrôle total sur le processus de paiement.

Intentions de paiement

Créez et confirmez des intentions de paiement pour des intégrations avancées

​
Décaissements

Transférez des fonds de votre compte vers les comptes clients pour les scénarios de place de marché et de plateforme.

Décaissements

Envoyez de l’argent aux clients ou partenaires

​
Transferts de fonds

Activez les transferts d’argent internationaux avec notre API de transfert de fonds.

Transferts de fonds

Traitez les paiements et transferts transfrontaliers

​
Webhooks

Recevez des notifications en temps réel sur les événements de votre compte.

Webhooks

Configurez des endpoints pour recevoir des notifications d’événements

​
Codes de statut HTTP

L’API Yabetoo utilise les codes de statut HTTP standard pour indiquer le succès ou l’échec :
CodeDescription
200Succès - Requête complétée avec succès
201Créé - Ressource créée avec succès
400Requête incorrecte - Paramètres de requête invalides
401Non autorisé - Clé API invalide ou manquante
402Paiement requis - Fonds insuffisants ou paiement échoué
403Interdit - Accès refusé
404Non trouvé - Ressource non trouvée
429Trop de requêtes - Limite de débit dépassée
500Erreur serveur interne - Quelque chose s’est mal passé de notre côté

​
Gestion des erreurs

Lorsqu’une erreur se produit, l’API retourne un objet JSON avec les détails de l’erreur : 
{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing",
    "message": "Paramètre requis manquant : amount",
    "param": "amount"
  }
}

​
Types d’erreurs

  • api_error - Problèmes avec notre API
  • authentication_error - Problèmes avec votre clé API
  • invalid_request_error - Paramètres ou format invalides
  • rate_limit_error - Trop de requêtes
  • payment_error - Échec du traitement du paiement

​
Limitation du débit

L’API Yabetoo implémente une limitation du débit pour assurer une utilisation équitable :
  • Mode test : 100 requêtes par minute
  • Mode production : 1000 requêtes par minute
Les informations de limite de débit sont incluses dans les en-têtes de réponse : 
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

​
Pagination

Les endpoints de liste supportent la pagination en utilisant les paramètres limit et offset : 
GET /v1/payment-intents?limit=20&offset=40
La réponse inclut les métadonnées de pagination : 
{
  "data": [...],
  "has_more": true,
  "total": 150
}

​
Idempotence

Réessayez les requêtes en toute sécurité en incluant un en-tête Idempotency-Key avec une valeur unique : 
Idempotency-Key: votre-cle-unique-ici
Cela empêche le traitement en double si vous devez réessayer une requête.

​
Versioning

La version actuelle de l’API est v1. Nous maintenons la compatibilité ascendante et annonçons les changements bien à l’avance. Spécifiez la version de l’API dans vos requêtes : 
GET https://api.yabetoopay.com/v1/payment-intents

​
SDK et bibliothèques

Accélérez votre intégration avec nos SDK officiels :

SDK PHP

Bibliothèque PHP officielle pour l’intégration côté serveur

SDK Java

SDK Java prêt pour l’entreprise

​
Tests

Utilisez notre environnement sandbox pour tester votre intégration sans traiter de vrais paiements :
  • Clé API de test : Commence par sk_test_
  • Endpoint de test : Identique à la production (https://api.yabetoopay.com)
  • Cartes de test : Utilisez nos numéros de carte de test

​
Support

Besoin d’aide avec l’API ?
  • Documentation : Guides complets et exemples
  • Support développeur : Contactez notre équipe technique
  • Page de statut : Vérifiez le statut et la disponibilité de l’API
  • Communauté : Rejoignez notre communauté de développeurs
Cette référence API fournit une documentation complète pour tous les endpoints de l’API Yabetoo. Chaque endpoint inclut des exemples de requête/réponse, des descriptions de paramètres et des codes d’erreur.
⌘I