Splitwise 共享支出、余额与点对点支付 API

Splitwise, Inc. · 支付

Splitwise 是 Splitwise, Inc. 推出的共享支出记账应用，面向室友、情侣、旅行团和社团，帮助大家把共同账单理清楚，随时看到谁欠谁。成员创建群组、记录谁付了款，可按均分、精确金额、百分比或份额拆分费用，并在结清余额前附上收据、备注和评论。定期支出覆盖房租和水电账单；Splitwise Pro 另提供逐项收据扫描、支出图表、货币换算和支出搜索。银行卡和银行账户连接可把交易带入拆账流程；符合条件的美国用户还能使用 Splitwise Pay 付款请求和 Splitwise 钱包。

已付与应付份额赋予共享支出账本成员级的细节：paid_share 与 owed_share 同 cost、currency_code、group_id 和 split_method 并列。支出记录保留描述、日期、类别和创建者，conflictDetected 标记冲突的编辑。详情记录另有 receipt_path、comments_count、transaction_method、transaction_status、repeat_interval 和 next_repeat_timestamp，让家庭记账能把收据、定期账单和付款状态绑定在同一笔支出上。

群组债务图把 members 同 original_debts、simplified_debts 和 repayments 连接起来；单笔债务保留 from、to、amount 与 currency_code。借助这些记录，旅行规划工具可以把未结债务同结算方案和已记录的还款进行比较。通知字段 source_type、source_id 与 app_link 把动态关联到相应的群组或支出，货币记录则提供 code 与 unit，让金额标注保持一致。

付款请求增加 requestedAmount、currencyCode、status、expiresAt 和 warning，用于跟踪未付或已过期的请求。导入的交易把 transactionId 同 rawName、amount 和 unsplittableAlert 配对，为对账工具提供匹配键和异常信号；批量分配结果区分 processed 与 failed 条目。钱包对账单保留 month、opening_balance 和 closing_balance，资金来源则另有 availableBalance 与 pendingBalance。面向记账工具、团体旅行规划和支付监控看板，openData Studio 把这些共享支出数据做成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

会话登录
POST /v1/shared-costs/sessions openbanking
开启已鉴权的会话。sequence 报告登录进行到哪一步，challenge_options 列出仍需完成的二次验证步骤；auth 返回账户身份与会话令牌；data_s2 写入当前用户；app_tour 携带新手引导状态，使新设备可直接进入账本。
认证方式：登录本身无需已有会话；账户凭据换取基于 Cookie 的会话。后续调用靠会话 Cookie 鉴权，而非 Bearer 令牌。
- sequence
- challenge_options
- auth
- data_s2
- app_tour
```
POST /v1/shared-costs/sessions HTTP/1.1
Accept: application/json
Content-Type: application/json
X-Client-Time-Zone: America/New_York

{
  "email": "[email protected]",
  "password": "<example-password>"
}
```
```
{
  "sequence": "authenticated",
  "challenge_options": [],
  "auth": {
    "user_id": 101,
    "session_token": "<example-session-token>"
  },
  "data_s2": {
    "current_user_id": 101
  },
  "app_tour": {
    "seen": true
  }
}
```

账户初始化数据包

GET /v1/shared-costs/snapshots openfinance

一次性返回完整的已登录状态：调用者的 current_user_id，以及已同步的全部支出、群组、好友、通知、货币和类别。客户端冷启动时用它填充本地存储，下游界面读取的是同一份成员关系图，而不必拼接多个列表调用。

认证方式：会话 Cookie；Accept: application/json。

current_user_id
expenses
groups
friends
notifications
currencies
categories

GET /v1/shared-costs/snapshots HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>

{
  "current_user_id": 101,
  "expenses": [
    {
      "id": 501,
      "description": "Groceries",
      "cost": "86.40",
      "currency_code": "USD",
      "date": "2026-10-18",
      "group_id": 301
    }
  ],
  "groups": [
    {
      "id": 301,
      "name": "Shared household",
      "group_type": "household"
    }
  ],
  "friends": [
    {
      "id": 202,
      "first_name": "Sam",
      "currency_code": "USD"
    }
  ],
  "notifications": [],
  "currencies": [
    {
      "id": 1,
      "code": "USD",
      "unit": "$"
    }
  ],
  "categories": [
    {
      "id": 15,
      "name": "Groceries"
    }
  ]
}

带过滤条件的支出列表

GET /v1/shared-costs/entries openfinance

分页返回账本行，可按 group_id、friend_id 或 updated_after 水位线过滤。每行包含 cost 与 currency_code、date 与 payment 标志、类别和创建者，以及 comments_count，同步任务因此只需拉取自上次游标以来发生变化的内容。

