合作伙伴 API · 2026-11

把域名与建站能力,接进你的业务系统

会员生成通讯密钥,服务端调用 /agent HTTP API 完成域名查询、实名模板、注册下单、网站选购与余额支付。订单状态可查,域名与网站由云速成平台开通。

生产环境需要通讯密钥 + 防刷签名;两者都在下文给出可运行示例。

Node.js · 最小下单示例
const profile = await request("GET", "/agent/profile");

const products = await request(
  "GET",
  "/agent/cloud-products?page=1&pageSize=20",
);
const detail = await request(
  "GET",
  "/agent/cloud-products/" + products.items[0].slug,
);
const order = await request("POST", "/agent/cloud-orders", {
  specId: detail.specs[0].id,
  quantity: 1,
  durationYears: 1,
  contactName: "张三",
  contactPhone: "13800000000",
  contactEmail: "ops@example.com",
});
本页目录

01 / 接入概览

用通讯密钥接入域名与建站业务

合作方在自己的系统里生成通讯密钥,完成选品、下单、余额支付和状态查询;真正的域名注册与网站开通由云速成平台执行。

通讯密钥

会员在「个人资料」生成通讯密钥,服务端请求头带 X-Api-Key;密钥只用于 /agent 接口。

预充值扣费

先用会员账号余额,余额支付即时扣减;余额不足直接拒绝,不会产生负余额。

域名注册

查询、报价、实名模板、注册 / 续费 / 转入订单与支付状态查询。

网站购买

代理目录选建站套餐,按产品级代理价下单,余额支付后自动或人工开通。

建站开通链路

  1. 生成密钥
  2. 查产品
  3. 取 specId
  4. 创建订单
  5. 余额支付
  6. 轮询状态

域名注册链路

  1. 生成密钥
  2. 建实名模板
  3. 查可注册
  4. 报价
  5. 创建订单
  6. 余额支付
Base URL https://yunsucheng.net/_api认证:通讯密钥 X-Api-Key计费:预充值余额格式:JSON / UTF-8

下文响应示例只列出关键字段,完整字段以实际接口响应为准;金额单位均为人民币元。

02 / 快速开始

先跑通一笔订单,再扩展业务

下面示例使用「通讯密钥与防刷」一节的 request() 封装:请求头带 X-Api-Key,并完成生产防刷签名。示例金额仅作演示,实际以服务端返回为准。

Node.js · 建站下单到余额支付
const profile = await request("GET", "/agent/profile");

const products = await request(
  "GET",
  "/agent/cloud-products?page=1&pageSize=20",
);

const detail = await request(
  "GET",
  "/agent/cloud-products/" + products.items[0].slug,
);

const order = await request("POST", "/agent/cloud-orders", {
  specId: detail.specs[0].id,
  quantity: 1,
  durationYears: 1,
  contactName: "张三",
  contactPhone: "13800000000",
  contactEmail: "ops@example.com",
  company: "示例代理",
  remark: "由合作方系统下单",
});

// 余额支付:成功后订单进入 confirmed;云梦建站会继续自动开通。
const paid = await request(
  "POST",
  "/agent/cloud-orders/" + order.orderNumber + "/pay-balance",
);
01

先生成密钥

在会员中心「个人资料 → 通讯密钥」生成,服务端保存。

02

再查价

产品取 specId;域名先建实名模板,再 search + quote。

03

最后支付

余额支付成功后再轮询开通结果。

03 / 通讯密钥与防刷

通讯密钥 + 生产防刷签名

通讯密钥放在 X-Api-Key 请求头(或 Authorization: Bearer agt_...);生产环境所有 /_api 请求还要带防刷签名,缺少或计算错误会返回 403。

生成与管理通讯密钥

  1. 1. 登录会员账号,进入 个人资料。
  2. 2. 在「通讯密钥」卡片点击「生成密钥」,完整密钥只显示在该卡片中。
  3. 3. 把密钥保存到服务端环境变量;不要写进浏览器、小程序、App 或代码仓库。
  4. 4. 需要更换时点击「轮换密钥」,旧密钥立即失效;子账号不显示该卡片。

请求头示例

X-Api-Key: agt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
  • · 通讯密钥只用于 /agent 接口,不能调用会员中心 JWT 接口。
  • · 会员 JWT 是另一套认证,不能替代通讯密钥调用 /agent。
  • · 密钥所属账号被禁用时返回 agent_forbidden。

防刷请求头

