# El Client (https://dev.cosmospay.lat/docs/es/sdk/server/client/)

> El objeto Client: los administradores que expone, sus opciones de constructor y las estructuras que actúan sobre sí mismas que devuelve.

Casi todo lo que haces pasa por una sola instancia de `Client`. Agrupa la API en un administrador por recurso y devuelve objetos que pueden actuar sobre sí mismos.

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

Un solo cliente expone cada recurso a través de su propio administrador.

| Administrador | Recurso | Métodos clave |
| ------- | -------- | ----------- |
| `client.paymentIntents` | Intenciones SEP-7 de Stellar | `createTx` · `createPay` · `fetch` · `list` · `update` · `delete` · `validate` |
| `client.webhooks` | Endpoints + entregas + escucha de eventos | `create` · `list` · `fetch` · `update` · `delete` · `rotateSecret` · `ping` · `fetchDeliveries` · `redeliver` · `on(...)` · `process` · `createHandler` · `middleware` |
| `client.products` | Productos / precios | `create` · `list` · `fetch` · `update` · `delete` |
| `client.customers` | Clientes | `create` · `list` · `fetch` · `update` · `delete` |
| `client.analytics` | Métricas de solo lectura | `summary` · `balances` · `apiLogs` · `webhookLogs` |
| `client.health` | Liveness / readiness | `liveness` · `readiness` |

## Los objetos devueltos son "estructuras"

Los métodos de los administradores devuelven instancias enriquecidas (`PaymentIntent`, `WebhookEndpoint`,
`Product`, `Customer`) que pueden actuar sobre sí mismas y exponen accesores tipados,
p. ej. `intent.isPay`, `intent.assetLabel`, `await intent.validate(txHash)`,
`await endpoint.disable()`. Llama a `.toJSON()` para obtener la carga útil en crudo.

## Referencias

- [Customer](https://dev.cosmospay.lat/docs/sdk/definitions/server/customer/): Un registro de cliente, opcionalmente enriquecido con estadísticas de pago en cadena.
- [PaymentIntent](https://dev.cosmospay.lat/docs/sdk/definitions/server/payment-intent/): Una intención de pago SEP-7 de Stellar
- [Product](https://dev.cosmospay.lat/docs/sdk/definitions/server/product/): Un producto / precio por el que el consumidor puede cobrar.
- [WebhookEndpoint](https://dev.cosmospay.lat/docs/sdk/definitions/server/webhook-endpoint/): Un endpoint de webhook registrado
- [Client](https://dev.cosmospay.lat/docs/sdk/definitions/server/client/): El punto de entrada principal del SDK, un único cliente atómico que expone cada recurso a través de su propio administrador (un diseño atómico de un solo cliente).
- [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`