在 เงินเหลือในกระเป๋า 内取到借款人的额度与还款计划

借款人看到的是一条授信额度——说明页把它放在 ฿10,000–฿30,000，期限 91 到 365 天，APR 同一份说明封顶在 21.9%——而这些数字每一个都以服务端记录的形式存在于登录之后，并不是一张静态页面。这才是值得对接的部分。据 App 自己的描述，平台由 YUANYI TECHNOLOGY COMPANY LIMITED 运营，并以 T OFFMONEY KAMPHAENGPHET CO., LTD. 的小额信贷牌照提供服务。对于需要从这款 App 里拿到借款人实时状况的放款方、催收合作伙伴或个人理财聚合平台，可行的路径是基于同意的接口对接：我们在借款人授权下分析 App 自身的客户端到服务端流量，再把它重建为一套干净的 API。这就是本页要梳理的东西。

账户里究竟有什么

下面是借款人在 App 里会接触到的各个界面，逐一对应到它们的来源，以及对接方能拿它做什么。还款计划那几行是最密集的——说明页把一个算到萨当（satang）的示例都摆了出来。

一次还款计划调用，重建后的样子

下面是在协议分析阶段、借款人会话建立之后，我们所还原的请求形态。字段名是示意性的，会在开发时对照真实流量确认；响应部分则建模了说明页所描述的分期方案。

GET /v1/loan/{loan_id}/schedule
Authorization: Bearer <session_token>   # captured via consented login, refreshed on 401

# normalized response (we flatten the app's own payload to this)
{
  "loan_id": "LN-…",
  "principal": 10000.00,
  "currency": "THB",
  "apr": 0.219,                 # cap per listing; verified per loan
  "term_days": 150,
  "installments": [
    {"seq": 1, "due_in_days": 50, "principal": 3300.00, "interest": 300.00, "due": 3600.00},
    {"seq": 2, "due_in_days": 100, "principal": 3300.00, "interest": 300.00, "due": 3600.00},
    {"seq": 3, "due_in_days": 150, "principal": 3400.00, "interest": 300.00, "due": 3700.00}
  ],
  "total_repayable": 10900.00
}

# interest per installment we recompute and reconcile:
#   principal_total * apr / 365 * days_in_period
#   10000 * 0.219 / 365 * 50  ->  300.00  (matches the listing's worked example)

那句对账注释很关键：我们不盲信界面上显示的总额，而是自己重算一遍，把任何偏差标出来。如果 App 的取整方式和我们的模型不一致，这会在测试套件里暴露，而不是在生产环境里出问题。

你的代码库里会多出什么

交付物是这套对接本身，而不是一份关于它的报告。对这款 App 而言，具体是：

• 一份 OpenAPI 规范，覆盖借款、计划、计提、状态与交易读取——也就是上表里的那些界面。
• 一份协议与鉴权流程说明：同意登录、会话令牌链，以及这里实际运行的 401 刷新行为。
• 关键接口的可运行源代码，Python 与 Node.js 两版，含还款计划的"重算并对账"这一步。
• 自动化测试，用说明页的示例和一个已授权账户来校验分期算术。
• 接口文档，以及依 PDPA 制定的数据留存与同意留痕指引。

适用于本例的路径

基于同意的接口对接（我们会采用的这一种）

我们在借款人授权下分析 App 的客户端到服务端调用，再把它们重建为上面那套 API。这能触及借款人所能看到的一切——额度、计划、计提、状态、交易——也是最契合这类单一发行方 App 的路径。只要我们持续盯着客户端，稳定性就不错；接入阶段，工作室会与你一起处理访问方式和那个用于测试的授权账户。这就是我们的建议：对于一家还没有跨行数据共享机制可搭乘的小额放款方来说，借款人自己的会话就是通往其记录最干净、也最完整的一条路。

用户授权的凭据访问

在合作方已经和借款人建立关系的场景里，同一个授权会话可以代表借款人被驱动，用于周期性同步，而不只是一次性读取。上面的接口工作一旦就位，这一步投入很小；它复用同一套鉴权链。

原生导出，作为兜底

如果借款人能从 App 里导出或截图一份账单，那只覆盖一个静态快照——没有实时计提，也没有事件流。我们把它当作回填来源，而非主要数据流。

同意与泰国的规则手册

有两套法规同时作用于这款 App。放贷这一侧落在泰国的小额信贷框架内，经由财政部（Ministry of Finance）监管，小额放款方可收取的综合实际利率是有上限的——说明页里的 21.9% APR 稳稳落在其中。数据这一侧则是 PDPA，自 2022 年 6 月起施行，紧扣 GDPR 制定，其核心是数据主体针对特定目的给出的同意。

因此，任何抽取的可靠依据都是借款人本人的授权，采集时带有明确的范围、有效期和撤销路径，并保留同意记录与访问日志。泰国央行（Bank of Thailand）已就消费者数据可携带方向开展过咨询（其 2025 年初的 "Your Data" 公开听证会）；泰国的开放数据访问未来或许走向那里，但它并不是一条今天就能调用的实际通道，所以我们不在其上开工——我们如今建立在同意之上，同时留出余地，一旦可携带 API 落地便可接入。数据被最小化到所述目的所必需的范围，客户若需要，还可用 NDA 覆盖整个合作。

这次对接我们会处理的几件事