防刷签名保护请求完整性,不是账号密码。时间戳容差 300 秒,nonce 必须每次不同;PoW 难度为 SHA-256 前导 13 个零 bit。

请求头说明
X-Api-Key会员中心生成的通讯密钥,仅 /agent 接口使用
X-Ts毫秒时间戳,与服务器时间误差不超过 300 秒
X-Nonce随机字符串,建议 16 字节随机数的十六进制
X-SigSHA-256(规范串) 的十六进制
X-Proof满足前导零 bit 要求的工作量证明
User-Agent参与签名,请求头必须与规范串中的值完全一致

规范串(逐行拼接,使用 \n)

METHOD
/_api + pathAndQuery
SHA256(rawBody)
X-Ts
X-Nonce
User-Agent
ultron-anti-abuse-v1
Node.js 18+ · 通讯密钥 + 完整签名器
import crypto from "node:crypto";

const BASE_URL = "https://yunsucheng.net/_api";
const API_KEY = process.env.AGENT_API_KEY;
const SEED = "ultron-anti-abuse-v1";
const POW_BITS = 13;

const sha256 = (value) => crypto.createHash("sha256").update(value).digest("hex");

function leadingZeroBits(hex) {
  let bits = 0;
  for (const ch of hex) {
    const n = parseInt(ch, 16);
    if (n === 0) { bits += 4; continue; }
    bits += Math.clz32(n) - 28;
    break;
  }
  return bits;
}

function mine(sig) {
  let proof = 0;
  while (leadingZeroBits(sha256(sig + proof)) < POW_BITS) proof += 1;
  return String(proof);
}

