读取 ShopeePay 钱包里的账户记录

一个 ShopeePay 账户里装着泰铢钱包余额、一份持续记录的扫码付款流水，以及一本 SPayLater 分期账本——这正是财务或产品团队想要读取、对账，或同步进自家系统的那些记录。ShopeePay 由 Sea Ltd 数字金融板块 SeaMoney 运营，你今天看到的这款钱包最早叫 AirPay，直到 2021 年才更名；Play 商店的列表里至今仍带着老的包名 com.beeasy.airpay，在梳理它的流量时这是个很有用的线索。这一页要解决的事很聚焦：在账户持有人授权之下，把账户数据以干净的结构取出来。

泰国刚为这类数据的共享写好了规则，但对电子货币钱包而言，受监管的那条管道还停在计划里、尚未真正上线。这决定了我们的路线选择。眼下可靠的依据是用户本人的同意——被采集并留痕，同时系统在结构上做好准备，一旦泰国央行的电子货币阶段开放，就能立刻切换到那条通道上。

账户里存了什么

这款应用把大量日常消费都收进了一个钱包里，所以能读取的数据面比单纯查一下余额要宽得多。下面这些，是为 ShopeePay 数据通道建模时值得考虑的。

泰国的数据共享规则把电子货币钱包留在了什么位置

泰国央行于 2025 年 10 月 30 日出台了它的 Open Data 法规，作为“Your Data”项目的一部分，其中明确点名了存款、贷款和支付信息，包括 e-Money 和信用卡（见 BOT 新闻稿）。对钱包来说，卡点在于时间表。各机构须在 2026 年底前实现数据共享，从个人存款账户数据起步，随后在 2027 和 2028 年逐步扩展到其他类别。支付与电子货币数据落在那个较晚的扩展档里，不在第一波。所以就最终定稿而言，这套制度涵盖了 ShopeePay 这一类数据——只是它还不是钱包数据通道今天就能调用的渠道。

这就使得账户持有人的同意成为当下可行的法律与技术依据，其数据处理受泰国 PDPA 约束。我们把受监管渠道视为事情的走向，现在就让同意凭证和字段映射与之保持兼容，这样等电子货币阶段落地时，数据通道不必推倒重来。据报道，SeaMoney 是首家拿到 BOT 数字个人贷款牌照的公司，这也是 SPayLater 数据之所以是这种结构的部分原因。

我们真正会走的 ShopeePay 数据接入路线

基于授权的接口集成（对应用自身流量做协议分析）

我们针对一个已授权的账户，抓取应用发出的已鉴权调用，记录请求与响应的结构，再把这些读取重建成一条干净的数据通道。可触及范围：账户能看到的一切——余额、交易历史、SPayLater 分期、奖励。工作量中等；可维持性跟着应用的发版节奏走，所以客户端一变，字段映射就得重新校验一次。访问权限在启动阶段与你一起开通，对着一个已授权账户或一个测试账号进行。

泰国央行 Open Data 授权（面向未来）

一旦“Your Data”框架的电子货币阶段上线，同样这批数据就会走一条受监管、以同意为准入的渠道，三条路线里它的可维持性最强。我们现在就把同意记录的处理搭好，这样将来采用那条渠道只是切换开关，而不是重写。

应用内活动导出

在应用提供对账单或活动导出的地方，那份文件可以作为历史记录的低成本兜底——适合补录，但用于实时同步就偏弱，因为它是某个时间点的快照。

对一个本季度就需要数据的团队，我们会优先构建基于授权的接口路线，因为它今天就能触及完整账户，将来还能直接嵌进受监管渠道；导出方案只有在你需要把历史数据快速灌进来时才值得接上。

一次读取的草图

下面的结构仅作示意，会在构建过程中对着线上客户端逐一确认。ShopeePay 使用与设备绑定的会话，携带一个在过期时刷新的 bearer 令牌，金额以萨当（satang，泰铢的最小单位）传回。

# Auth: device-bound session, bearer token refreshed on expiry.

POST /v1/auth/token/refresh
  headers: { x-device-id, x-app-ver }
  body:    { refresh_token }
  -> 200 { access_token, expires_in: 3600 }
     401 { code: "SESSION_REBIND" }     # device must re-bind

GET /v1/wallet/balance
  headers: { authorization: "Bearer " }
  -> 200 { currency: "THB", available: 184250, unit: "satang" }   # = 1,842.50 THB

GET /v1/spaylater/plans?status=active
  -> 200 { credit_limit, plans: [
       { id, principal, tenor_months: 6, rate_apr: 0, next_due, outstanding } ] }

# on 401 SESSION_REBIND -> re-run refresh once, then retry the read;
# persist the cursor so a dropped sync resumes, not restarts.
      

交付到你仓库里的东西

每次合作交付的都是能跑的代码，而不是一份幻灯片。对 ShopeePay 来说，这意味着：

• 一份覆盖我们所构建读取的 OpenAPI 规范——余额、交易历史、SPayLater 分期、奖励——并把萨当到泰铢的换算处理写进去。
• 一份协议与鉴权流程报告，覆盖设备绑定会话、令牌刷新链路，以及 SESSION_REBIND 这条分支。
• 关键端点的可运行源代码，Python 或 Node.js 版本，带基于游标的续传逻辑。
• 针对录制好的固定用例（fixtures）的自动化测试，这样一旦发版导致结构变化，就会明确报错。
• 接口文档，外加符合 PDPA 的同意采集与数据留存说明。

