E-commerce
Activer le module
L'encaissement sur votre site exige un contrat e-commerce ou plateforme à votre nom. Il se demande en ouvrant une boutique en ligne dans vos paramètres, puis trois conditions sont à réunir.
Développeur, Clés API. Une clé sk_test_* s'y crée en un clic ; son secret n'est montré qu'à la création. S'ouvre dans un nouvel onglet.
Ce que le compte doit porter
- 1Un compte marchand validé, avec un contrat e-commerce ou plateforme actif à votre nom (un contrat de lien de paiement ne permet que les liens).
- 2Une clé API :
sk_test_*pour intégrer,sk_live_*pour encaisser. Le pool se déduit du préfixe. - 3Une URL de notification en HTTPS, joignable sans authentification.
Si la condition n'est pas remplie
Sans contrat actif, la création de session répond 403. Avec une URL de notification injoignable, le paiement aboutit mais votre commande reste en attente : c'est l'échec le plus fréquent, et le plus silencieux.
Par où entrer
/api/v1/payments/sessionsPOSTCréer un paiement direct/api/v1/payments/directGETRécupérer un paiement/api/v1/payments/{id}Guides de recettes
De la clé de test au webhook reçu, sans écrire une ligne de page de paiement.
L'extension officielle encaisse sans code. Restent quatre réglages, et un ordre à respecter.
Un compte, plusieurs points de vente : `storeId` dit lequel encaisse, et la réponse le confirme.