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.
- Required access
- Niveau Administrateur client
- Duration
- 5 min
This page has not been translated yet and is shown in French.
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.