F88 Online 贷款账户里装着什么，以及触及它的授权路径

一个在用的 F88 Online 账户，会为借款人以车辆登记证抵押持有的每一笔在贷合同，保存一份还款计划——包括到期日、本金部分、利息，以及两项服务费。这份计划、随时更新的结清余额，以及放款历史，正是贷款方、聚合服务商或催收合作方真正需要的记录；它们藏在个人登录之后，而非任何公开数据源里。本文梳理 F88 Online（应用包名 vn.digital.digitalonline，据其 Play 商店页面）中的这些数据面，并说明我们触及它们的授权方式。

F88 以摩托车和汽车登记证作抵押放贷，据商店页面，金额从 300 万越南盾到 20 亿越南盾不等，期限 3 到 18 个月，通过现金或银行转账放款。对对接方来说，关键在于：有价值的状态是按合同区分的，且随着每月还款入账而逐月变化，因此这条连接必须跟踪一份计划，而不只是抓取一个余额快照。我们会基于借款人对自己账户的同意来搭建它，采用对 App 流量的授权分析——下文详述。

App 持有的借款人记录

下表每一行对应 App 向其登录用户开放的一个数据面。在有必要之处，字段名沿用 F88 在越南语中的表述。

数据如何触及

真正契合 F88 的路径有三条。它们并不等价，推荐意见随后给出。

基于同意的接口分析（我们会搭建的这一条）

借款人授权访问自己的 F88 账户；我们分析那些本就用来呈现贷款列表和分期视图的 App 与服务器之间的流量，随后针对这些接口实现一个干净的客户端。这条路径能触及上表中的一切，因为它触及的正是 App 自身所渲染的内容。工作量适中——大部分精力用在梳理登录与令牌流程，以及按合同区分的各个调用。逐月的稳定性良好，只在 F88 发布前端改动时需要重新核查。测试账户与授权事宜，我们会在启动阶段与您一同安排。

银行 Open API（仅用于转账那一段）

凡是通过银行转账放款或还款的资金往来，也存在于借款人所在的银行；随着越南国家银行逐步推行经同意的客户信息 API，这部分可依据 Circular 64/2024/TT-NHNN 触及。它不会返回 F88 的合同条款——它只印证资金往来，且仅限于持有该账户的那家银行。可作旁证，但范围狭窄。

原生导出

F88 以文件形式出具的合同与报价，可在借款人能提供它们的情况下导入，这适合一次性拉取，或用作对实时数据的核验。它不能替代持续的还款计划同步。

要搭建一条可用、可复现的连接，基于同意的接口路径才是值得建的那条；银行侧那一段只在客户明确需要核验转账部分时才值得加上；而导出始终是一个有用的交叉核验手段，而非数据源。

一次还款计划查询的示意

调用序列的示意形态——确切的接口和字段名会在搭建期间，针对一个已同意的账户加以确认。

POST /auth/login            # phone + credential -> session
  -> { "access_token": "...", "refresh_token": "...", "expires_in": 3600 }

GET  /loans?status=active   # Authorization: Bearer <access_token>
  -> [ { "contract_id": "F88-...", "package": "uu_dai_dung_han",
         "principal_vnd": 20000000, "term_months": 12,
         "repayment_type": "level_monthly" } ]

GET  /loans/{contract_id}/schedule
  -> { "apr_flat_pct": 24.6,                 # max flat rate per listing
       "installments": [
         { "due": "2026-07-15", "principal_vnd": 1666667,
           "interest_vnd": 246000, "mgmt_fee_vnd": 90000,
           "asset_fee_vnd": 73000, "status": "due" } ] }

# handle 401 -> refresh once via /auth/refresh; on repeat 401 stop and
# flag for re-consent. retry network 5xx with backoff, never on 4xx.

有两种分期形态必须都照顾到：每月等额本金加成本，以及每月只还成本、本金到期一次性偿还。计划接口会根据合同的 repayment_type 判定适用哪一种。

最终交付什么

成果是一条可用的连接，加上运行与维护它所需的文档，全部围绕 F88 的真实数据面展开：

• 一份 OpenAPI/Swagger 规范，覆盖登录、贷款列表、合同详情与还款计划调用。
• 一份协议与认证流程报告：令牌签发与刷新链路、会话处理，以及错误与重新授权的路径。
• 关键接口的可运行源代码（Python 或 Node.js），配一套规范化结构，把越南语字段和越南盾金额转成稳定的键。
• 针对贷款列表与还款计划响应的自动化测试，含两种还款形态与 401 刷新路径。
• 接口文档，以及符合越南法律的同意记录与数据留存指引。

同意与法律框架

F88 持有敏感的金融与身份记录，因此访问以借款人对自己账户的明示同意为基础。越南《个人数据保护法》（Law 91/2025/QH15）已于 2026 年 1 月 1 日生效，取代 Decree 13/2023；据我们查阅的法律摘要，它延续了以同意为核心的模式——同意必须具体且有记录，数据主体可以访问、撤回并请求删除。我们据此直接落实：访问范围限定在指定的贷款字段而非整个账户，同意与访问事件均被记录，存储的数据尽量精简，撤回后同步会干净停止、不留孤立副本。客户如有需要，可以签署保密协议覆盖本次合作。F88 本身是非银行贷款机构，其贷款条款不通过银行的 Open API 目录发布；对接的依据是借款人的授权，而非某个供应商的数据计划。

