@cosmosapp/pay_sdkServer
Der Client
Das Client-Objekt: die Manager, die es bereitstellt, seine Konstruktoroptionen und die selbsthandelnden Strukturen, die es zurückgibt.
Fast alles, was Sie tun, läuft über eine einzige Client-Instanz. Sie gruppiert die API in einen Manager pro Ressource und gibt Objekte zurück, die an sich selbst handeln können.
import { Client } from '@cosmosapp/pay_sdk';
const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });Ein Client stellt jede Ressource über ihren eigenen Manager bereit.
| Manager | Ressource | Schlüsselmethoden |
|---|---|---|
client.paymentIntents | Stellar-SEP-7-Absichten | createTx · createPay · fetch · list · update · delete · validate |
client.webhooks | Endpunkte + Zustellungen + Ereignis-Listener | create · list · fetch · update · delete · rotateSecret · ping · fetchDeliveries · redeliver · on(...) · process · createHandler · middleware |
client.products | Produkte / Preise | create · list · fetch · update · delete |
client.customers | Kunden | create · list · fetch · update · delete |
client.analytics | Schreibgeschützte Metriken | summary · balances · apiLogs · webhookLogs |
client.health | Liveness / Readiness | liveness · readiness |
Zurückgegebene Objekte sind „Strukturen"
Manager-Methoden geben reichhaltige Instanzen zurück (PaymentIntent, WebhookEndpoint,
Product, Customer), die an sich selbst handeln können und typisierte Zugriffsmethoden bereitstellen,
z. B. intent.isPay, intent.assetLabel, await intent.validate(txHash),
await endpoint.disable(). Rufen Sie .toJSON() für die rohe Nutzlast auf.
Referenzen
- Customer: Ein Kundendatensatz, optional angereichert mit On-Chain-Zahlungsstatistiken.
- PaymentIntent: Eine Stellar-SEP-7-Zahlungsabsicht
- Product: Ein Produkt / Preis, für den der Consumer Geld verlangen kann.
- WebhookEndpoint: Ein registrierter Webhook-Endpunkt
- Client: Der Haupteinstiegspunkt des SDK. Ein einzelner, atomarer Client, der jede Ressource über ihren eigenen Manager bereitstellt (ein atomares Single-Client-Design).
- 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