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

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](/v1.0/paiements/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 |

::::tabs{sync="lang"}
:::tab{label="cURL"}
```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" }'
```
:::
:::tab{label="TypeScript"}
```ts
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 :

| 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` |

```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

- [Paiements](/v1.0/paiements)
- [Référence du module Paiements](/v1.0/paiements/reference)