针对 F88 的对接要点

这款 App 有两点会影响具体工作，我们都会处理：

• 按套餐区分的费用逻辑。F88 运营着多种贷款套餐——通用套餐，外加针对提前结清违约、上班族、按时还款者及女性创业者的优惠套餐——每种各自设定贷款管理费、资产管理费与固定利息。我们把套餐规则映射清楚，让计划接口按每份合同返回正确的数字，而不是给出一条平均化的曲线。
• 门店密集网络中的线下事件。F88 让 App 与遍布越南的庞大实体门店网络配套运作，放款既有转账也有现金，因此部分合同活动源自柜台。我们把同步设计为将 App 可见状态与放款渠道对账，让现金和转账放款都以清晰事件落地。
• 前端漂移。面向消费者的 App，其界面会变。我们在维护中内置一道重新校验步骤，让某处布局或接口的改动在破坏借款人的计划拉取之前就被捕捉并修补。

访问权限、测试账户及任何授权文书，都会作为启动阶段的一部分与您一同安排——它们是项目中的步骤，而不是必须先清空的前置清单。

价格

源代码交付 300 美元起，且只在可用的 F88 Online 连接交到您手中、您满意之后才付款——您将获得可运行源代码、规范、测试与接口文档，完全归您所有。另一种选择是按调用计费的托管 API：我们托管这条连接，您调用我们的接口并按次付费，无需预付。无论哪种方式，搭建都以 1–2 周为周期。在联系页面告诉我们您需要 F88 的哪些数据、哪种模式更合适，我们便会为您评估。

数据时效与可靠性

由于余额只随每月分期还款入账而变动，每日同步通常已足够，另配一次按需刷新用于借款人索要结清金额时的报价。令牌有效期较短，因此客户端会静默刷新，只在刷新确实失败时才弹出重新授权提示。当 F88 更新 App 时，那道重新校验步骤能让连接保持可靠。

界面佐证

取自商店页面的 App 截图，有助于确认某次搭建针对哪些数据面。

本文如何核查

梳理工作由 OpenBanking Studio 集成团队于 2026 年 6 月 28 日完成。我们从 F88 自己的商店页面读取贷款金额、期限、套餐组合、费用结构与固定年化（APR）数字；从越南商业媒体获取公司与融资背景；并对照 Circular 64 与越南数据保护法的法律摘要，确认了监管框架。

• F88 Online —— Google Play 页面
• VnExpress —— F88 融资 5000 万美元（公司背景）
• Tilleke & Gibbins —— 越南银行业 Open API（Circular 64）
• Hogan Lovells —— 越南《个人数据保护法》

同一数据领域的同类应用

对接方常与 F88 一并接入的贷款机构与钱包，各自持有可比的按用户金融记录，都能汇入同一个统一接口。

• FE Credit (FE ONLINE) —— 消费金融 App，含贷款账户与还款计划。
• Home Credit Vietnam —— 分期贷款与消费场景金融，具备按合同状态。
• Timo —— 数字银行，含账户、转账与分期贷款。
• MoMo —— 钱包超级 App，通过合作银行提供小额贷款与先享后付。
• ZaloPay —— 钱包，含支付历史与信贷功能。
• Viettel Money —— 移动货币服务，含余额与交易记录。
• Cake by VPBank —— 数字银行，持有账户与信贷数据。
• Vietdong —— 短期线上贷款机构，含贷款与期限记录。

对接方常问的问题

越南开放银行的 Circular 64 是否适用于 F88 Online 对接？

Circular 64/2024/TT-NHNN 规范的是商业银行发布的 Open API；F88 是非银行抵押贷款机构，其借款人数据并不通过银行的 Open API 目录提供。可靠的依据是借款人本人对访问其账户的同意，对接则通过对该 App 自身流量的授权接口分析来实现。若某笔贷款是通过银行转账放款的，待相关阶段落地后，银行侧那一段可以后续经由 Circular 64 触及。

能否按各自的费用方案读取每一种 F88 Online 贷款套餐？

可以。根据其商店页面，F88 提供多种套餐——一个通用套餐，外加针对提前结清违约、上班族、按时还款者以及女性创业者的优惠套餐。每种套餐各有自己的贷款管理费、资产管理费与固定利息，以及两种还款方式（每月等额本金加成本，或每月只还成本、本金到期一次性偿还）。我们对套餐与还款方式进行建模，使单一的还款计划接口返回的数字与签署合同一致。

在越南数据法框架下如何处理借款人同意？

越南《个人数据保护法》（Law 91/2025/QH15，于 2026 年 1 月 1 日生效，取代 Decree 13/2023）要求同意必须具体、有记录且可撤回，并承认借款人享有访问、撤回与请求删除的权利。我们将访问范围限定在指定的贷款字段，保留同意与访问日志，尽量减少存储内容，并将撤回设计为能够干净地停止同步。

现金放款与银行转账放款分别如何呈现？

F88 通过门店现金或银行转账放款，并在 App 之外运营着庞大的实体网络，因此部分合同事件源自线下。我们将 App 可见状态与放款渠道进行对账，使一笔现金放款和一笔转账放款都以清晰事件落入规范化结构，而不是表现为数据空缺。