SDKs officiels

Les SDKs serveur (Node, Python, PHP) couvrent :

• Payment Intents : création, lecture, listing, pagination
• Payouts : standard (adresse externe), transferts internes, remboursements
• Invoices : création, renvoi, annulation, listing
• Products : création, mise à jour, désactivation
• Settlements / Wallet / Assets : reversements, soldes, catalogue d’actifs
• Webhooks : vérification de signature constant-time, anti-replay

Ne sont pas dans les SDKs (par design) :

• Création / rotation / révocation de clés API → dashboard only (séparation credential / consommateur)
• Configuration des webhook endpoints → dashboard only
• Gestion KYB → dashboard only (process humain)

​

Pourquoi utiliser un SDK ?

Comparé à appeler l’API REST directement (fetch, axios, requests, cURL…), les SDKs officiels apportent :

• Idempotency-Key auto-générée pour chaque POST
• Retry automatique sur 5xx / 429 avec backoff exponentiel + jitter
• Erreurs typées : branchez sur le type d’erreur (auth, validation, rate-limit…) plutôt que d’analyser des codes de statut
• Pagination par curseur : itérateurs qui parcourent toutes les pages automatiquement
• Webhook validator : implémentation constant-time + anti-replay vérifiée
• Zéro dépendance : Node (fetch natif), Python (stdlib), PHP (cURL/json)

Le SDK Node ajoute en plus le typage TypeScript complet (auto-complétion IDE, validation compile-time des paramètres).

​

Versioning

Les SDKs suivent Semantic Versioning. Ils sont en 0.1.x : avant la 1.0, l’API d’un SDK peut casser entre versions mineures. L’API REST sous-jacente, elle, ne change pas avec la version du SDK.