async function request(method, path, body) {
  const rawBody = body === undefined
    ? (method === "GET" ? "" : "{}")
    : JSON.stringify(body);
  const ts = String(Date.now());
  const nonce = crypto.randomBytes(16).toString("hex");
  const userAgent = "YunSuCheng-Partner/1.0";
  const canonical = [
    method,
    "/_api" + path,
    sha256(rawBody),
    ts,
    nonce,
    userAgent,
    SEED,
  ].join("\n");
  const sig = sha256(canonical);
  const headers = {
    "Content-Type": "application/json",
    "User-Agent": userAgent,
    "X-Api-Key": API_KEY,
    "X-Ts": ts,
    "X-Nonce": nonce,
    "X-Sig": sig,
    "X-Proof": mine(sig),
  };
  const response = await fetch(BASE_URL + path, {
    method,
    headers,
    body: method === "GET" ? undefined : rawBody,
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}
  • · GET / HEAD 的 body 按空字符串计算 SHA-256;POST 无 body 时发送 {} 并按实际字节签名。
  • · 签名路径要包含 /_api 前缀,例如 /_api/agent/profile。
  • · X-Api-Key 不参与规范串,但仍必须随请求发送。
  • · 同一个 nonce 不要重复使用;时间戳过期后重新计算。
  • · 如果返回 captcha_required,说明触发了人机验证,服务端对接请联系平台处理。

04 / 账户与余额

通讯密钥对应一个会员账号

代理下单从该会员账号余额扣减;充值请让平台入账或在会员中心操作,通讯密钥 API 只查询余额与扣费。

会员账号

平台开通会员账号;通讯密钥绑定该账号。

充值 / 入账

在会员中心在线充值,或按合作约定由平台后台入账。

下单扣费

创建订单后余额支付,按服务端订单金额即时扣减。

场景接口结果
云产品 / 建站订单POST /agent/cloud-orders/{orderNumber}/pay-balance扣余额,订单进入 confirmed;云梦建站继续开通
域名订单POST /agent/domain-orders/{orderNumber}/pay-balance扣余额,订单进入 paid 并触发开通
账户余额GET /agent/profile查询可用余额;充值在会员中心完成,通讯密钥 API 不提供充值

/agent/profile 返回通讯密钥所属账号与可用余额;所有代理下单都从该余额扣减。

GET/agent/profile通讯密钥

代理账户信息

获取通讯密钥对应的会员账号、昵称、可用余额与币种。

响应示例
{
  "memberId": "84f098f0-8fcf-4b1d-928d-b775138b712e",
  "username": "agent_demo",
  "nickname": "示例代理",
  "balance": 5000,
  "currency": "CNY"
}
  • balance 单位:人民币元。
  • 下单前建议先查余额;余额不足时先让平台入账或在会员中心充值。

余额不足时

接口返回 400,detail 为「账户余额不足,请先充值」。不要假设可以透支,也不要重复提交支付请求;先让平台入账或在会员中心充值后再支付。

  • · 平台可能对异常高频请求做拦截;订单轮询建议 5–10 秒一次,列表接口按需调用。
  • · 所有 /agent 请求都会经过生产防刷校验,带通讯密钥不等于免签名。
  • · 余额支付、创建订单等写操作没有幂等键,调用方需自行保证不重复提交。

05 / 云产品

查代理产品、选规格、拿 specId

代理目录只展示允许代理的产品;选中规格后拿 specId 下单。

代理目录只返回已上架、允许代理且至少有一个规格设置了代理价的产品。列表的 minAgentPrice 是可代理规格中的最低价;详情里每个规格的 agentPrice 才是该规格的采购价,specs[].price 是站内零售价,仅用于展示。

GET/agent/cloud-products通讯密钥

代理云产品列表

分页查询当前允许代理采购的云产品,可按分类与关键词筛选。

请求参数

参数类型必填说明
categorystring否compute / storage / network / database / domain / security / application
qstring否命中产品名称 / 简介 / 标识
pageinteger否页码,从 1 开始
pageSizeinteger否每页条数,默认 20
响应示例
{
  "items": [
    {
      "id": "0d6f2a9c-4e2f-4a6e-8b1f-2c3d4e5f6a7b",
      "slug": "enterprise-site",
      "name": "企业官网建站",
      "category": "application",
      "summary": "品牌官网与营销落地页",
      "iconKey": "layout-template",
      "coverImage": null,
      "badge": "建站",
      "highlights": ["独立域名", "可视化编辑"],
      "minAgentPrice": 699,
      "billingCycle": "year",
      "isFeatured": true,
      "specCount": 2
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "totalPages": 1
}
  • minAgentPrice 是该产品可代理规格中的最低采购价,实际下单金额以所选规格的 agentPrice 为准。
  • 未开启代理或所有规格都未设置代理价的产品不会出现在该列表。
GET/agent/cloud-products/{slug}通讯密钥

代理云产品详情

按产品标识获取详情与可售规格;下单用的 specId 从 specs 中取。

请求参数

参数类型必填说明
slugstring是产品标识,如 enterprise-site
响应示例
{
  "id": "0d6f2a9c-4e2f-4a6e-8b1f-2c3d4e5f6a7b",
  "slug": "enterprise-site",
  "name": "企业官网建站",
  "category": "application",
  "summary": "品牌官网与营销落地页",
  "iconKey": "layout-template",
  "coverImage": null,
  "badge": "建站",
  "highlights": ["独立域名", "可视化编辑"],
  "minAgentPrice": 699,
  "billingCycle": "year",
  "isFeatured": true,
  "specCount": 2,
  "description": "<p>产品介绍 HTML</p>",
  "provisionProvider": "yunmeng",
  "specs": [
    {
      "id": "4b1d2c3e-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
      "name": "标准版",
      "cpu": 0,
      "memoryGb": 0,
      "diskGb": 0,
      "bandwidthMbps": 0,
      "price": 1299,
      "agentPrice": 699,
      "originalPrice": null,
      "billingCycle": "year",
      "allowedDurationYears": [1, 2, 3],
      "enabled": true,
      "sortOrder": 1,
      "yunmengSkuId": null,
      "summary": "10 个页面 · 独立域名 · 1 年"
    }
  ]
}
  • **售价以规格的 agentPrice 为准**;不要用 specs[].price 计算代理订单金额。
  • 只返回已启用且设置了代理价的可售规格。列表的 minAgentPrice 仅用于展示起价。

06 / 建站订单

创建订单、余额支付、等待开通

订单创建后只锁价;余额支付成功才扣款并进入开通流程。

创建订单只锁定规格与代理价,状态为 pending;余额支付成功后才扣款并进入确认 / 开通流程。订单金额由服务端计算,不收客户端价格。

GET/agent/cloud-orders通讯密钥

云订单列表

分页查询当前通讯密钥所属账号的云订单。

请求参数

参数类型必填说明
statusstring否pending / confirmed / provisioning / active / cancelled
fromstring否创建时间起,ISO 8601
tostring否创建时间止,ISO 8601
qstring否订单号 / 产品名关键词
pageinteger否页码
pageSizeinteger否每页条数
POST/agent/cloud-orders通讯密钥

创建云订单

按规格提交订单,服务端按该规格的代理价计算 amount。

请求参数

参数类型必填说明
specIdstring是产品详情中的可售规格 Id
quantityinteger是购买数量,1–99
durationYearsinteger是购买年限;按月产品固定 1,按年产品支持 1/2/3/5
contactNamestring是联系人姓名
contactPhonestring是联系电话
contactEmailstring是联系邮箱
companystring否公司名称
remarkstring否配置需求备注
请求示例
{
  "specId": "4b1d2c3e-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
  "quantity": 1,
  "durationYears": 1,
  "contactName": "张三",
  "contactPhone": "13800000000",
  "contactEmail": "ops@example.com",
  "company": "示例代理",
  "remark": "由合作方系统下单"
}
响应示例
{
  "orderNumber": "CO202611150001",
  "productName": "企业官网建站",
  "specName": "标准版",
  "specSummary": "10 个页面 · 独立域名 · 1 年",
  "amount": 699,
  "status": "pending",
  "billingCycle": "year",
  "provisionProvider": "yunmeng",
  "frontEndUrl": null,
  "expiresAt": null,
  "yunmengInstanceId": null,
  "createdAt": "2026-11-15T08:31:00Z"
}
  • 订单金额 = 所选规格的 agentPrice × quantity × durationYears;如 2 年即年价 × 2,不另设多年价。以创建响应中的 amount 为准。
  • 创建成功不等于已扣款;需继续调用余额支付接口。
  • 接口没有幂等键,重复提交会生成多个订单;调用方需按自己的业务单号去重。
GET/agent/cloud-orders/{orderNumber}通讯密钥

云订单详情

按订单号获取状态、金额、开通结果与网站地址。

请求参数

参数类型必填说明
orderNumberstring是云订单号
响应示例
{
  "orderNumber": "CO202611150001",
  "productName": "企业官网建站",
  "specName": "标准版",
  "specSummary": "10 个页面 · 独立域名 · 1 年",
  "amount": 699,
  "status": "pending",
  "billingCycle": "year",
  "provisionProvider": "yunmeng",
  "frontEndUrl": null,
  "expiresAt": null,
  "yunmengInstanceId": null,
  "createdAt": "2026-11-15T08:31:00Z"
}
  • 订单开通成功后 status=active,frontEndUrl 为网站前台地址。
  • provisionError 非空表示自动开通失败,可联系平台处理。
POST/agent/cloud-orders/{orderNumber}/pay-balance通讯密钥

余额支付云订单

从代理账号余额扣款并确认订单;余额不足直接拒绝。

请求参数

参数类型必填说明
orderNumberstring是云订单号
响应示例
{
  "orderNumber": "CO202611150001",
  "amount": 699,
  "status": "confirmed",
  "payMethod": "balance",
  "paidAt": "2026-11-15T08:34:00Z"
}
  • 只有 pending 状态可支付。
  • 云梦建站可能在同一请求内继续推进到 provisioning / active,以详情返回为准。

07 / 域名实名

先建实名模板,再注册域名

注册 / 转入域名必须先有实名模板,审核通过后再下单。

注册 / 转入域名前必须先创建实名模板。模板提交上游审核,status=approved 后再下单。一个代理账号可以维护多个模板,分别对应不同客户。

GET/agent/contacts通讯密钥

实名模板列表

分页查询当前账号的域名实名模板,证件号脱敏返回。

请求参数

参数类型必填说明
keywordstring否模板名称 / 证件号 / 邮箱
pageinteger否页码
pageSizeinteger否每页条数
响应示例
{
  "items": [
    {
      "id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
      "templateId": 10001,
      "templateName": "示例科技有限公司",
      "type": "company",
      "certNoMasked": "**********1234",
      "email": "ops@example.com",
      "phone": "13800000000",
      "address": "山东省济宁市兖州区示例路 1 号",
      "postalCode": "272100",
      "status": "approved",
      "createdAt": "2026-11-15T08:00:00Z"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "totalPages": 1
}
  • 下单用的是模板 id,不是上游 templateId。
POST/agent/contacts通讯密钥

创建实名模板

提交个人 / 企业实名资料与证件照,成功后返回站内模板 Id 与上游审核状态。

请求参数

参数类型必填说明
typestring是personal / company
templateNamestring是模板名称 / 域名所有者,1–50 字
contactNamestring是联系人姓名
certNostring是证件号,按主体类型校验
emailstring是邮箱
phonestring是手机号 / 座机
citystring是城市
addressstring是详细地址
postalCodestring是邮政编码
nameEnstring是所有者英文名 / 企业英文名
contactEnstring是联系人英文名
addressEnstring是详细地址英文
idFrontBase64string是证件照正面,data URL 或纯 base64,≤ 2MB
请求示例
{
  "type": "company",
  "templateName": "示例科技有限公司",
  "contactName": "张三",
  "certNo": "91370000XXXXXXXXXX",
  "email": "ops@example.com",
  "phone": "13800000000",
  "city": "济宁",
  "address": "山东省济宁市兖州区示例路 1 号",
  "postalCode": "272100",
  "nameEn": "Example Technology Co., Ltd.",
  "contactEn": "Zhang San",
  "addressEn": "No. 1 Example Road, Yanzhou District, Jining, Shandong",
  "idFrontBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}
响应示例
{
  "id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "templateId": 10001,
  "templateName": "示例科技有限公司",
  "type": "company",
  "certNo": "91370000XXXXXXXXXX",
  "email": "ops@example.com",
  "phone": "13800000000",
  "city": "济宁",
  "address": "山东省济宁市兖州区示例路 1 号",
  "postalCode": "272100",
  "nameEn": "Example Technology Co., Ltd.",
  "contactEn": "Zhang San",
  "addressEn": "No. 1 Example Road, Yanzhou District, Jining, Shandong",
  "idFrontUrl": "/AppUpload/Image/example.jpg",
  "status": "pending",
  "createdAt": "2026-11-15T08:05:00Z"
}
  • 上游审核可能需要时间,建议在 status=approved 后再提交注册 / 转入订单。
  • 证件照只通过请求体上传,不要放在公网 URL 里。
GET/agent/contacts/{id}通讯密钥

实名模板详情

获取模板完整资料(含完整证件号与证件照地址)。

请求参数

参数类型必填说明
idstring是站内模板 Id
响应示例
同「创建实名模板」的响应,含完整证件号与证件照地址。
POST/agent/contacts/{id}/delete通讯密钥

删除实名模板

先调用上游删除,成功后软删除本地记录。

请求参数

参数类型必填说明
idstring是站内模板 Id
响应示例
204 No Content
  • 已关联域名的模板请先确认不会影响存量域名,再执行删除。

09 / 域名订单

注册、续费、转入与支付

创建订单只锁价,支付后才扣余额并进入上游开通。

域名订单状态:pending_payment → paid → processing → completed;失败进入 failed。创建订单不扣款,余额支付成功后才进入开通。当前代理 API 仅支持注册 / 续费 / 转入,SSL 证书请在会员中心购买。

GET/agent/domain-orders通讯密钥

域名订单列表

分页查询当前账号的域名订单。

请求参数

参数类型必填说明
statusstring否pending_payment / paid / processing / completed / failed / cancelled / refunded
keywordstring否订单号 / 域名
pageinteger否页码
pageSizeinteger否每页条数
POST/agent/domain-orders通讯密钥

创建域名订单

创建注册 / 续费 / 转入订单,金额按代理价落库。

请求参数

参数类型必填说明
typestring是register / renew / transfer
domainstring是完整域名
yearsinteger是域名 1–10 年;转入固定 1 年
contactIdstring是实名模板 Id;注册 / 转入必填
transferPasswordstring否转移密码;type=transfer 必填
remarkstring否订单备注
请求示例
{
  "type": "register",
  "domain": "example.com",
  "years": 1,
  "contactId": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "remark": "合作方系统下单"
}
响应示例
{
  "orderNumber": "DO202611150001",
  "type": "register",
  "domain": "example.com",
  "years": 1,
  "amount": 69,
  "currency": "CNY",
  "status": "pending_payment",
  "contactId": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "payments": [],
  "createdAt": "2026-11-15T08:32:00Z"
}
  • contactId 必须是当前账号下的实名模板 Id。
  • 创建订单不扣款;继续调用余额支付接口。
  • 域名订单没有幂等键,避免重复提交。
GET/agent/domain-orders/{orderNumber}通讯密钥

域名订单详情

按订单号获取域名、金额、状态、支付流水与开通结果。

请求参数

参数类型必填说明
orderNumberstring是域名订单号
响应示例
{
  "orderNumber": "DO202611150001",
  "type": "register",
  "domain": "example.com",
  "years": 1,
  "amount": 69,
  "currency": "CNY",
  "status": "pending_payment",
  "contactId": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "payments": [],
  "createdAt": "2026-11-15T08:32:00Z"
}
  • 开通成功后 result.expireTime 为域名到期时间。
  • lastError 非空时展示具体失败原因。
POST/agent/domain-orders/{orderNumber}/pay-balance通讯密钥

余额支付域名订单

从代理账号余额扣款并立即触发开通。

请求参数

参数类型必填说明
orderNumberstring是域名订单号
响应示例
{
  "method": "balance",
  "outTradeNo": "",
  "payUrl": null,
  "codeUrl": null,
  "expiresAt": "2026-11-15T08:33:00Z"
}
  • 只有 pending_payment 状态可以支付。
  • 余额支付成功后订单进入 paid,随后进入 processing。

10 / 错误与状态

先读 detail,再按 errorCode 处理

错误统一返回 ProblemDetails(application/problem+json),业务原因在 detail,机器可读错误码在 errorCode。

错误响应示例
{
  "type": "https://httpstatuses.com/400",
  "title": "Bad Request",
  "status": 400,
  "detail": "账户余额不足,请先充值",
  "instance": "/_api/agent/cloud-orders/CO202611150001/pay-balance",
  "errorCode": "validation_error"
}
HTTPerrorCode含义建议处理
400validation_error参数校验失败,或业务规则不允许当前操作。读取 detail 的真实原因;不要用笼统的「操作失败」覆盖。
401agent_unauthorized未带通讯密钥,或密钥不存在 / 已失效。在会员中心重新生成或轮换通讯密钥;不要拿会员 JWT 调用 /agent。
403agent_forbidden通讯密钥所属账号被禁用,或账号无权访问该资源。联系平台确认账号状态;不要用其他账号的密钥访问不属于自己的订单。
403anti_abuse_required / anti_abuse_invalid / anti_abuse_replayed防刷签名缺失、错误、时间戳过期或 nonce 重放。按「通讯密钥与防刷」重新计算 X-Ts / X-Nonce / X-Sig / X-Proof。
404not_found订单 / 模板 / 域名不存在,或不属于当前账号。先用订单列表确认订单号与账号归属。
409conflict资源状态冲突,或同一业务对象已存在。刷新详情后再决定是否继续;不要盲目重复创建。
428captcha_required当前请求触发人机验证。服务端对接场景请联系平台调整策略,不要在服务端伪造验证码。
500internal_error服务端异常。记录订单号与请求时间,联系平台排查;写操作先查详情再决定是否重试。

云订单状态

  • pending 待确认
  • confirmed 已确认收款
  • provisioning 开通中
  • active 已开通
  • cancelled 已取消

域名订单状态

  • pending_payment 待支付
  • paid 已支付
  • processing 开通中
  • completed 已完成
  • failed 开通失败
  • cancelled 已取消
  • refunded 已退款

建站续费状态

  • pending 待支付
  • paid 已支付
  • cancelled 已取消
  • failed 支付成功但续费失败

11 / 上线检查

正式对接前逐项确认

这份清单覆盖最容易在联调后期才暴露的问题:通讯密钥、签名、余额、重复下单与退款边界。

通讯密钥只在服务端保存,禁止写进浏览器、小程序或 App 前端。
按「通讯密钥与防刷」实现签名器,所有 /agent 请求都带 X-Ts / X-Nonce / X-Sig / X-Proof。
通讯密钥只能调用 /agent 接口;不要拿它调用会员中心 JWT 接口。
密钥泄露时立即在会员中心轮换;轮换后旧密钥马上失效。
下单前先查余额;余额不足先让平台入账或在会员中心充值,不要假设可以透支。
创建订单后以服务端返回的 orderNumber 与 amount 为准,不要使用前端计算金额。
写操作不要盲目重试;先用订单列表 / 详情按 orderNumber 对账。
域名注册前先创建实名模板,并确认模板 status=approved。
订单状态用轮询获取,建议 5–10 秒一次并做退避;当前不提供 Webhook 回调。
已支付订单的取消 / 退款走平台人工处理,不要自行调用取消接口。

12 / 联系与支持

会员开通、预充值、联调支持

对接前需要开通会员账号或确认预充值方式,直接联系商务;接口字段与联调问题可以走工单或电话。

开通会员与通讯密钥

说明你的业务类型、预计月下单量、主要产品(域名 / 建站)与结算方式,我们会给出账号开通与预充值流程。账号开通后,在个人资料自行生成通讯密钥。

技术支持

电话
0537-3855551
邮箱
admin@yunsucheng.com
地址
山东省济宁市兖州区新驿镇葛楼村208号

登录会员账号后可提交技术工单。