Aller au contenu

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.

GuideAdministrateurDéveloppeur
Accès requis
Niveau Administrateur client
Durée
5 min
Voir en Markdown

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é.

ChampValeurs
providerSTRIPE, PADDLE ou POLAR
apiKeyClé API du fournisseur
Bash
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" }'
TypeScript
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 :

JSON
{
  "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 :

EndpointContenu de chaque élément
GET /api/payments/invoicesexternalId, amountCents, currency, status, createdAt
GET /api/payments/purchasesexternalId, amountCents, currency, productId, productName, createdAt
GET /api/payments/productsexternalId, name, priceCents, currency
Bash
curl -s https://api.wakastart.app/api/payments/invoices \
  -H "Authorization: Bearer $WAKASTART_TOKEN"

Réponse attendue :

JSON
[
  {
    "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.

Voir aussi