认证方式：会话 Cookie。

id
description
cost
currency_code
date
payment
group_id
category
created_by
comments_count

GET /v1/shared-costs/entries?group_id=301&friend_id=202&updated_after=2026-10-01T00:00:00Z HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>

{
  "expenses": [
    {
      "id": 501,
      "description": "Groceries",
      "cost": "86.40",
      "currency_code": "USD",
      "date": "2026-10-18",
      "payment": false,
      "group_id": 301,
      "category": {
        "id": 15,
        "name": "Groceries"
      },
      "created_by": {
        "id": 101,
        "first_name": "Alex"
      },
      "comments_count": 1
    }
  ]
}

创建或更新支出

POST /v1/shared-costs/entries/save openfinance

写入一条账本记录。split_method 记录账单的拆分方式（均分、按份额、按百分比或精确金额），每个 users 条目给出该成员的 paid_share 与 owed_share；creation_method 注明由哪个客户端创建。响应中的 conflictDetected 标示该次编辑与较新的服务端版本发生了冲突。

认证方式：会话 Cookie；表单编码的请求体。

cost
description
group_id
currency_code
date
split_method
category_id
creation_method
payment
users
user_id
paid_share
owed_share
conflictDetected

POST /v1/shared-costs/entries/save HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
Content-Type: application/x-www-form-urlencoded

cost=86.40&description=Groceries&group_id=301&currency_code=USD&date=2026-10-18&split_method=evenly&category_id=15&creation_method=android&payment=false&users[0][user_id]=101&users[0][paid_share]=86.40&users[0][owed_share]=43.20&users[1][user_id]=202&users[1][paid_share]=0.00&users[1][owed_share]=43.20

{
  "expenses": [
    {
      "id": 501,
      "cost": "86.40",
      "description": "Groceries",
      "group_id": 301,
      "currency_code": "USD",
      "date": "2026-10-18",
      "split_method": "evenly",
      "category_id": 15,
      "creation_method": "android",
      "payment": false,
      "users": [
        {
          "user_id": 101,
          "paid_share": "86.40",
          "owed_share": "43.20"
        },
        {
          "user_id": 202,
          "paid_share": "0.00",
          "owed_share": "43.20"
        }
      ]
    }
  ],
  "conflictDetected": false
}

含付款环节的支出详情
GET /v1/shared-costs/entries/{entry_id}/details openfinance
把一条记录展开为三个块：expense 为账单本身，payment_details 为资金环节（transaction_method、transaction_confirmed、transaction_status），expense_bundle_details 为周期性设置（repeat_interval、next_repeat_timestamp）。收据路径和备注在此返回，而不出现在列表响应中。
认证方式：会话 Cookie。
- expense
- payment_details
- expense_bundle_details
- id
- cost
- currency_code
- details
- receipt_path
- comments_count
- transaction_method
- transaction_confirmed
- transaction_status
- repeat_interval
- next_repeat_timestamp
```
GET /v1/shared-costs/entries/501/details HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
```
```
{
  "expense": {
    "id": 501,
    "description": "Groceries",
    "cost": "86.40",
    "currency_code": "USD",
    "date": "2026-10-18",
    "details": "Weekly shared shop",
    "receipt_path": "/illustrations/receipts/receipt-501.jpg",
    "comments_count": 1
  },
  "payment_details": {
    "transaction_method": "card",
    "transaction_confirmed": true,
    "transaction_status": "posted"
  },
  "expense_bundle_details": {
    "repeat_interval": "monthly",
    "next_repeat_timestamp": 1794960000
  }
}
```

为支出添加评论

POST /v1/shared-costs/annotations openfinance

为支出添加一条串联备注。响应包含 content、comment_type、created_at 和 person，账本审阅者因此可以把每条评论归到具体成员，并按支出时间线排序，而无需加载整个账本。

认证方式：会话 Cookie；表单编码的请求体。

id
comment_type
content
created_at
deleted_at
expense_id
person_id
person

POST /v1/shared-costs/annotations HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
Content-Type: application/x-www-form-urlencoded

expense_id=501&content=Receipt%20attached

{
  "comment": {
    "id": 601,
    "comment_type": "user",
    "content": "Receipt attached",
    "created_at": "2026-10-18T19:42:11Z",
    "deleted_at": null,
    "expense_id": 501,
    "person_id": 101,
    "person": {
      "id": 101,
      "first_name": "Alex"
    }
  }
}

群组账本与债务图

GET /v1/circles/{circle_id}/balances openfinance

