读取 CóLiền: Vay Online Uy Tín 内部的贷款台账

一个 CóLiền 账户远不止一个数字。该应用描述的是 500,000 至 50,000,000 越南盾、在 90 至 365 天内分最多 12 期偿还的贷款，每期的利息与本金都在应用内展示——这些均据其 Play Store 页面，其中一个示例把 50,000,000 越南盾的贷款拆成四期、每期 30 天。在一位已登录借款人的背后，是一次授信额度评估、一份还款计划、一份费用明细、与越南公民身份证绑定的身份记录，以及放款到账的那个银行账户。这才是值得对接的实质内容，而其中大部分若无人刻意读取，就不会离开已认证的会话。

我们在这里会采取的路径，是在获得同意的前提下读取应用自身的流量，并规整成一套干净的数据结构。若参与方希望把对接放进受监管的通道，越南国家银行的沙盒已把 Open API 列为一条获准路径。两条路指向同一交付物：一种有文档、可运行、可按需拉取某位借款人贷款状态的方式。

CóLiền 为每位借款人持有什么

每一行都对应借款人本就看得到的一个界面。对接只是让同样的字段可被系统读取，而不再只是被人眼看到。

获取贷款数据的授权路径

授权协议读取

在借款人授权下，我们分析应用用于登录、额度评估、贷款状态与计划的请求—响应链，再把它重建为一小组带类型的调用。这条路径触及最丰富的数据面——按期的计划与费用明细——并且与应用贴合紧密。它在前端变动时需要一个重新校验步骤，这一点我们已提前规划。对于 CóLiền，这也是我们推荐的路径，因为价值就在分期级别的细节里，而这些细节存在于会话之中。

受监管的 Open API 通道

2025 年 7 月 1 日生效的第 94/2025/ND-CP 号法令，允许银行业参与方在 SBV 沙盒内运行 Open API 方案，期限最长两年。当目标是一条持续、受监管的数据源，而非单用户读取时，我们会把对接设计得契合该通道。搭建耗时更长，需与你及相关对手方共同安排；回报则是合规地位。

用户授权的凭据会话

对于一位只想汇总自己财务状况的借款人，用其授权凭据对其账户发起会话，可直接返回其贷款与计划。设计上范围收窄，也是越南数据规则下最干净的依据。

请求流程一览

仅为示意形态——确切端点与令牌格式在开发期针对实时应用确认，并非在此断言。

# 授权读取：先认证，再拉取某位借款人的计划
POST /api/auth/otp/verify
  { "phone": "+84•••", "otp": "######", "device_id": "<bound>" }
  -> 200 { "access_token": "...", "expires_in": 1800 }

GET /api/loan/active
  Authorization: Bearer <access_token>
  -> 200 {
       "loan_id": "...",
       "principal_vnd": 50000000,
       "term_days": 120,
       "periods": 4,
       "apr_pct": 18.25            # 在页面所述的 36% 上限之内
     }

GET /api/loan/{loan_id}/schedule
  -> 200 { "installments": [
       { "seq": 1, "due": "...", "principal_vnd": 12500000,
         "interest_vnd": 750000, "status": "due" }, ... ] }

# 处理：401 时刷新令牌，429 时重试/退避，
# 把越南盾金额按整数规整，并标记任何缺少到期日的期。

解析器把金额保留为整数越南盾，绝不使用浮点数，因此与借款人银行记录对账时始终精确。

交付到你仓库的内容

• 一份 OpenAPI 规范，覆盖鉴权握手、贷款读取与计划读取，并固定越南盾字段类型。
• 一份协议与鉴权流程报告：OTP 到令牌的时序、刷新行为，以及会话所依赖的请求头。
• 关键调用的可运行源代码（Python 或 Node.js）——额度状态、在贷贷款、分期计划——已处理好重试与令牌刷新。
• 一套规整后的数据结构，把计划转成每期一行，可直接入库。
• 基于所捕获请求与响应样本构建的自动化测试，使日后的改动会明确报错。
• 接口文档，外加一份关于同意记录与数据留存的简短说明，让读取在越南规则下可审计。

同意与越南的规则体系

这里的消费信贷归越南国家银行监管，个人数据则受《个人数据保护法》约束——该法自 2026 年 1 月 1 日起施行，建立在第 13/2023 号法令之上。该框架仍以明确、自愿、可撤回的同意作为主要合法依据，并对金融与信贷数据增加了专门义务。我们直接照此执行：在任何读取之前先记录同意范围，把对接设计成借款人一旦撤回即停止拉取，并只读取用例所需的字段——一款提醒类产品并不需要完整的 KYC 记录。每一次读取都有日志，若对手方需要，我们也会签署保密协议。这是我们的工作方式，而不是摆到你面前的一堆表格。

