# Le Client (https://dev.cosmospay.lat/docs/fr/sdk/server/client/)

> L'objet Client : les gestionnaires qu'il expose, ses options de constructeur et les structures auto-actives qu'il renvoie.

Presque tout ce que vous faites passe par une seule instance de `Client`. Elle regroupe l'API en un gestionnaire par ressource et renvoie des objets qui peuvent agir sur eux-mêmes.

```ts
import { Client } from '@cosmosapp/pay_sdk';
const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });
```

Un seul client expose chaque ressource via son propre gestionnaire.

| Gestionnaire | Ressource | Méthodes clés |
| ------- | -------- | ----------- |
| `client.paymentIntents` | Intentions Stellar SEP-7 | `createTx` · `createPay` · `fetch` · `list` · `update` · `delete` · `validate` |
| `client.webhooks` | Points de terminaison + livraisons + écouteur d'événements | `create` · `list` · `fetch` · `update` · `delete` · `rotateSecret` · `ping` · `fetchDeliveries` · `redeliver` · `on(...)` · `process` · `createHandler` · `middleware` |
| `client.products` | Produits / prix | `create` · `list` · `fetch` · `update` · `delete` |
| `client.customers` | Clients | `create` · `list` · `fetch` · `update` · `delete` |
| `client.analytics` | Métriques en lecture seule | `summary` · `balances` · `apiLogs` · `webhookLogs` |
| `client.health` | Liveness / readiness | `liveness` · `readiness` |

## Les objets renvoyés sont des « structures »

Les méthodes des gestionnaires renvoient des instances riches (`PaymentIntent`, `WebhookEndpoint`,
`Product`, `Customer`) qui peuvent agir sur elles-mêmes et exposent des accesseurs typés,
par ex. `intent.isPay`, `intent.assetLabel`, `await intent.validate(txHash)`,
`await endpoint.disable()`. Appelez `.toJSON()` pour la charge utile brute.

## Références

- [Customer](https://dev.cosmospay.lat/docs/sdk/definitions/server/customer/) : un enregistrement client, éventuellement enrichi de statistiques de paiement sur la chaîne.
- [PaymentIntent](https://dev.cosmospay.lat/docs/sdk/definitions/server/payment-intent/) : une intention de paiement Stellar SEP-7
- [Product](https://dev.cosmospay.lat/docs/sdk/definitions/server/product/) : un produit / prix que le consommateur peut facturer.
- [WebhookEndpoint](https://dev.cosmospay.lat/docs/sdk/definitions/server/webhook-endpoint/) : un point de terminaison webhook enregistré
- [Client](https://dev.cosmospay.lat/docs/sdk/definitions/server/client/) : le point d'entrée principal du SDK, un client unique et atomique qui expose chaque ressource via son propre gestionnaire (une conception atomique à client unique).
- [PrivatePayment](https://dev.cosmospay.lat/docs/sdk/definitions/server/private-payment/): A private payment, from `client.privatePayments`: an amount in XLM whose value is hidden on-chain
- [Usdt0Transfer](https://dev.cosmospay.lat/docs/sdk/definitions/server/usdt0-transfer/): A USDT0 transfer from Stellar to an EVM network through LayerZero, from `client.usdt0`