返回一个群组及其成员与资金关系图。original_debts 保留已发生的每一笔两两债务，simplified_debts 把它们合并为最少的转账集合，repayments 记录已经付清的部分；simplify_by_default 与 invite_link 描述该群组的结算策略与加入路径。

认证方式：会话 Cookie。

id
name
group_type
simplify_by_default
invite_link
updated_at
members
original_debts
simplified_debts
repayments
from
to
amount
currency_code

GET /v1/circles/301/balances HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>

{
  "group": {
    "id": 301,
    "name": "Shared household",
    "group_type": "household",
    "simplify_by_default": true,
    "invite_link": "/illustrations/invites/household-example",
    "updated_at": "2026-10-19T08:12:00Z",
    "members": [
      {
        "id": 101,
        "first_name": "Alex"
      },
      {
        "id": 202,
        "first_name": "Sam"
      }
    ],
    "original_debts": [
      {
        "from": 202,
        "to": 101,
        "amount": "43.20",
        "currency_code": "USD"
      }
    ],
    "simplified_debts": [
      {
        "from": 202,
        "to": 101,
        "amount": "43.20",
        "currency_code": "USD"
      }
    ],
    "repayments": []
  }
}

通知动态

GET /v1/activity/events openfinance

流式返回最近的动态。type 以及 source_type/source_id 把每个事件指向引发它的支出或群组，via 记录发起的客户端，app_link 提供深度链接。同步服务可把该动态作为变更信号，再只获取所引用的源对象。

认证方式：会话 Cookie；limit 为查询参数。

id
type
created_at
created_by
source_type
source_id
source_url
image_url
image_shape
content
via
app_link

GET /v1/activity/events?limit=50 HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>

{
  "notifications": [
    {
      "id": 701,
      "type": "expense_added",
      "created_at": "2026-10-18T19:40:02Z",
      "created_by": {
        "id": 101,
        "first_name": "Alex"
      },
      "source_type": "expense",
      "source_id": 501,
      "source_url": "/illustrations/expenses/501",
      "image_url": "/illustrations/avatars/member-101.png",
      "image_shape": "circle",
      "content": "Alex added Groceries",
      "via": "android",
      "app_link": "/illustrations/expenses/501"
    }
  ]
}

货币目录

GET /v1/reference/money-units opendata

列出账本条目可用的货币，以 ISO 代码为键并附显示符号。它是解析支出、群组债务和钱包余额中每个 currency_code 的参考表，使用方无需硬编码符号即可标注金额。

认证方式：会话 Cookie。

id
code
unit

GET /v1/reference/money-units HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>

{
  "currencies": [
    {
      "id": 1,
      "code": "USD",
      "unit": "$"
    },
    {
      "id": 2,
      "code": "EUR",
      "unit": "€"
    },
    {
      "id": 3,
      "code": "JPY",
      "unit": "¥"
    }
  ]
}

创建点对点付款请求

POST /v1/settlements/requests openbanking

通过 Splitwise Pay 请其他成员付款。requested_payment_method 选择支付通道（splitwise_p2p 或 pay_by_bank），relationship_type/relationship_id 把请求绑定到群组或好友，响应补充 status、createdAt 和 expiresAt，请求无法即时送达时还会带有 warning 字段。

认证方式：会话 Cookie；application/json 请求体，并带客户端时区请求头。

requestee_id
requested_amount
currency_code
requested_payment_method
relationship_type
relationship_id
status
createdAt
expiresAt
requestedAmount
currencyCode
relationshipType
warning

POST /v1/settlements/requests HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
Content-Type: application/json
X-Client-Time-Zone: America/New_York

{
  "requestee_id": 202,
  "requested_amount": "43.20",
  "currency_code": "USD",
  "requested_payment_method": "splitwise_p2p",
  "relationship_type": "group",
  "relationship_id": 301
}

{
  "data": {
    "type": "payment_request",
    "id": "request_example_1",
    "attributes": {
      "status": "pending",
      "requestedPaymentMethod": "splitwise_p2p",
      "createdAt": "2026-10-20T14:05:00Z",
      "expiresAt": "2026-10-27T14:05:00Z",
      "requestedAmount": "43.20",
      "currencyCode": "USD",
      "relationshipType": "group"
    }
  },
  "included": [],
  "meta": {
    "warning": null
  }
}

导入的银行与银行卡交易

GET /v1/linked-accounts/entries openbanking

列出从已关联资金来源拉取的交易。status 依次经历 pending、possible_hold 和 posted；rawName 保留对账单摘要，name 为清洗后的商户名；transactionId 与 amount 支持同外部银行卡流水匹配，unsplittableAlert 标记导入器无法直接拆分的行。