我们会处理的工程实况

CóLiền 有两点会影响开发，我们对两者都做了应对。

其一，贷款经济学是按期计算的，而非单一的年化利率一行。页面显示利息按每 30 天一期、在未还本金上累计。我们把计划按期粒度建模，让镜像台账与应用分毫不差，而不是从年化利率反推、结果越算越偏。

其二，这是一款快速放款的产品——流程从约 5 分钟的申请走到资金进入绑定银行账户，有时只需几分钟。贷款生命周期早期状态变化很快，因此我们会调校同步节奏以捕捉从评估到放款的切换，并把读取设计成幂等，使重试绝不会把某一期重复计入。开发所需的访问在入驻期间与你安排，视合作情况针对一个已同意的账户或一个受监管的沙盒进行。

团队把它用在哪里

• 一款个人理财聚合产品，把已同意用户的 CóLiền 贷款与即将到期的分期，与其他账户并列展示。
• 放贷方或合作方，用它把已放本金与借款人的银行结算记录对账。
• 一项逾期或提醒服务，读取计划以在某一期到期前预警。

我们对照梳理的界面

来源与审阅

数据域来自应用自身的 Play Store 页面及其描述的流程；监管要点来自下列越南沙盒与数据保护资料，于 2026 年 6 月查阅。此处的标识与数字均归于这些来源，并非我们独立断言。

• CóLiền Google Play 页面
• Indochine Counsel——越南金融科技沙盒（第 94/2025 号法令）
• Hogan Lovells——越南《个人数据保护法》
• Watson Farley & Williams——第 13/2023 号法令

由 OpenBanking Studio 对接团队梳理，2026 年 6 月 25 日。

同一领域内的其他越南借贷与钱包应用

它们持有可比的每用户金融状态，这也是为什么"在其中数款之上建一层统一规整的对接"是常见需求。此处仅作背景列出，不作排名。

• Home Credit Tài Chính Online——分期与现金贷，带每笔贷款计划与费用披露。
• FE ONLINE 2.0——FE Credit 的应用，持有递减利率贷款与还款方案。
• Cake by VPBank——一家数字银行，除借贷外还提供账户、卡与信贷。
• MoMo——一款带余额、转账与嵌入式信贷额度的钱包。
• Viettel Money——Viettel 的钱包与金融服务，含交易记录。
• Doctor Đồng——短期线上现金贷，带额度与计划数据。
• Robocash——自动化的小额线上贷款，当天放款，逐笔状态。
• MoneyCat——分期现金借贷，带申请与计划记录。
• Tima——一个借贷撮合平台，把借款人与放贷方案及还款跟踪连接起来。

对接方常问 CóLiền 的问题

CóLiền 是按借款人给出每笔分期计划，还是只有一个滚动余额？

据其 Play Store 页面，该应用发放 90 至 365 天、最多 12 期的分期贷款，因此每个授权账户都带有一份完整计划：每期本金、每期利息、到期日与已还状态。协议开发读取的是这个计划对象，而不仅是一个笼统的未还总额，并会把它规整成可同步的分期结构。

越南国家银行的金融科技沙盒与对接这款应用有关吗？

可能有关。2025 年 7 月 1 日生效的第 94/2025/ND-CP 号法令，将 Open API 与信用评分、P2P 借贷并列，定为银行业沙盒允许的三类方案之一。若参与方希望获得受监管的持续数据源，我们会把对接设计在该路径之内；若只需在授权下直接读取某一位借款人的数据，我们则依据该用户的授权针对应用自身流量进行开发。

越南《个人数据保护法》如何影响一次授权对接？

《个人数据保护法》于 2026 年 1 月 1 日生效，在第 13/2023 号法令基础上，仍以明确、自愿、可撤回的同意作为主要合法依据，并对金融与信贷数据增加了专门义务。我们会记录同意范围、为撤回预留设计、只读取用例所需字段，并保留访问日志，使每一次读取都有据可查。

如果 CóLiền 改动了应用流程，对接会失效吗？

授权协议读取跟随实时应用，因此前端或令牌格式变动可能改变字段。我们把鉴权层与解析层隔离，使一次改动只影响单个模块；在开发期间捕获请求与响应样本，并在维护中加入重新校验步骤，以便在偏差影响到你的数据之前就被发现。

CóLiền 的合作以两种方式之一结算。我们交付可运行源代码——OpenAPI 规范、贷款与计划调用、测试与接口文档——固定费用起价 300 美元，且只在交付后、达到你满意时才付款；或者你跳过自建，直接调用我们的托管端点，按调用付费、无需预付。两条路都在 1 到 2 周内完成一个周期。把应用名称和你想从其贷款数据里得到什么告诉我们，就在联系页面，我们会为你评估范围。