快速开始

1. 安装

npm install gstable-js

npm 包：gstable-js。

2. 配置 API 密钥

推荐使用环境变量：

export GSTABLE_API_KEY="sk_live_xxxxxxxx"

在生产环境，从宿主密钥管理或进程环境加载密钥 — 切勿将密钥写死在源码中。

3. 列出账户（已鉴权）

import { GStableClient } from 'gstable-js';

const client = new GStableClient({
  apiKey: process.env.GSTABLE_API_KEY,
});

const accounts = await client.account.list();
console.log(accounts);

account.list() 解析为 API 响应信封中的 data 数组（SDK 会为你解包 data）。

4. 获取公开支付能力（链路上无鉴权头）

const caps = await client.capability.all();
console.log(caps);

尽管在 构造函数 中仍需要 apiKey（供私有资源使用），capability.all() 使用 公开 base URL，且不会为此请求发送 Authorization。

5. 处理错误

import { GStableClient, isGStableError } from 'gstable-js';

const client = new GStableClient({ apiKey: process.env.GSTABLE_API_KEY });

try {
  await client.product.list(1, 20);
} catch (e) {
  if (isGStableError(e)) {
    console.error('GStable error', e.code, e.message);
  }
  throw e;
}

请参阅 错误码与 SDK 异常。

6. 可选：调试出站请求

GSTABLE_DEBUG=1 node ./your-script.mjs

将 method、URL、headers（含 Authorization）以 JSON 输出到 console.error。日志视为敏感信息。

下一步

• 客户端配置 — baseUrl、publicBaseUrl、自定义 fetch。
• Payment Links 集成 — 端到端模式。
• Webhooks — 通过 API 注册端点。