一个 ไทยแนนซ์ 贷款账户，如何变成你能调用的 API

ไทยแนนซ์ 里每一笔批准的贷款都带着一份三到六期的递减余额还款计划，而这份计划——各期到期日、本金与利息的拆分、逐期变化的余额——正是大多数团队来这里想要的数据。这款 App 是持牌的府级 PICO 小额贷款机构；其运营方称放款金额为 3,000 至 50,000 泰铢，期限 91 至 180 天，利息按未偿本金逐日计提。这些数据都不存在手机本地，而是放在放贷方的服务器上，藏在一层 OTP 登录之后；我们的工作，就是在借款人授权下把它读出来，交回一套后端能直接查询的接口。

核心结论：真正有价值的面是那本实时摊还台账，而可靠地触及它的依据是账户持有人本人的同意——而非任何厂商层面的安排。我们会优先构建的方案是直接读取一个同意授权的账户；当你需要一份控制方能背书的记录时，再在旁边补上一次 PDPA 数据申请。

借款人登录后暴露的账户数据

以下是 ไทยแนนซ์ 向已登录借款人呈现的各个数据面，并对应说明集成方对每一项会做什么。字段名沿用 App 及其商店说明的叫法。

触及数据的授权方式

真正适用于这款 App 的路径有三条。每一条都在借款人授权下进行；访问权限和任何测试账户都在启动阶段与你一起搭好。

1 · 经同意的接口对接

我们针对一个同意授权的账户研究 App 自身的流量，重建登录、贷款概要、还款计划与结清背后的调用。可触及：完整的实时台账，包括按日计提的余额。工作量中等；耐用性取决于 App 版本更新，我们通过一项布局变化检查来应对（见工程要点）。这是我们会优先构建的一条，因为动态的结清数字只存在于服务端。

2 · PDPA 数据可携权申请

泰国的《个人数据保护法》赋予借款人访问权和可携权，因此他们可以向 QR Technologies 索取关于自己的个人数据。耐用性很高——这是法定权利——但格式和处理时长由控制方决定，返回的是某一时点的快照。我们会把拿回来的内容规整成标准格式，用在你需要一份控制方背书记录的地方。

3 · App 内合同抓取

合同与还款计划在 App 内呈现，是借款人眼中的事实依据。我们可以把这一渲染出来的界面解析出来，作为对前两条路径的核验路径，尤其适合在你想确认借款人看到的确切数字时使用。

最终进入你代码库的东西

所有交付物都紧扣上文那些数据面，而非套用通用模板：

• 一份 OpenAPI 3.1 规范，覆盖经同意的各端点——登录/OTP、贷款概要、分期还款计划、结清报价。
• 一份认证流程报告，如实记录构建过程中观察到的 OTP、令牌与刷新链路。
• Python 与 Node.js 的可运行客户端，用于贷款概要、还款计划与结清。
• 一套针对递减余额分期模型的规范化 JSON schema，让 ไทยแนนซ์ 的记录能与其他放贷机构对齐。
• 一套 pytest 测试，其断言把某份合同的每期本金与利息精确复现到萨当（satang）。
• 接口文档，外加符合 PDPA 的数据留存与数据最小化建议。

一次经同意的读取，用代码表示

仅作示意——端点路径与字段名会在构建期间对照实际 App 确认，此处不作为固定契约发布。

import requests

S = "https://api.thainance.example/v1"   # base resolved during protocol analysis

def session(token):
    return {"Authorization": f"Bearer {token}", "Accept": "application/json"}

# token comes from the OTP login flow documented in the auth-flow report
loan = requests.get(f"{S}/loans/current", headers=session(tok)).json()

# declining-balance payoff = principal + interest accrued since last cut
principal = loan["outstanding_principal"]        # THB
annual    = loan["interest_rate_annual"]          # e.g. 0.1825, pinned at build
days      = loan["days_since_last_payment"]
accrued   = round(principal * annual / 365 * days, 2)
payoff    = round(principal + accrued, 2)

for inst in loan["schedule"]:
    print(inst["due_date"],
          inst["principal_component"],
          inst["interest_component"],
          inst["remaining_principal"])

if loan.get("error") == "OTP_SESSION_EXPIRED":
    raise SystemExit("re-auth via OTP; tokens are short-lived")

PDPA、PICO 监管与同意范围

泰国的《个人数据保护法》自 2022 年 6 月起施行，赋予数据主体访问权、可携权和删除权——这份法定同意正是整个对接所依托的基础。放贷一侧由财政部通过其财政政策办公室监管；PICO 小额贷款制度将实际年利率上限设为 36%，与 App 商店说明标注的 10–35.8% 区间相符。我们按每个借款人一份明确的同意范围来开展工作，尊重撤回同意（撤回时即销毁已存令牌），只保留某个用例所需的字段，对每次访问都留下日志，并在项目需要时签署保密协议。作为泰国更广阔开放数据方向的背景，泰国银行（Bank of Thailand）的 dStatement 服务已经能在客户同意下于各机构间流转机器可读的对账单数据；而 ไทยแนนซ์ 是不在该机制内的非银行 PICO 放贷机构，这也正是这里需要以同意为基础的接口对接来承担工作的原因。

我们会预先规划的工程细节

