对接 Krungthai NEXT：账户与卡片数据

2025 年 10 月 30 日，泰国央行（Bank of Thailand）颁布了一项规则，允许客户把自己的金融数据从一家机构迁移到另一家，这就是监管机构所称的 Your Data 项目。Krungthai Bank（KTB）的零售应用 Krungthai NEXT 完全在其覆盖范围之内。这个登录背后，是存款余额、完整的转账与账单支付台账、个人贷款账户、Krungthai 旅行卡的多币种外汇余额、保险保单，以及 KTC 卡的使用记录。本简报梳理哪些数据可以触达、通往每个数据域的授权路径，以及工作完成后我们会交付什么。

结论很短。最丰富的数据是逐用户的银行记录，而今天触达它的可靠方式，是针对持有人已授权的账户，对应用自身流量做授权协议分析。随着 BOT 的通道陆续开放——存款账户在 2026 年底率先上线——我们会把每个数据域切换到受监管的授权路径。我们把这套构建设计成：那次切换只是一处配置变更，而非重写。

这些是应用向自己用户呈现的界面。每一项都对应一条服务端记录，第三方会想读取或同步它。

数据域	在应用里出现的位置	颗粒度	集成方拿它做什么
存款与 NEXT 储蓄余额	账户首页，NEXT 储蓄开户/销户	逐账户余额与产品类型，THB	现金头寸同步、对账、储蓄看板
交易流水	转账、充值、账单支付、取现记录	逐笔：时间戳、对手方、金额、渠道	记账、分类、流水导出
预约交易	预约功能，最远可提前 24 个月	带执行日期的未来指令	现金流预测、资金视图
个人贷款	贷款申请与贷款账户	额度、未偿余额、利率区间、分期方案	借贷看板、还款能力核查
KTC 卡	卡片使用、可用余额、积分	逐卡余额、消费、积分台账	卡片消费分析、积分对账
Krungthai 旅行卡	旅行卡、多币种钱包	逐币种余额、所用汇率	差旅报销、多币种对账
保险保单	购买保险、查询保单	保单清单与状态	保单聚合、续保跟踪

各条路径，以及我们会先用哪一条

真正适用于这款应用的路径有两到三条。下面说明每条能触达什么、稳定性如何。

BOT 规则下的授权数据共享

受监管的路径。一旦某个数据域的通道上线，客户授权后，数据便通过标准化的 BOT 通道流动，而不再经过应用。按 BOT 公告，存款账户信息在 2026 年底领跑，贷款和支付数据在 2027 与 2028 年间跟进。可触达范围以已公布的阶段为界；由于接口是受治理的、并非抓取而来，稳定性很高。第三方提供商的接入与授权采集，我们会作为合作的一部分与你一起完成。

对应用做授权协议分析

这是现在就能用的方式。我们针对一个已授权的账户，观察 Krungthai NEXT 客户端与其后端的通信，记录认证与设备绑定链路，并把余额、流水、贷款和卡片背后的调用重建成一套整洁的 API。它覆盖用户在应用里能看到的一切。当应用前端发生变化时，它需要一轮复核，这一步我们已纳入维护。

原生对账单导出

Krungthai 为旅行卡等产品提供对账单历史导出。凡是存在这类导出的地方，解析它是获取回溯记录的低成本补充，只是格式比实时接口更粗，且受限于银行选择打印的内容。

先用哪条路径取决于你的时间表。受监管通道在 2027 年前触达不到贷款或卡片数据，所以需要立刻拿到完整记录的团队，会先用针对已授权账户的协议分析，因为那条路径能触达用户所见的一切。之后我们在每个数据域对应阶段开放的当天，把它重新指向 BOT 通道；只有当你需要比实时接口返回更久远的历史时，才引入原生导出。规格文档写明了哪个界面走哪条路径，因此不存在含糊之处。

你会拿到什么

每一次合作都交付同一类产物集，与这款应用的界面一一对应：

一份 OpenAPI/Swagger 规格，描述每个建模端点——余额读取、流水查询、贷款账户、卡片与积分查询——并附请求与响应结构。
一份协议与认证流程报告，涵盖登录、令牌签发、刷新与设备绑定序列在 Krungthai NEXT 上的实际行为。
关键端点的可运行源代码，提供 Python 与 Node.js 版本，围绕会话过期做了重试与错误处理。
针对录制夹具的自动化测试，让字段变更在触及生产之前就被捕获。
接口文档：字段含义、THB 与多币种处理、KTC 与存款的区分、流水历史的分页。
合规与数据留存指引——授权记录、日志，以及一份与 PDPA 挂钩的数据最小化说明。

