Z Zise Developers
/
API 参考 › 理财
PATCH /v1/earn/orders/{id}/rollover

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

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 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID' \
  -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: {
      "authorization": "Bearer $TOKEN",
      "x-zise-merchant": "MERCHANT_ID",
      "x-on-behalf-of": "MEMBER_ID",
      "content-type": "application/json"
    },
    body: JSON.stringify({
      "mode": "principal_interest"
    }),
  },
);
// 金额一律按字符串读，不要 JSON.parse 成 number
const data = await res.json();
import requests

res = requests.patch(
    "https://api.zise.com/v1/earn/orders/{id}/rollover",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID",
        "x-on-behalf-of": "$MEMBER_ID",
        "content-type": "application/json"
    },
    json={
        "mode": "principal_interest"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()