@cosmosapp/pay_sdkServidor
El 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.
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: Un registro de cliente, opcionalmente enriquecido con estadísticas de pago en cadena.
- PaymentIntent: Una intención de pago SEP-7 de Stellar
- Product: Un producto / precio por el que el consumidor puede cobrar.
- WebhookEndpoint: Un endpoint de webhook registrado
- 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: A private payment, from
client.privatePayments: an amount in XLM whose value is hidden on-chain - Usdt0Transfer: A USDT0 transfer from Stellar to an EVM network through LayerZero, from
client.usdt0