跳到主要内容

账户

Account 对象代表了商户在 GStable 系统中的收款实体。

GStable 的账户体系与链上地址深度绑定，但为了安全性和合规性，账户的创建、修改和删除操作必须在 GStable Dashboard 中完成。API 仅提供只读权限，主要用于在程序化创建 支付链接 或 支付会话 时查询必要的 accountId 和结算配置。

仅限 Dashboard 管理

账户涉及敏感的资金结算地址配置，API 不支持创建或修改账户。请前往 Dashboard 进行管理。

账户数量限制

为了便于管理，每个商户最多允许创建 20 个 收款账户。

账户对象​

核心属性​

属性类型描述
accountIdString账户的唯一标识符（如 acc_example_...）。
accountNameString商户在 Dashboard 配置的账户别名。
accountAddressString资金结算的目标钱包地址。
accountTypeString账户类型。目前仅支持 EVM::ADDR (EVM 兼容链地址)。
settlementCurrenciesArray该账户支持的结算币种列表（如 polygon::usdc）。
versionString账户版本号。用于区分同一地址被删除后重新创建的情况。
statusString账户状态。目前仅有 normal (正常)。

获取账户详情​

GET /account/detail/:accountId

根据账户 ID 获取详细配置信息。

请求参数​

此接口通过 URL 路径参数 传递 ID。

参数类型必填描述
accountIdString✅账户 ID。

请求示例​

GET /account/detail/acc_example_merchant_03

响应示例​

{
  "code": 0,
  "message": "success",
  "data": {
    "accountName": "主营业务收款",
    "accountId": "acc_example_merchant_03",
    "version": "ver_example_04",
    "accountAddress": "0x0000000000000000000000000000000000000006",
    "accountType": "EVM::ADDR",
    "settlementCurrencies": [
      "polygon::usdc",
      "arbitrumone::usdt"
    ],
    "createAt": "2025-12-18 01:59:02",
    "updateAt": "2026-01-03 10:18:01",
    "status": "normal"
  }
}

获取账户列表​

GET /account/list

获取当前商户下的所有收款账户。由于平台限制最大账户数量为 20 个，此接口不进行分页，直接返回全量数据。

请求示例​

GET /account/list

响应示例​

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "accountName": "主营业务收款",
      "accountId": "acc_example_merchant_03",
      "version": "ver_example_04",
      "accountAddress": "0x0000000000000000000000000000000000000006",
      "accountType": "EVM::ADDR",
      "settlementCurrencies": [
        "polygon::usdc"
      ],
      "createAt": "2025-12-18 01:59:02",
      "updateAt": "2026-01-03 10:18:01",
      "status": "normal"
    },
    {
      "accountName": "备用收款",
      "accountId": "acc_AnotherIDExample123",
      "version": "ver_example_...",
      "accountAddress": "0x0000000000000000000000000000000000000008",
      "accountType": "EVM::ADDR",
      "settlementCurrencies": [
        "polygon::usdt"
      ],
      "createAt": "2025-12-20 10:00:00",
      "updateAt": "2025-12-20 10:00:00",
      "status": "normal"
    }
  ]
}