做 ShopeePay 构建时我们会提前规划的点

关于这款钱包，有几件事会影响到具体工作，我们把每一项都自己消化掉，而不是当作条件甩给你。

• 泰国本地绑定。ShopeePay 于 2025 年 1 月起停止接受外国用户（据 2026 年一份金融科技综述）；账户与泰国手机号和身份绑定。我们用一个已授权的泰国本地账户，或在启动阶段与你一起准备的测试账号来开展构建。
• SPayLater 的分期算法。分期计划在促销时为 0%，或按最长 12 个月的分期进行，逾期利息应用标注为年化 15–25%。我们把期限、还款计划和利率精确建模，让同步出来的还款账本与应用自身的显示一致，并把促销计划和标准计划区分开来。
• 设备绑定会话。读取依附于一个与设备绑定的会话，所以我们围绕刷新节奏来设计同步，并在每次应用发版后重新校验抓取到的流程，让中断的同步能从上一个游标处续跑。

团队会把它接在哪里

• 一家商户在日结时，把 ShopeePay 扫码结算与 POS 收款进行对账。
• 一家放贷机构在获得同意后，把客户的 SPayLater 未结余额和分期期限拉出来，用于还款能力视图。
• 一款个人理财或记账应用，把钱包账本和账单缴费记录导入一份统一的对账单里。
• 一个积分平台，把 Shopee Coins 的发放与核销同步进来，与活动投入做对照。

我们梳理过的界面

下面是商店里公开的截图，用来锚定数据面梳理。点击可放大。

我们核查了什么，以及在什么时候

这份梳理依据的是应用自身的商店列表与介绍、泰国央行公开发布的 Open Data 法规和 Open Data 项目页面，以及一份 2026 年金融科技市场综述（用于确认运营方、市场份额和外国用户政策变动）。由 OpenBanking Studio 集成团队于 2026 年 6 月复核。主要来源：

• 泰国央行 — Open Data 法规生效（2025 年 10 月 30 日）
• 泰国央行 — Open Data /“Your Data”项目
• Fintech News — 泰国主流电子钱包盘点
• ShopeePay — App Store 列表

泰国钱包全景，服务于一条统一数据通道

团队很少只对接一个钱包，所以这里列出 ShopeePay 数据通道所处的“邻里”。这些名字只作背景参考，并非排名。

• TrueMoney Wallet — Ascend Money 旗下钱包，泰国受理范围最广；承载余额、转账和一份密集的 7-Eleven 付款历史。
• Rabbit LINE Pay — 内嵌在 LINE 里，把付款与 BTS 空铁出行和 LINE Points 积分绑在一起。
• GrabPay — Grab 打车、外卖与配送流程背后的钱包，带有丰富的逐单记录。
• K PLUS — 开泰银行（Kasikornbank）的应用，泰国银行类应用覆盖面最大；完整的存款和转账数据。
• Pao Tang — 泰京银行（Krungthai）的政务服务钱包，承载国家补贴计划与福利发放记录。
• SCB Easy — 泰国汇商银行（Siam Commercial Bank）的手机银行，带账户、卡片和缴费历史。
• Dolfin Wallet — Central 集团旗下钱包，把零售消费与支付记录融合在一起。
• Bualuang mBanking — 盘谷银行（Bangkok Bank）的应用，存款账户与转账走一条基于授权的渠道。

对接方常问的 ShopeePay 问题

能不能把 SPayLater 的分期计划拉出来，还是只能拿到钱包余额？

两者都能。SPayLater 板块里带着授信额度、分期期限和还款计划，和钱包余额并列，所以我们把它们映射成彼此独立的规范化对象，而不是揉成一团。

泰国新出的 Open Data 规则，现在能让我们通过受监管渠道申请 ShopeePay 数据吗？

钱包类暂时还不行。泰国央行的 Open Data 法规于 2025 年 10 月 30 日生效，点名了 e-Money，但支付与电子货币这一档落在 2027 至 2028 年的扩展阶段；首个阶段（2026 年底前）针对的是个人存款数据。眼下可靠的依据仍是账户持有人本人的授权同意，我们把系统搭成一旦该阶段开放、数据通道就能切到受监管渠道上。

ShopeePay 已经不再接受外国用户了——这会不会挡住对接？

不会。账户绑定的是泰国手机号和身份，所以我们用一个已授权的泰国本地账户，或者在启动阶段与你一起准备的测试账号来跑构建。这种绑定改变的是我们如何开通访问，而不是数据能否被读取到。

ShopeePay 应用更新后，读取还能继续正常工作吗？

客户端前端会随版本发布变动。我们对着线上应用抓取协议，把字段映射做版本化管理，每次发版后重新校验一遍，让同步始终与用户在应用里看到的内容对得上。

启动一次构建

一条 ShopeePay 数据通道从头到尾跑一到两周。你可以把它作为归你所有的源代码拿走——可运行端点、鉴权流程报告、自动化测试和接口文档，300 美元起，且只在交付、跑通、你满意之后才计费——或者干脆跳过构建，直接调用我们托管的端点，按调用次数付费、无需预付。告诉我们应用名称，以及你需要从钱包里拿到什么，我们就来做范围评估：启动一次 ShopeePay 对接。