一次流水拉取的示意

仅作示意——确切的字段名称与令牌链路会在构建阶段针对已授权账户确认。它呈现的是形态：一个已认证的会话、一枚设备绑定的令牌，以及归一化到单一结构的分页流水响应。

POST /ktb/next/auth/session        # device-bound login, returns short-lived token
  body  { device_id, credential_proof }
  200   { access_token, refresh_token, expires_in: 900 }

GET  /ktb/next/accounts/{acct}/transactions?from=2026-01-01&cursor=
  hdr   Authorization: Bearer <access_token>
        X-Device-Binding: <device_id>
  200   {
          "account": "xxx-x-x4821-x",
          "currency": "THB",
          "balance": 18452.10,
          "page": { "next_cursor": "X1c9..." },
          "transactions": [
            { "ts": "2026-06-21T09:14:02+07:00",
              "type": "transfer_out", "channel": "promptpay",
              "counterparty": "K-PLUS 081xxx4417",
              "amount": -650.00, "running_balance": 18452.10 }
          ]
        }

# 401 -> refresh once via /auth/refresh, then re-issue; never replay a stale token
# normalize: map type|channel onto the unified ledger enum, keep THB minor units exact

团队用它做什么

一款记账工具，把某个 Krungthai NEXT 客户的转账和账单支付导入账簿，无需手工处理 CSV。
一家借贷或 BNPL 服务商，读取贷款账户与分期计划，让还款能力视图保持最新。
一款报销产品，把旅行卡外汇消费和 KTC 卡积分与存款台账一并对账。
一款个人理财应用，把某位泰国客户在多家银行的余额聚合为单一头寸。

泰国的数据共享规则，以及授权在实操中的样子

这里的主导规范，是泰国央行于 2025 年 10 月 30 日公布的数据共享法规，它赋予消费者和企业分享金融机构所持数据的权利——存款、贷款和支付信息，包括电子货币与信用卡。泰国的《个人数据保护法》（PDPA）为其奠定了隐私底线。这款应用上的授权是按数据域授予且可撤销的：客户授权一个明确的范围，访问被记录在案，我们只拉取用例所需的字段。凡是某个数据域的 BOT 通道尚未上线之处，同样的数据便在账户持有人的直接授权下流动，以相同方式采集并留存记录。我们的作业是经过授权、有据可查、遵循数据最小化的，并在客户需要时置于保密协议之下。

这次构建里我们会预先应对的点

有几个具体因素决定了我们如何界定一次 Krungthai NEXT 对接的范围：

KTC 卡数据来自 Krungthai Card——集团内一家独立的发卡机构，所以我们把卡片余额和积分建模成独立的对象图，而不是并入银行的存款结构——它们的标识符和刷新节奏都不一样。
注册使用人脸核验与设备绑定，所以我们围绕一台绑定设备和较短的令牌有效期来设计会话处理，并把刷新路径构建成：当令牌轮换时，同步不会悄无声息地中断。
预约交易功能最远可达 24 个月，这意味着流水模型必须把未来日期的指令与已结算的历史区分承载，否则预测视图会重复计数。
应用呈现的贷款数字——如页面所述的最高 1,000,000 THB 信用额度和 11–24% 的年利率区间——是展示值；对任何涉及金额的内容，我们读取权威的账户记录，而非营销文案。
我们为应用发版安排一轮复核，因为 Krungthai NEXT 更新频繁，某个迁移的字段应当浮现在我们的测试里，而不是你的数据里。

费用与我们的交付方式

源代码交付 300 美元起：你拿到可运行的 API 源代码、OpenAPI 规格、测试，以及你所需 Krungthai NEXT 界面的接口文档，并在交付后、构建达到你满意为止时再付款。另一种是托管 API——你调用我们的端点、按次计费，没有预付费用，自己也无需运维任何东西。无论哪种方式，周期都是一到两周，你只需给我们应用名称和你想从它数据里得到什么；访问权限和合规事宜由我们与你一起安排。告诉我们哪些界面重要，我们就来界定范围——点此开始沟通。

