匯入收款地址

向 StableOps 批次匯入商戶控制的收款地址，按鏈歸一化格式並跳過已有記錄，使用環境對應的網路準備地址池。地址池按組織與環境隔離，沙盒使用測試網、生產使用主網，資金仍由商戶錢包控制。維護前核對分配狀態與現有訂單，避免影響正在等待付款的收款流程。

POST/v1/addresses/import

Authorization

bearerAuth

AuthorizationBearer <token>

Paste your API key from the dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

addresses*array<>

List of addresses to import (max 1,000 entries). Each entry specifies chain, address, and optional label.

mode?string

Address allocation mode. "single" (default): address is exclusive to one active order. "shared": multiple orders can share the same address.

Response Body

`application/json`

curl -X POST "https://example.com/v1/addresses/import" \  -H "Content-Type: application/json" \  -d '{    "addresses": [      {        "chain": "ethereum",        "address": "string"      }    ]  }'

{
  "imported": 0,
  "addresses": [
    {
      "id": "string",
      "chain": "ethereum",
      "address": "string",
      "label": "string",
      "mode": "single",
      "status": "available",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

{
  "statusCode": -9007199254740991,
  "message": "string",
  "error": "string"
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`