Passer au contenu principal

SDKs & Libraries

Accélérez votre intégration en utilisant les SDK officiels pour TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby et React Native. Ces bibliothèques simplifient les requêtes API, l’authentification et la gestion des erreurs, vous permettant de vous concentrer sur la création d’excellentes expériences de paiement.

​
URLs d’environnement

En savoir plus sur Mode test vs Mode de production.

​
Gestion des clés API et authentification

1

Access API Keys

Accédez à Developer → API Keys dans votre tableau de bord pour gérer vos clés.
2

Generate a New Key

Sélectionnez Add API Key, donnez un nom descriptif et configurez l’accès en écriture :
  • Activer l’accès en écriture (coché) : Pleins droits de lecture et d’écriture pour toutes les opérations API
  • Activer l’accès en écriture (décoché) : Accès en lecture seule - peut uniquement récupérer des données (paiements, abonnements, clients, produits). Ne peut pas créer ou modifier des ressources.
Décochez “Activer l’accès en écriture” pour les intégrations du tableau de bord, les outils d’analyse et tout système qui a seulement besoin de consulter les données sans effectuer de modifications.
3

Store Your Key Securely

Copiez immédiatement la clé générée et assurez-vous qu’elle est stockée en toute sécurité.
4

Authenticate Your API Requests

Utilisez vos clés API pour authentifier toutes les requêtes. Appliquez le format d’autorisation suivant :
Authorization: Bearer YOUR_API_KEY
Ne divulguez jamais vos clés API secrètes dans du code côté client ou des dépôts publics.

​
Format de réponse

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Limites de taux

Notre API utilise un système de limitation de débit à double fenêtre avec protection contre les rafales. Les limites sont appliquées en fonction de votre méthode d’authentification et de votre niveau d’entreprise.

​
Limites par défaut (Tier 0)

FenêtreLimite
Par seconde (rafale)40 requêtes
Par minute (maintenue)240 requêtes

​
Niveaux d’entreprise

Des limites de débit plus élevées sont disponibles pour les entreprises ayant des besoins API accrus :
TierRafale (par seconde)Maintenue (par minute)
Tier 0 (Default)40240
Tier 11001,000
Tier 25005,000
Contactez le support pour faire passer votre entreprise à un niveau de limite de débit supérieur.

​
Requêtes non authentifiées

Les requêtes sans en-têtes d’authentification valides sont limitées par adresse IP :
FenêtreLimite
Par seconde (rafale)20 requêtes
Par minute (maintenue)100 requêtes

​
En-têtes de limite de débit

Surveillez votre utilisation grâce à ces en-têtes de réponse :
  • X-RateLimit-Limit - Nombre maximal de requêtes autorisées
  • X-RateLimit-Remaining - Requêtes restantes dans la fenêtre en cours
  • X-RateLimit-Reset - Moment où la limite de débit se réinitialise
Lorsque vous dépassez les limites de débit, l’API renvoie une réponse 429 Too Many Requests. Implémentez un retour en arrière exponentiel dans votre logique de nouvelle tentative.

​
Gestion des erreurs

Pour gérer efficacement les erreurs, consultez les sections Codes d’erreur et Échecs de transaction pour obtenir des conseils détaillés.

Error Codes

Approfondissez les détails complets des erreurs et leurs résolutions.

Transaction Failures

Obtenez des informations sur les problèmes de transaction courants et leurs solutions.

​
Webhooks

Recevez des notifications en temps réel sur les événements de paiement. Consultez notre Guide des webhooks pour obtenir des instructions de configuration.

Webhook Guide

Configurez des webhooks pour des notifications en temps réel et la gestion des événements.