Ce que couvre cette référence
Seuls les endpoints réellement appelables avec une clésk_live_* / sk_test_* figurent
ici : création de paiements, payouts, invoices, products, settlements,
etc. Schémas + Try-it complets.
Les opérations réservées au dashboard (gestion d’équipe, du KYB, des terminaux POS, des
clés API, sessions humaines) ne sont pas appelables via clé API et ne figurent donc
pas dans cette référence. Pour ces fonctionnalités, voir le Guide marchand.
Certaines ressources sont hybrides : GET accessible via clé API, mutations
réservées au dashboard. Les pages concernées (whitelist-addresses,
webhook-endpoints) documentent le endpoint API appelable.
Base URL
Authentification
Headers communs
| Header | Sens | Quand |
|---|---|---|
Authorization: Bearer sk_… | Clé API | Toutes (sauf publics) |
Idempotency-Key: <string> | Idempotence | POST création de ressource |
X-RateLimit-* | Limites de débit (en réponse) | Toutes |
Format réponse erreur
INSUFFICIENT_SCOPE(403) : clé API valide mais sans le scope requisDASHBOARD_ONLY(403) : clé API utilisée sur un endpoint réservé au dashboardACCOUNT_FROZEN(401) : compte gelé, aucune opération autorisée- Dépassement de quota :
429avec le headerRetry-After(pas de champcode) - Erreur de validation :
400/422, détail dansmessage
Tous les endpoints sont préfixés
/v1.