认证方式：会话 Cookie；必须已在应用内授权关联的银行或银行卡访问权限。

id
amount
categoryId
currencyCode
status
name
rawName
date
dateTime
transactionId
relatedResource
unsplittableAlert

GET /v1/linked-accounts/entries HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
X-Client-Time-Zone: America/New_York

{
  "data": [
    {
      "type": "imported_transaction",
      "id": "import_example_1",
      "attributes": {
        "amount": "86.40",
        "categoryId": "groceries",
        "currencyCode": "USD",
        "status": "posted",
        "name": "Example grocery shop",
        "rawName": "EXAMPLE GROCER 001",
        "date": "2026-10-18",
        "dateTime": "2026-10-18T17:12:00Z",
        "transactionId": "transaction_example_1",
        "relatedResource": null,
        "unsplittableAlert": false
      }
    }
  ],
  "included": [],
  "meta": {
    "total": 1
  }
}

拆分导入的交易

POST /v1/linked-accounts/splits openfinance

把一笔或多笔导入交易转为共享支出，将每笔绑定到群组或好友。批量请求体把 imported_transaction_id 与 expense_relationship_type/id 配对，响应逐项返回 modules 以及 processed/failed 计数，对账任务因此只需重试失败的项。

认证方式：会话 Cookie；application/json 请求体。

imported_transaction_id
expense_relationship_id
expense_relationship_type
data
modules
metadata
processed
failed

POST /v1/linked-accounts/splits HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
Content-Type: application/json
X-Client-Time-Zone: America/New_York

{
  "data": [
    {
      "imported_transaction_id": "import_example_1",
      "attributes": {
        "expense_relationship_id": 301,
        "expense_relationship_type": "group"
      }
    }
  ]
}

{
  "data": {
    "modules": [
      {
        "id": "import_example_1",
        "status": "linked",
        "expense_id": 501
      }
    ]
  },
  "metadata": {
    "processed": 1,
    "failed": 0
  }
}

钱包月度对账单

GET /v1/cash-accounts/{account_id}/monthly-records openbanking

按月提供 Splitwise 钱包历史。每份对账单以 month 为键，用钱包币种的期初与期末余额框定该期间，记账导出据此可还原 P2P 付款背后的余额轨迹。

认证方式：会话 Cookie。

statements
month
opening_balance
closing_balance
currency_code

GET /v1/cash-accounts/cash_example_1/monthly-records HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
X-Client-Time-Zone: America/New_York

{
  "statements": [
    {
      "month": "2026-09",
      "opening_balance": "120.00",
      "closing_balance": "163.20",
      "currency_code": "USD"
    },
    {
      "month": "2026-10",
      "opening_balance": "163.20",
      "closing_balance": "213.20",
      "currency_code": "USD"
    }
  ]
}

向 Splitwise 钱包充值

POST /v1/cash-accounts/{account_id}/funding-transfers openbanking

把资金从已关联的资金来源转入钱包，并返回更新后的资金来源。primaryType 区分 bank_account、debit_card 和 wallet_balance 通道；availableBalance 与 pendingBalance 显示现在可用与仍在清算的金额，discardedAt 标记已撤销的来源。

认证方式：会话 Cookie；application/json 请求体，指明已授权的资金来源。

uuid
primaryType
createdAt
updatedAt
discardedAt
data
currencyCode
availableBalance
pendingBalance

POST /v1/cash-accounts/cash_example_1/funding-transfers HTTP/1.1
Accept: application/json
Cookie: <example-session-cookie>
Content-Type: application/json
X-Client-Time-Zone: America/New_York

{
  "amount": "50.00",
  "currency_code": "USD",
  "funding_source_uuid": "source_example_1"
}

{
  "wallet_funding_source": {
    "uuid": "source_example_1",
    "primaryType": "bank_account",
    "createdAt": "2026-09-02T10:14:00Z",
    "updatedAt": "2026-10-21T09:00:00Z",
    "discardedAt": null,
    "data": {
      "currencyCode": "USD",
      "availableBalance": "213.20",
      "pendingBalance": "0.00"
    }
  }
}

数据类别

共享支出
支出份额
群组与成员
好友
结算债务
评论
通知
货币
付款请求
导入的银行交易
钱包对账单
钱包资金来源

数据使用场景与案例

