接入一个 TrueMoney Wallet 账户：余额、历史记录与 Pay Next 贷款台账

据独立电子钱包盘点报告引用的数据，约有 1700 万个泰国账户通过 TrueMoney Wallet 流转资金，同一批报道还将其在本地钱包市场的份额估在约 53%。这些账户每一个都受 PIN 码与 OTP 保护，而在其背后正是第三方想要读取的那类状态：一笔当前余额、应用内大约展示三个月深度的交易记录、转账记录，以及——对许多用户而言——一个有自己账单日的循环或定期贷款账户。这个页面讲的就是如何在账户持有人授权下，以结构化、可重复的方式把这些账户级数据取出来，并把可运行的代码交到你手上。

这里可靠的立足点，是消费者本人对共享自己数据的同意，并针对一个真实在用的账户行使。接入路径由此推导：我们梳理应用已鉴权的流量，把它重建成一套你可以直接调用的干净接口。下面依次说明账户实际暴露了什么、有哪些接入路径、我们交付什么，以及泰国的制度如何影响设计。

一个 TrueMoney 账户暴露了什么

这些数据面来自 TrueMoney 自家的支持资料与商店介绍，凡是可核对之处，均按应用自身的命名方式称呼。

接入账户的路径

有三条路径适合这款应用。它们并不等价，推荐意见放在最后。

对应用会话做授权协议分析

我们在一个同意授权的账户上，观察 TrueMoney 应用与其后端之间的流量，还原余额、历史与贷款读取的请求与响应结构，并把它们重建为有文档的接口端点。覆盖面很广：只要应用本身能展示的，重建后的接口就能返回。工作量适中，且集中在前期梳理鉴权握手上。耐用性取决于应用的发版节奏，这一点我们已纳入后续维护考量。

用户授权下的凭据访问

当账户持有人直接授权时，我们代其驱动已鉴权会话——PIN 与 OTP 由用户提供——通过受控流程读取同样的数据面。这适合单账户或低频场景，并让同意留痕保持清晰，每一次拉取都对应一条已记录的授权。

「Your Data」下的标准化数据共享

泰国央行的 Your Data 计划正在搭建一条基于同意的通道，覆盖存款、贷款及包含电子货币在内的支付数据，据 BOT 的公告分阶段自 2026 年底起共享。它今天还无法调用。我们把规范化结构设计成：当标准化通道触及钱包与电子货币数据时，对接可以平移过去，而你这一侧无需重建。

就当下的 TrueMoney 项目而言，在同意授权账户上做协议分析，是眼下就能取回真实数据、且覆盖上表每一个数据面的路径；当量小、且单个用户的授权就是全部任务时，授权凭据流程是合适之选；而 Your Data 通道则是我们让结构持续对齐的前进方向。我们会从协议分析起步，并在标准变得可及时把它并入。

你会收到什么

每一项都对应一个真实的 TrueMoney 数据面，而非泛泛的清单条目。

• 一份覆盖账户读取的 OpenAPI 3 规范——余额、分页交易记录、转账、贷款账户——将泰文字段标签与泰铢格式规范为干净的 JSON。
• 一份协议与鉴权流程报告，记录 PIN/OTP 会话握手、会话令牌有效期、设备绑定与刷新路径，均在实施过程中核实。
• 关键端点的可运行 Python 与 Node.js 源码，含翻越约 3 个月可见窗口、累积更长台账的分页逻辑。
• 一套按放款方拆分三款贷款产品的规范化结构，让 Pay Next、Pay Next Extra 与 KKP Cash Now 的摊还永不混淆。
• 针对录制夹具的自动化测试，加上接口文档，再加上与 PDPA 挂钩的数据留存与同意记录指引。

鉴权流程概览

下面示意在建立同意授权会话后，一次余额与历史读取的大致形态；确切字段名会在实施期间对照实时流量核实。

# illustrative — names verified during the engagement
session = tmn.open_session(
    msisdn="66xxxxxxxxx",      # Thai mobile, account identity
    pin=user_pin,              # supplied by the consenting holder
    otp=otp_from_sms,          # one-time, device-bound
)
# session yields a short-lived bearer token + device id

bal = session.get("/wallet/v?/balance")
# -> {"currency":"THB","available": ...,"asOf":"2026-06-24T..."}

# history pages ~3 months by default; we walk older pages
page = session.get("/wallet/v?/transactions",
                   params={"limit": 50, "cursor": None})
while page["cursor"]:
    for tx in page["items"]:
        normalize(tx)          # THB minor units, EN labels, PromptPay ref
    page = session.get("/wallet/v?/transactions",
                       params={"limit": 50, "cursor": page["cursor"]})

# loan accounts return per-product; do not merge servicers
loans = session.get("/lending/v?/accounts")
# -> [{"product":"PayNext","servicer":"AscendNano","apr": ...,
#      "nextDue":"...","installments":[...]}, ...]

# expired session -> 401; refresh once, then re-prompt OTP

同意与泰国的监管制度

有两层适用。PDPA（个人数据保护法 B.E. 2562）自 2022 年 6 月起全面生效，规定了同意与数据控制者规则；第 19 条要求在收集或使用个人数据前取得数据主体的同意，监管方已于 2025 年开出首批数额可观的罚单，宽限期的姿态已成过去。我们所构建的一切都会明确记录同意、把拉取的字段最小化到用例所需、记录每一次访问，并支持撤销。在此之上，泰国央行的 Your Data 项目正在建立一套面向存款、贷款及包含电子货币在内的支付数据的全国性、基于同意的共享标准——已公布并已进入法规，分阶段自 2026 年底起共享。我们把账户持有人的授权当作当下的工作基础，并让结构随时可切换到该通道；在项目需要时，我们会签署保密协议。

