Z Zise Developers
/
API 参考 › 理财

改到期处理方式（枚举 principal_interest，不是 both）

PATCH /v1/earn/orders/{id}/rollover scope: earn:write
代会员调用 · 必带 x-on-behalf-of

只在到期之前可改：订单已经进入结算或已结清就拒

（state_invalid）。产品没开续期总闸时只能设 none。

⚠ 枚举只有三个：none / principal / principal_interest。

传 both 会被拒 —— 那个值在我方从来不存在，它是会员端一度发错的值。

这个端点不静默回落：传错就报错。

⚠ 这个端点不需要幂等键（它不动钱、且是幂等的 UPDATE）。

⚠ 改动会记进会员自己的理财时间线（带「由商户 API 发起」的标记），

终端用户看得到。

前置条件

  • 订单在这个会员名下且属于你（否则 404）
  • 订单尚未进入结算（pending_start / starting / accruing / pending_settle 四个状态之一）
  • 设 principal 或 principal_interest 时，产品必须是可续期的

路径参数

字段类型必填说明
id string 必填 定期订单 id。带不带 ero_ 前缀都认。
字段类型必填说明
x-on-behalf-of string 必填 订单所属会员。

请求体

字段类型必填说明
mode "none" | "principal" | "principal_interest" 必填 到期处理方式。必填，且必须严格是这三个值之一。 none = 到期本息回可用余额；principal = 只续本金， 利息回可用；principal_interest = 本息一起续。

响应

200已改。响应只回订单号与新的处理方式。
{
  "id": "ero_c41d7f92-8a03-4bb6-9e10-5f2c8d3a7061",
  "rollover_mode": "principal_interest"
}
400invalid_request mode 不在三个值之内（含传了 both）· state_invalid 产品不可续期，或订单已过可改窗口 · member_context_required · member_not_found
403insufficient_scope —— 这把 Key 没有 earn:write
404not_found —— 订单不存在、不在这个会员名下、或不属于你。 三种同一响应。
请求 
curl -X PATCH 'https://api.zise.com/v1/earn/orders/{id}/rollover' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID' \
  -H 'content-type: application/json' \
  -d '{
    "mode": "principal_interest"
  }'
const res = await fetch("https://api.zise.com/v1/earn/orders/{id}/rollover", {
  method: "PATCH",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "mode": "principal_interest"
  }),
});
// 金额按字符串读，别让它变成 number
const data = await res.json();
import requests

res = requests.patch(
    "https://api.zise.com/v1/earn/orders/{id}/rollover",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
        "content-type": "application/json",
    },
    json={
      "mode": "principal_interest"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()
req, _ := http.NewRequest("PATCH", "https://api.zise.com/v1/earn/orders/{id}/rollover",
    strings.NewReader(`{
  "mode": "principal_interest"
}`))
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
req.Header.Set("content-type", "application/json")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/earn/orders/{id}/rollover"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .header("content-type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString("""
{
  "mode": "principal_interest"
}
"""))
    .build();
// 金额字段用 String / BigDecimal，不要 double
$ch = curl_init('https://api.zise.com/v1/earn/orders/{id}/rollover');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PATCH',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
    'content-type: application/json',
  ],
  CURLOPT_POSTFIELDS => <<<'JSON'
{
  "mode": "principal_interest"
}
JSON,
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval
200 
{
  "id": "ero_c41d7f92-8a03-4bb6-9e10-5f2c8d3a7061",
  "rollover_mode": "principal_interest"
}