家庭账本整合
财务应用拉取每笔支出的 cost、currency_code、group_id，以及每位成员的 paid_share 与 owed_share，把家庭账本镜像到自己的记账模型中，房租、水电和日用杂货无需手工录入即可对平。
结算规划
团体旅行或社团工具读取 members、original_debts、simplified_debts 和 repayments，计算出清掉所有余额所需的最少转账笔数，再跟踪哪些建议实际已付。
银行卡流水对账
支出自动化服务按 transactionId 与 rawName 把 imported_transactions 同企业银行卡流水进行匹配，等 status 变为 posted 后，再通过对应的支出端点把每一行拆入正确的群组。
点对点请求监控
财务看板按 requestedAmount、expiresAt、status 和 warning 监控付款请求，掌握哪些点对点转账仍未结清、哪些已过期未付，以及某个账户能否继续发起新请求。

常见问题

支出份额如何关联到群组的结算余额？

一笔支出记录 cost、currency_code 和 split_method，并为每位参与者给出 user_id、paid_share 与 owed_share。group_id 把它连接到共享账本，category_id 为账单分类，conflictDetected 标记冲突的编辑。群组记录包含 members、original_debts、simplified_debts 和 repayments。债务条目标明 from、to、amount 与 currency_code，规划工具因此能把原始债务、建议的结算转账和已记录的还款区分开来。

哪些字段支持银行或银行卡交易对账？

导入的交易包含 transactionId、amount、currencyCode、name 和 rawName，另有 pending、possible_hold 或 posted 等 status。relatedResource 与 unsplittableAlert 支持匹配和异常处理，支出分配结果则报告 processed 与 failed 计数。

哪些字段跟踪付款请求与钱包余额历史？

请求记录包含 requestedAmount、currencyCode、requestedPaymentMethod、relationshipType、status、createdAt 和 expiresAt。warning 字段携带可能影响请求的送达或账户通知。月度对账单提供 month、opening_balance、closing_balance 与 currency_code。资金来源记录另外给出 primaryType、availableBalance、pendingBalance 与 discardedAt，用来区分资金通道、清算状态和已撤销的来源。

这些端点路径是官方服务地址吗？

不是。本页的路径及请求与响应载荷均为示意性的集成示例，并非 Splitwise 的官方服务地址。示例保留会话 Cookie 鉴权并使用占位凭据，不授予账户访问权限，也不允许发起付款。

与 Splitwise 相似的应用

tricount — tricount 是 Tricount SA 的免费 Android 和 iPhone 应用，用来记录出行、聚餐和合租的共同账单，支持自定义分摊和多币种，并可导入已有的 Splitwise 群组。
Settle Up — Settle Up 由 Step Up Labs 推出，覆盖网页、Android 和 iPhone，用来跟踪团体共同开销、在成员之间同步，并算出结清债务所需的最少转账次数。
Splid — Splid 是面向度假、合租或情侣的 iOS 与 Android 共同开销应用，可在线或离线记账且无需注册，并支持 150 多种货币换算。
Kittysplit — Kittysplit 是网页、iPhone 和 Android 上的分账工具，通过分享 Kitty 链接让大家录入支出，免费档不设每日额度，注册可选，并支持导入 Splitwise 的 CSV。
Venmo — Venmo 是 PayPal 面向美国用户的收付款应用，用于朋友间转账，其产品页把分摊团体开销与转账列在一起。
Spliit — Spliit 是免费开源的网页和 iPhone 应用，无需注册即可在群组里记录共同开销，支持按百分比、份额或精确金额分摊，并算出较省事的还款路径。
Splitser — Splitser 面向朋友、家人、室友和旅行团，可按 150 多种货币记录团体开销，并算出尽量减少互相转账次数的结清方案。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Splitwise 共享支出、余额与点对点支付 API

应用截图

API 端点一览

会话登录

账户初始化数据包

带过滤条件的支出列表

创建或更新支出

含付款环节的支出详情

为支出添加评论

群组账本与债务图

通知动态

货币目录

创建点对点付款请求

最近的付款请求

导入的银行与银行卡交易

拆分导入的交易

钱包月度对账单

向 Splitwise 钱包充值

数据类别

数据使用场景与案例

家庭账本整合

结算规划

银行卡流水对账

点对点请求监控

常见问题

与 Splitwise 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

C3Pay

相关主题

需要集成这个 App 的数据 API？

Splitwise 共享支出、余额与点对点支付 API

应用截图

API 端点一览

会话登录

账户初始化数据包

带过滤条件的支出列表

创建或更新支出

含付款环节的支出详情

为支出添加评论

群组账本与债务图

通知动态

货币目录

创建点对点付款请求

最近的付款请求

导入的银行与银行卡交易

拆分导入的交易

钱包月度对账单

向 Splitwise 钱包充值

数据类别

数据使用场景与案例

家庭账本整合

结算规划

银行卡流水对账

点对点请求监控

常见问题

相关应用

与 Splitwise 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

C3Pay

相关主题

需要集成这个 App 的数据 API？