这款 App 会带来一些具体约束，全部由我们这边处理：

• 按日递减余额计息。App 说明利息的算法是：剩余本金 × 年利率 ÷ 365 × 该期天数。其商店说明同时给出了每日示例数字和 18.25% 的年利率基准，因此我们会对照实际合同锁定观察到的确切利率基准并在测试中断言——这正是让结清金额精确复现到萨当的关键。
• OTP 会话生命周期。所有内容都藏在短信 OTP 登录与短时效令牌之后。我们围绕刷新窗口设计同步流程，让它不会在运行中途悄然失效；并在启动阶段与你一起安排一个同意授权或测试账户供构建使用。
• 提前结清后的重新摊还。据 App 说明，超额还款会立即冲减本金并降低下一期利息。我们负责处理这一重算，使部分提前还款不会让已存的还款计划失步。
• 前端漂移。合同页是还款计划的事实来源。我们在维护中加入一项布局变化检查，使被改版的界面会以一个失败的测试暴露出来，而不是悄悄产出错误数据。

团队把它用在哪里

• 一个债务总览面板，把用户的 ไทยแนนซ์ 余额与其他消费贷款并排展示。
• 一个在每期到期日触发的提醒或催收服务。
• 一套记账同步，每期把本金与利息拆分过入台账。
• 一次负担能力或再融资核查，在报价替换贷款前先读取实时结清金额。

与我们合作，以及费用

一个可用的 ไทยแนนซ์ 贷款数据客户端——附带能复现合同摊还的测试——会在一到两周内交付。你可以把它当作源码来接收：可运行代码、OpenAPI 规范、认证流程报告和文档，交付进你的代码库，只有当它到你手上、你满意之后，才从 300 美元起付费。或者完全跳过自托管，直接调用我们维护的端点，按调用计费、无需预付。无论哪种方式，你只需给我们两样东西——App 名称和你想从它的数据里得到什么——访问权限和合规事项会作为项目的一部分与你一起安排。从 /contact.html 开始。

我们对照的界面

追踪 App 各数据面时使用的商店截图。点击可放大。

这份简报是如何整理出来的

于 2026 年 6 月对照 App 的商店页面及其说明中的披露（运营方、牌照号、贷款条款、按日递减余额的计息方式）逐项核对，并结合泰国在 PICO 放贷与个人数据方面的监管情况。查阅的主要来源： 泰国银行——dStatement / 开放数据、 ไทยแนนซ์ 在 Google Play、 PICO 小额贷款牌照框架（MOF/FPO），以及 National Credit Bureau。

由 OpenBanking Studio 集成团队梳理——2026 年 6 月。

处于同一数据版图中的其他泰国借贷 App

同一类别，列出以扩大关键词覆盖——每一款都保存着可与 ไทยแนนซ์ 一并读取的用户信贷数据，统一对接即可实现。这是背景参考，并非排名。

• LINE BK——在 LINE 内提供循环零用信贷额度的社交银行 App。
• MoneyThunder——Abacus Digital 出品、以 AI 评分的纳米金融放贷，面向征信薄弱的借款人。
• FINNIX——数字纳米金融贷款，App 内含还款计划与余额。
• KTC Mobile——Krungthai Card 用于信用卡与个人贷款账户的 App。
• KMA Krungsri——Krungsri 的移动 App，提供个人与即时现金贷款。
• Ngern Tid Lor (TIDLOR)——以产权与车辆登记为担保的贷款，附还款跟踪。
• Heng——Heng Leasing 面向外府借款人的纳米与产权贷款 App。
• SCB EASY——Siam Commercial Bank 的零售 App，含放贷功能。
• Krungthai NEXT——Krungthai Bank 的日常银行与贷款 App。

集成方常问的关于 ไทยแนนซ์ 的问题

ไทยแนนซ์ 会把还款记录报送征信机构吗？那份数据能拉取吗？

泰国的 PICO 放贷机构受财政部监管，其中不少是 National Credit Bureau 的会员，因此借款人的还款记录除了存在 App 内，也可能保存在 NCB。征信档案是另一个需单独取得同意的来源；我们构建的对接是从借款人自己的 ไทยแนนซ์ 账户读取贷款、还款计划和余额，如果你需要征信数据，会作为单独一项来规划拉取。

这笔贷款按日在递减余额上计息——客户端能精确复现结清金额吗？

可以。我们把利息建模为剩余本金乘以年利率除以 365，再乘以该期天数，这正是 App 自己说明的算法。pytest 测试套件会对照一份合同校验每期本金与利息的拆分，使结清金额精确到萨当（satang）。

通过 PDPA 数据可携权申请来取得贷款记录，是现实可行的做法吗？

有可能可行。泰国的 PDPA 赋予数据主体访问权和可携权，因此借款人可以向 QR Technologies 索取关于自己的个人数据。那返回的是控制方背书的某一时点快照，而非实时余额，所以当产品需要动态数字时，我们通常会搭配一次经同意的接口读取。

我们只想先对接少数几个借款人账户——这样可行吗？

可行。整个构建是针对一个同意授权的账户，或与你一起安排的测试账户来运行的，所以小规模试点是常见的起步形态，同一套客户端之后无需返工即可扩展到更多账户。