# O Client (https://dev.cosmospay.lat/docs/pt/sdk/server/client/)

> O objeto Client: os gerenciadores que ele expõe, suas opções de construtor e as estruturas autoatuantes que ele retorna.

Quase tudo o que você faz passa por uma única instância de `Client`. Ela agrupa a API em um gerenciador por recurso e retorna objetos que podem agir sobre si mesmos.

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

Um único cliente expõe cada recurso por meio do seu próprio gerenciador.

| Gerenciador | Recurso | Métodos principais |
| ------- | -------- | ----------- |
| `client.paymentIntents` | Intenções SEP-7 da Stellar | `createTx` · `createPay` · `fetch` · `list` · `update` · `delete` · `validate` |
| `client.webhooks` | Endpoints + entregas + listener de eventos | `create` · `list` · `fetch` · `update` · `delete` · `rotateSecret` · `ping` · `fetchDeliveries` · `redeliver` · `on(...)` · `process` · `createHandler` · `middleware` |
| `client.products` | Produtos / preços | `create` · `list` · `fetch` · `update` · `delete` |
| `client.customers` | Clientes | `create` · `list` · `fetch` · `update` · `delete` |
| `client.analytics` | Métricas somente leitura | `summary` · `balances` · `apiLogs` · `webhookLogs` |
| `client.health` | Liveness / readiness | `liveness` · `readiness` |

## Os objetos retornados são "estruturas"

Os métodos dos gerenciadores retornam instâncias ricas (`PaymentIntent`, `WebhookEndpoint`,
`Product`, `Customer`) que podem agir sobre si mesmas e expõem acessadores tipados,
por exemplo, `intent.isPay`, `intent.assetLabel`, `await intent.validate(txHash)`,
`await endpoint.disable()`. Chame `.toJSON()` para obter o payload bruto.

## Referências

- [Customer](https://dev.cosmospay.lat/docs/sdk/definitions/server/customer/): Um registro de cliente, opcionalmente enriquecido com estatísticas de pagamento on-chain.
- [PaymentIntent](https://dev.cosmospay.lat/docs/sdk/definitions/server/payment-intent/): Uma intenção de pagamento SEP-7 da Stellar
- [Product](https://dev.cosmospay.lat/docs/sdk/definitions/server/product/): Um produto / preço pelo qual o consumidor pode cobrar.
- [WebhookEndpoint](https://dev.cosmospay.lat/docs/sdk/definitions/server/webhook-endpoint/): Um endpoint de webhook registrado
- [Client](https://dev.cosmospay.lat/docs/sdk/definitions/server/client/): O ponto de entrada principal do SDK, um único cliente atômico que expõe cada recurso por meio do seu próprio gerenciador (um design atômico de cliente único).
- [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`