针对这款应用的实现要点

这些是我们在工作中处理的事项，不是需要你先解决的前提。

• History 页面只呈现约三个月。我们把同步安排成轮询加追加，让存储的台账超出应用屏幕上的窗口，并按交易 id 在多次拉取间去重。
• 三款借贷产品在结构上各不相同——Ascend Nano 的 Pay Next 系列是循环信贷，正如商店介绍所述，每月 15 日出账单、次月 1 日到期，而 KKP Cash Now 是 Kiatnakin Phatra 的定期贷款，最低期限更长。我们按产品分别建模账单周期与计息。
• 会话与 OTP、设备绑定。我们围绕令牌过期做设计并干净地重新弹出提示，而不是让同步悄无声息地失败；访问会在启动阶段与你一起、在同意授权账户上安排妥当。
• 字段标签与金额以泰文和泰铢习惯呈现。规范化器输出英文键与整数最小货币单位，让下游代码不受地区差异干扰，并将 PromptPay 参考号作为一等转账字段贯穿传递。

这类需求通常落在哪里

• 放贷机构或 BNPL 承销方拉取一位同意授权申请人的 TrueMoney 现金流与现有 Pay Next 敞口，用于还款能力评估。
• 个人理财应用把钱包消费与充值，连同银行账户一并纳入单一的泰国市场预算视图。
• 记账工具为小微商户把 7-Eleven 与 Lotus's 的商户付款与票据对账。
• 会员或积分平台读取转账与付款事件，无需手工录入即可发放积分。

界面佐证

上述数据面的商店截图；点按可放大。

资料来源

于 2026 年 6 月核对：History 与 Identity Level 数据面对照 TrueMoney 的支持页面，借贷条款与产品名对照其 Play Store 介绍，份额与用户数对照独立市场盘点报告，Your Data 计划与 PDPA 时间线对照泰国央行的资料。主要参考：

• TrueMoney 支持 — 交易记录
• 泰国央行 — 数据共享权法规（2025 年 11 月）
• 泰国央行 — 「Your Data」项目
• DLA Piper — 泰国 PDPA 概览

OpenBanking Studio 对接团队 — 梳理审阅于 2026-07-11。

同一数据版图中的同类钱包

对接 TrueMoney 的开发者通常还想把邻近的泰国钱包与银行应用纳入同一套结构。此处列出仅为生态背景，非排名。

• Rabbit LINE Pay — LINE 内置钱包；转账、储值与积分绑定聊天身份。
• K PLUS — Kasikorn Bank 的应用；面向庞大泰国用户群的银行余额、账单与 QR 付款。
• GrabPay — Grab 应用内的钱包；打车、外卖与商户消费，可绑卡。
• ShopeePay — 电商钱包；与订单关联的支付与退款。
• Dolfin Wallet — Central 集团钱包；零售消费、积分与储值。
• Paotang — Krungthai 承接国家项目的应用；钱包余额与政府补贴支付记录。
• Krungthai NEXT — Krungthai 手机银行；账户余额、转账与账单。
• DeepPocket — 泰国电子货币钱包；余额、充值与转账。

接入方常问的问题

TrueMoney 的交易记录到底能回溯多久，能不能留存更久？

根据 TrueMoney 自家的支持文档，应用内的 History 页面大约只展示最近三个月的交易。我们把同步设计成按计划轮询并不断累积超出可见窗口的记录，让你的数据库保留一份比应用屏幕上更长的台账。

这三款借贷产品在数据里能区分开吗？

可以。Pay Next 和 Pay Next Extra 由 Ascend Nano 运营，而 KKP Cash Now 是 Kiatnakin Phatra Bank 的定期贷款，正如应用商店介绍所述，每款产品各有自己的账单日、计息方式与分期计划。我们把它们建模为独立的产品类型，因此不同放款方的余额、到期日与摊还永远不会混在一起。

TrueMoney 对接受哪套泰国数据共享制度约束？

有两层。PDPA（B.E. 2562）自 2022 年 6 月起生效，规定了当下的同意义务与数据控制者责任。泰国央行的 Your Data 项目则为存款、贷款及包含电子货币在内的支付数据增加了一套基于同意的共享标准，分阶段自 2026 年底起推行。我们当下以账户持有人本人的授权为基础展开，并让设计保持随时可切换到标准化通道的状态。

读取钱包数据时，PromptPay QR 这一侧重要吗？

PromptPay 是 TrueMoney 用于 QR 收款与转账所依托的泰国央行银行间通道，因此转账记录会带有值得规范化的 PromptPay 参考号。它是一套支付方案，本身并非数据源；我们读取的是账户台账，而 PromptPay 标识会成为规范化转账结构中的字段。

最后说一点关于落地的实操。你把应用名称和想要取出的内容告诉我们；我们与你一起安排访问与合规基础，并完成梳理。源码交付 300 美元起——你会拿到可运行的端点、规范、测试与文档，验收在你这边跑通之后再付款。不想自己托管？那就改用按调用计费的托管 API：调用我们的端点，只为发生的调用付费，无需预付。两种方式的周期都是一到两周。把你想要的数据面告诉我们，我们来做范围评估——在此开始一个 TrueMoney 对接。