Consulter votre fournisseur de paiement
Enregistrer la clé API de votre compte Stripe, Paddle ou Polar pour lire vos factures, achats et produits depuis l'API Wakastart.
- Accès requis
- Niveau Administrateur client
- Durée
- 5 min
Si votre organisation encaisse déjà avec son propre compte Stripe, Paddle ou Polar, vous pouvez confier sa clé API à Wakastart. Vos serveurs lisent ensuite vos factures, vos achats et vos produits par l'API publique Wakastart, sans manipuler la clé eux-mêmes.
Note
Cette voie ne fait aucun encaissement et ne prélève aucune commission : Wakastart lit en direct les données de votre fournisseur. Pour encaisser depuis votre wakapp, suivez Activer les ventes.
Avant de commencer
- Vous êtes Administrateur client de l'organisation concernée. Les appels s'appliquent toujours à votre organisation, celle de votre jeton ou de votre clé API.
- Vous disposez d'une clé API de votre fournisseur avec des droits de lecture, par exemple une clé restreinte Stripe en lecture seule.
Enregistrer la clé du fournisseur
Envoyez PUT /api/config/payment-credentials/{customerWid}, où {customerWid} est l'identifiant de votre organisation. Le corps contient le fournisseur et la clé.
| Champ | Valeurs |
|---|---|
provider | STRIPE, PADDLE ou POLAR |
apiKey | Clé API du fournisseur |
curl -s -X PUT https://api.wakastart.app/api/config/payment-credentials/cus456 \
-H "Authorization: Bearer $WAKASTART_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "provider": "STRIPE", "apiKey": "rk_test_exemple" }'const response = await fetch(
"https://api.wakastart.app/api/config/payment-credentials/cus456",
{
method: "PUT",
headers: {
Authorization: `Bearer ${process.env.WAKASTART_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ provider: "STRIPE", apiKey: process.env.STRIPE_READ_KEY }),
},
);
console.log(await response.json());Réponse attendue :
{
"customerWid": "cus456",
"provider": "STRIPE",
"connectionMode": "DIRECT_API_KEY",
"updatedAt": "2026-10-23T10:02:11.540Z"
}La clé est chiffrée par Wakastart et n'est jamais renvoyée, même en lecture. Un nouvel appel PUT la remplace.
Lire vos données
Trois lectures sont disponibles, toujours sur votre organisation :
| Endpoint | Contenu de chaque élément |
|---|---|
GET /api/payments/invoices | externalId, amountCents, currency, status, createdAt |
GET /api/payments/purchases | externalId, amountCents, currency, productId, productName, createdAt |
GET /api/payments/products | externalId, name, priceCents, currency |
curl -s https://api.wakastart.app/api/payments/invoices \
-H "Authorization: Bearer $WAKASTART_TOKEN"Réponse attendue :
[
{
"externalId": "in_1Pexemple",
"amountCents": 4900,
"currency": "eur",
"status": "paid",
"createdAt": "2026-10-20T14:31:07.000Z"
}
]Chaque appel interroge votre fournisseur en direct : les données sont toujours à jour, et leur volume dépend de ce que le fournisseur renvoie.
Vérifier le résultat
Appelez GET /api/config/payment-credentials/{customerWid} : la réponse indique le fournisseur enregistré et connectionMode: "DIRECT_API_KEY", sans la clé.
Dépannage
404« Aucun provider de paiement configuré pour ce client » : aucune clé n'est enregistrée pour votre organisation.502« Clé de paiement invalide, reconfigurez-la » : le fournisseur a refusé la clé ; enregistrez-en une nouvelle.502« Le provider de paiement est indisponible » : le fournisseur ne répond pas ; réessayez plus tard.