投资存款

定期存款的回报取决于集合资金的实际收益。 存款人和账户管理人同意利润分成; 存款人承担损失。

这就是交易,作为不保证利率的交换,存款人得到的结果份额可能比利率好,而且可能根本不是。 API 将两者隔离在它所能做到的任何地方: 没有速率球场, indicative_rate 明确标注为对过去时期的审视,以及 record_loss 减少储户的余额,同时使保管人一方不受影响。

基础路径 : /api/v1/pfp/investment-deposits · 宗教读物: 穆达拉巴存款

---

两种表格

investment_type	钱到哪里去了?
general (默认)	一般投资池
restricted	仅指在 investment_restrictions

---

状态

pending ──activate──> active ──mature──> matured ──close──> closed
                        │                   │
                        │                   └──renew──> active
                        │
                        └──withdraw──> withdrawn ──close──> closed

状态	含义
pending	申请已记录,资金尚未接受
active	开放;损益记入帐内
matured	学期已经过去
withdrawn	早点出来
closed	钱付了,终点站

---

打开押金

POST /api/v1/pfp/investment-deposits

{
  "customer_id": "8f2a1c44-0b6e-4d51-9a3f-1c8e5b7d2a90",
  "region": "RU",
  "currency": "RUB",
  "initial_amount": "50000000",
  "term_months": 12,
  "profit_sharing_ratio": { "bank": 20, "customer": 80 },
  "investment_type": "general",
  "distribution_frequency": "quarterly",
  "indicative_rate": 7,
  "early_withdrawal_allowed": true,
  "early_withdrawal_penalty_percent": 50,
  "auto_renewal": false
}

外地	类型	要求数	说明
customer_id	uuid	✅	储户
region	string	✅	交存区域
currency	string	✅	ISO 4217
initial_amount	string	✅	最小货币单位,0以上
term_months	integer	✅	1–120
profit_sharing_ratio	object	✅	{"bank": n, "customer": m}整个百分比, 必须是总和 100
investment_type	enum	—	general （默认） | restricted
investment_restrictions	array	—	把钱放进去,因为... restricted
distribution_frequency	enum	—	monthly | quarterly | semi_annually | at_maturity
indicative_rate	integer	—	整个百分比 -- 见下文
early_withdrawal_allowed	boolean	—	提前退出的过渡
early_withdrawal_penalty_percent	integer	—	0–100适用于储户的应计份额, ** 没有** 押金
auto_renewal	boolean	—
account_id, product_id, opened_by, metadata	—	—

indicative_rate 不是一个费率

它记录了可比较的时期,没有许诺,没有累积,也没有用于平台的任何计算,没有任何内容可以回读。

把它展示给储户,只附着“指示”一词,而永远不要处于固定利率产品显示其速率的位置。 处于这一位置的某个数字被理解为承诺,而不管其旁边的标签是什么,而承诺恰恰是这种产品所没有的。

distribution_frequency: "at_maturity" 确切的意思是——第一个也是唯一的分配日期是到期日期,而不是日历上的一个步骤.

---

激活( A)

POST /api/v1/pfp/investment-deposits/{id}/activate

{
  "compliance_review": {
    "approved_by": "Product Committee, minutes 22/2026"
  }
}

pending → active,设置开盘日期,到期日和第一次发行日期.

身体在世俗读物中是可选的. ** 如果你发送一个 compliance_review,它被验证** — approved_by 在宗教读物中,需要结论,并且没有失败的激活。

与合同产品不同,没有单独的 submit/review 这里的对子:如果有,则在打开时附上结论。

---

损益

分配利润

POST /api/v1/pfp/investment-deposits/{id}/profit

{ "gross_profit": "1200000", "period_end_date": "2026-12-31" }

仅来自 active拆分为 profit_sharing_ratio; 储户的份额被添加到 current_value 转至 customer_profit_share守门人要 bank_profit_share。录入 profit_distributions:

{
  "profit_distributions": [
    {
      "date": "2026-12-31",
      "gross_profit": "1200000",
      "customer_share": "960000",
      "bank_share": "240000"
    }
  ]
}

period_end_date 是可选的,但默认为今天。

零是正当的报告。 一个赚不到钱的时期仍然结束,并且仍然推进下一个分配日期。 否定被拒绝,那就是损失,它有自己的过渡。

记录损失

POST /api/v1/pfp/investment-deposits/{id}/loss

{ "amount": "300000", "period_end_date": "2027-03-31" }

减少 current_value ——存款人的钱 保管人一方不受影响,因为保管人不放钱:它损失的是工作.

零号被这里拒绝。 period_end_date 是可选的,但默认为今天。

---

结束了押金

成熟度

POST /api/v1/pfp/investment-deposits/{id}/mature

无需请求体。active → matured，且仅在实际到期日已到达时才可执行。十二个月的存款不能今天就到期，否则存款人会失去仍应获得的分配收益。

更新

POST /api/v1/pfp/investment-deposits/{id}/renew

{ "term_months": 24, "profit_sharing_ratio": { "bank": 25, "customer": 75 } }

仅来自 matured; 两种字段都是可选的, 并且默认了现有术语。 所累积的内容成为新的本金, 存款返回到 active.

新的比率恰好在开业时得到验证——它仍必须等于 100与任何其他人一样,续期存款在新到期时关闭。

提前撤离

POST /api/v1/pfp/investment-deposits/{id}/withdraw

{ "closed_by": "branch-kzn-04" }

仅来自 active,以及 只有在 early_withdrawal_allowed 设定于开机时 否则,该请求将被拒绝:

{
  "error": "unprocessable_entity",
  "details": {
    "early_withdrawal_allowed": ["досрочное снятие условиями не предусмотрено"]
  }
}

处罚从 存款人的应计利润份额,而不是从存款本身:

penalty     = customer_profit_share × early_withdrawal_penalty_percent / 100
final_value = max(current_value − penalty, 0)

所投入的不是提前撤出而削减的——只是从中挣得的。 early_withdrawal_penalty_percent: 50 和应计份额 960 000惩罚是 480 000校长是完整的。

详细情况是: metadata.early_withdrawal:

{
  "early_withdrawal": {
    "penalty_amount": "480000",
    "penalty_percent": "50",
    "final_value": "50480000"
  }
}

关闭

POST /api/v1/pfp/investment-deposits/{id}/close

{ "closed_by": "branch-kzn-04" }

从 matured or withdrawn设置 closed_at. 终端——关闭的存款不能再次关闭,关闭日期不能覆盖。

---

列表和读取

GET /api/v1/pfp/investment-deposits

查询参数	数值
status	pending | active | matured | withdrawn | closed
region	交存区域
type	general | restricted
customer_id	uuid (英语).
env	test | prod

GET /api/v1/pfp/investment-deposits/{id}