保管存款
一个需求账户,持有者把钱放进去,随时取出,金额得到保证——不承诺归还,也不欠任何款项.
账户可能还支付一些钱。 POST /bonus 记录对持有人的付款,这正是所谓的:a 奖金,不是回报。这是账户管理人的权利,而不是持有人的权利,其规模在支付时决定;不事先宣布,不应计,不欠;预先承诺的金额是使用更友好的名称的利息,产品将成为另一种产品。
你们的整合有两个后果:在这个账户上没有任何费率栏,也没有批准阶段——开立一个需求账户,而无论在读哪一个版本,都没有第三方的结论.
基础路径 : /api/v1/pfp/safekeeping-deposits · 宗教读物: 瓦迪亚
两份拘留表
custody_type | 保管人可以动用资金 | 校长 |
|---|---|---|
safekeeping_only | 否——纯粹的监护权 | 持有,未使用 |
guaranteed | 对 | 按面值担保 |
guaranteed 是普通的经常账户安排:资金被使用,持有人保证能够确切地收回所投入的资金。 safekeeping_only 严格意义上的监护权。
反应带有衍生布尔值 guaranteed 并列 custody_type,所以你不必知道哪一个enum值意味着保证。
状态
pending ──activate──> active ──block──> blocked
│ <──unblock──┘
│
└──close──> closed
| 状态 | 含义 |
|---|---|
pending | 已创建, 尚未打开 |
active | 开放;接受存款、提款、奖金 |
blocked | 冻结,需要 reason |
closed | 终端 |
没有 under_review, no review_passed 且无 rejected. ** 此产品在两种读物中都没有批准阶段** ——要求一个帐户的过渡意味着该帐户已经与融资合同混淆。
打开账户
POST /api/v1/pfp/safekeeping-deposits
{
"customer_id": "8f2a1c44-0b6e-4d51-9a3f-1c8e5b7d2a90",
"region": "RU",
"currency": "RUB",
"custody_type": "guaranteed",
"initial_amount": "0",
"minimum_balance": "100000",
"account_id": "d4b7e211-8c05-4f39-a6be-7213c9e0f584",
"opened_by": "branch-kzn-04"
}
| 外地 | 类型 | 要求数 | 说明 |
|---|---|---|---|
customer_id | uuid | ✅ | 持有人 |
region | string | ✅ | 账户区域 |
currency | string | ✅ | ISO 4217 |
custody_type | enum | ✅ | safekeeping_only | guaranteed |
initial_amount | string | ✅ | 最小货币单位。 零号被允许 (^\d+$) |
minimum_balance | string | — | 小单位,零允许 |
account_id | uuid | — | 链接业务账户 |
opened_by | string | — | 免费文本 |
metadata | object | — | 返回未动 |
initial_amount 和 minimum_balance 是这个产品家族中接受的两种数量字段 "0"。账户经常是空的,并在之后获得资金,零的门槛是一个真正的设置。
注意响应中的两种情况："minimum_balance": null 表示未设置最低余额，"minimum_balance": "0" 表示最低余额为零。current_balance 绝不会为 null；新账户的余额为 "0"，而非缺失。
进退两难
三个都要求账户是: active. On a pending, blocked or closed 他们被拒之门外
交存
POST /api/v1/pfp/safekeeping-deposits/{id}/deposit
{ "amount": "50000000" }
添加到 current_balance 和 total_deposits递增数 transactions_count.
撤销
POST /api/v1/pfp/safekeeping-deposits/{id}/withdraw
{ "amount": "12000000" }
添加到 total_withdrawals。如果扣除以下余额,则拒绝 minimum_balance.
奖金
POST /api/v1/pfp/safekeeping-deposits/{id}/bonus
{ "amount": "180000", "reason": "Year-end appreciation" }
amount 需要, reason 可选。累积在 total_bonus_received 和附件为 bonus_history.
这是由保管人斟酌决定的付款,账户中没有任何款项提前宣布,持有者今年收到付款,则明年没有债权。
冻结和关闭
POST /api/v1/pfp/safekeeping-deposits/{id}/activate # no body, pending → active
POST /api/v1/pfp/safekeeping-deposits/{id}/block # reason required
POST /api/v1/pfp/safekeeping-deposits/{id}/unblock # no body
POST /api/v1/pfp/safekeeping-deposits/{id}/close # closed_by optional
列表和读取
GET /api/v1/pfp/safekeeping-deposits
| 查询参数 | 数值 |
|---|---|
status | pending | active | blocked | closed |
region | 账户区域 |
customer_id | uuid (英语). |
type | safekeeping_only | guaranteed |
min_balance | 最小货币单位, ^\d+$ ——本余额或以上账户. |
env | test | prod |
一个省略的过滤器没有附加任何条件 。 发送一个空字符串给一个—— 一个未填充的窗体字段产生的东西—— 得到同样的处理, 所以一个部分填充的搜索表不会将设定的结果折叠为空 。
GET /api/v1/pfp/safekeeping-deposits/{id}
{
"data": {
"id": "7c0b8a1e-0a5e-4a3f-9b6d-2f1f3a4b5c6d",
"deposit_number": "SFK-G-RU-20260823-1B4E07",
"status": "active",
"custody_type": "guaranteed",
"guaranteed": true,
"currency": "RUB",
"current_balance": "38180000",
"initial_amount": "0",
"minimum_balance": "100000",
"total_deposits": "50000000",
"total_withdrawals": "12000000",
"total_bonus_received": "180000",
"bonus_history": [
{ "date": "2026-12-31", "amount": "180000", "reason": "Year-end appreciation" }
],
"bonus_rate_annualized": 0,
"transactions_count": 3
}
}
bonus_rate_annualized 是后视镜
答复中包括按账户年龄计算的实际支付的奖金的年度数字。 ** 这是一份关于过去的报告,而不是一个费率。** 只有在帐户有开户日期时才出现;在那之前是 0.
不要向持卡人出示账户所付的奖金。 任何关于去年所付奖金的奖金都不要让任何人承担下一年的奖金,一个百分率标志旁边显示的号码,无论旁边贴着什么标签,都会被读作承诺。