应用截图

来自 Krungthai NEXT 商店页面的参考截图——便于你指出想要映射的确切界面。点击可放大。

我们核对了什么，以及来源

我们查阅了 Krungthai NEXT 的商店页面以了解功能与产品集，查阅了泰国央行 2025 年 10 月的数据共享公告以确认监管路径及其阶段日期，还查阅了 Krungthai 自己的产品页面以获取对账单导出与旅行卡的细节。上文的日期和数字均归因于这些来源；凡是我们无法确认的，都作了标注而非断言。由 OpenBanking Studio 集成团队梳理，2026 年 6 月。

主要来源：泰国央行——数据共享法规 · Google Play 上的 Krungthai NEXT · Krungthai NEXT 产品页面

处于同一集成版图中的其他泰国银行 App

聚合泰国零售金融的团队，通常不止需要其中一款。此处列出仅供参照，并非排名：

K PLUS（Kasikornbank）——按用户数计泰国最大的银行应用；承载存款、转账和 QR 支付。
SCB EASY（Siam Commercial Bank）——账户、转账、卡片与投资界面。
Bualuang mBanking（Bangkok Bank）——存款账户、账单支付与转账记录。
TTB Touch（TMBThanachart）——账户、卡片与借贷集于一个应用。
Krungsri Mobile App，KMA（Bank of Ayudhya）——余额、转账与贷款账户。
Paotang——KTB 的钱包与政务服务平台，拥有自己的支付台账。
TrueMoney Wallet——一款非银行的电子货币钱包，含余额与交易流水。
MyMo by GSB（Government Savings Bank）——面向庞大零售客群的存款与储蓄记录。

把这其中几款的余额和流水归一化到单一集成，是常见的需求；真正各不相同的，是每款应用的接口对接工作。

集成方关于 Krungthai NEXT 常问的问题

KTC 卡数据能否与银行存款账户分开拉取？

可以。Krungthai NEXT 里的 KTC 卡余额、消费和积分界面来自 Krungthai Card——集团内一家独立的发卡机构，因此我们把它们建模成拥有各自标识符的独立对象图，而不是并入存款账户的数据结构。这样卡片消费分析和积分台账就能与银行流水数据干净地区分开。

泰国央行的 Your Data 规则是否已经覆盖我需要的交易流水？

还没有全部覆盖。按照 BOT 2025 年 10 月 30 日的公告，授权数据共享通道分阶段开放：个人存款账户信息在 2026 年底先行，随后是 2027 至 2028 年间的贷款和支付数据。我们今天通过一个已授权的账户拉取存款与流水数据，并在各个数据域对应的阶段上线时把它切换到受监管的授权通道。

当 Krungthai NEXT 发布应用更新时，是什么让对接持续可用？

这款应用更新频繁，所以我们对采集到的请求和响应结构做版本管理，锁定令牌与设备绑定链路，并运行一轮复核，在字段变更或端点迁移触及你的数据之前就把它标记出来。当某个界面发生变化时，我们修补映射；这项维护是我们交付方式的一部分，而非事后补丁。

能否在 2026 年底存款数据阶段上线之前就开始？

可以。协议分析路径现在就能针对一个已授权账户运行，不必等待监管落地。把应用名称和你想从它数据里得到什么告诉我们；访问权限与合规文书会在对接启动阶段与你一起安排妥当。

应用简介——Krungthai NEXT

Krungthai NEXT（包名 ktbcs.netbank）是 Krungthai Bank PCL 的零售手机银行应用——这是一家总部位于曼谷的泰国大型商业银行，应用在 Android 与 iOS 上提供。如商店页面所述，该应用处理转账、充值、账单支付、取现和贷款申请，支持最远 24 个月的预约，开立 NEXT 高息储蓄账户，通过 Krungthai 旅行卡进行多币种外汇消费，销售并跟踪保险保单，提供最高 1,000,000 THB 信用额度、年利率区间 11–24% 的个人贷款，并跟踪 KTC 卡的使用、余额与积分。注册使用人脸核验。客服中心列为 02-111-1111；网站 www.krungthai.com。商标归各自所有者所有；此处数字依据公开页面，未经独立审计。

Krungthai NEXT 登录背后有什么