• 不均等的本金拆分。说明页的示例把本金按 33% / 33% / 34% 分摊到三期，利息按每个 งวด 计算。我们精确复现这套拆分和取整，让计划与 App 的泰铢数字对得上，并把每期长度做成参数，而不是把 50 天写死。
• 获批额度 ≠ 宣传区间。真实额度来自平台的评估，而非 ฿10k–฿30k 的目录区间。我们把获批额度建模为独立字段，让下游系统绝不会想当然地按上限处理。
• 登记主体。运营方（YUANYI TECHNOLOGY）与持牌方（T OFFMONEY KAMPHAENGPHET）并不相同。我们给每条抽取记录打上持牌放款方标记，让登记在册的放款方始终可审计。
• 会话生命周期。我们围绕 App 的令牌过期与刷新行为来设计同步，让长时间运行的拉取能续期，而不是悄无声息地卡住。当 App 客户端发生变化时，维护中的一次重新校验会捕捉到这种漂移。

它会怎样被用起来

1. 一个催收平台每晚同步每位借款人的实时分期计划，按下一期到期日与金额触发提醒。
2. 一个个人理财聚合应用，把借款人的完整还款计划与剩余余额，和其他泰国 App 的账户并排展示。
3. 一个稽核工具逐笔按 21.9% 上限重算利息，标出任何偏离预期计提的分期。
4. 一个入件看板镜像智能评估的审批状态，让合作方近乎实时地看到申请一件件被处理。

接口证据

存放我们所梳理的、面向借款人的各流程截图。点按可放大。

同类泰国借贷应用

同一类别，当借款人或合作方横跨多家放款方、而你想要一条归一化数据流时会很有用。此处列出仅供参照，并非排名。

• MoneyThunder — SCBX 集团旗下 ABACUS digital 的数字借贷；借款额度与还款记录都藏在登录之后。
• FINNIX — SCBX 关联公司 MONIX 提供的微额贷款；含每位用户的授信额度与分期历史。
• Line BK — 开泰银行（Kasikornbank）与 LINE 的合资项目；存款与数字借贷余额都在 LINE App 内。
• PROMISE สินเชื่อส่วนบุคคล — 个人贷款账户，带还款计划与账单。
• K PLUS — 开泰银行（KASIKORNBANK）的手机银行 App；账户、转账与关联的贷款产品。
• PayPaya — 现金贷 App，含审批状态与还款账本。
• ยืมเลย — 线上现金贷 App，按借款人持有额度与还款数据。
• Muangthai Capital — 车辆抵押与个人贷款，含结构化的贷款账户。

本页是怎样核对的

2026 年 6 月 24 日，对照 App 自己的 Play 商店说明（运营方、持牌方、借款区间、期限、APR 上限以及那个逐步演算的分期示例）加以梳理，再把泰国小额信贷牌照、PDPA，以及泰国央行的数据可携带咨询逐一对照一手来源核查：

• G.A.M. Legal Alliance —— 泰国小额信贷框架与利率上限
• 泰国 PDPA 概览（2022 年 6 月生效，与 GDPR 对齐）
• 泰国央行 —— "Your Data" 消费者数据可携带咨询
• 泰国央行 —— 持牌放款方查询

本次梳理由 OpenBanking Studio 集成团队于 2026-06-24 审阅。

对接方常问的问题

还款计划能被完整还原吗，包括 33/33/34 这种不均等的本金拆分？

可以。应用商店说明写明本金按大约 33%、33%、34% 分摊到各期，利息按本金乘以 APR 除以 365 再乘以每个 งวด 的天数计算。我们复现这套算术和取整规则，让计算出的计划与 App 上的数字对得上，精确到萨当（satang），并在开发阶段用一个已授权账户加以核验。

到底是哪一家泰国主体持有借款人数据——YUANYI 还是那家小额信贷持牌方？

根据应用商店说明，平台由 YUANYI TECHNOLOGY COMPANY LIMITED 运营，并以持有泰国小额信贷牌照的 T OFFMONEY KAMPHAENGPHET CO., LTD. 名义提供服务。我们会给每条抽取出的记录打上持牌主体标记，让登记在册的放款方在下游任何系统中都可审计。

泰国 PDPA 是否允许第三方从 เงินเหลือในกระเป๋า 拉取借款人的借贷记录？

PDPA 自 2022 年 6 月起施行，参照 GDPR 制定，其运作核心是数据主体针对特定目的给出的同意。任何拉取的可靠依据都是借款人本人的授权，并以明确的范围和撤销路径予以采集与留痕。我们会在接入阶段与您一起把这套同意流程安排好。

获批的授信额度和宣传的 ฿10,000–฿30,000 区间是一回事吗？

不是。说明把 ฿10,000 到 ฿30,000 列为产品目录区间，并声明真实额度取决于平台的评估结果。我们把获批额度建模为独立字段，与宣传区间分开，让下游系统绝不会想当然地按上限处理。

一次对接需要一到两周。你可以选择源代码交付，300 美元起，我们交付、你满意之后再付款，OpenAPI 规范、可运行的 Python 与 Node.js 源代码、测试与文档都会落到你的代码库；也可以选按调用计费的托管 API，无预付费用，你调用我们的接口，只为调用付费。把需求告诉我们，我们来做范围界定——从这里开始沟通。