Wolt Courier Partner 骑手数据 API

Wolt Oy · 外卖

Wolt Courier Partner 是 Wolt Oy 推出的骑手端应用。Wolt 是总部位于赫尔辛基的配送公司，2022 年被 DoorDash 收购，至今仍作为子品牌在欧洲和亚洲运营。骑手用自己的手机登录，开启限定时长的班次上线接单，接受餐厅和杂货的配送邀约，先导航到取货点、再前往送达地址；在实行货到刷卡的市场，还可以用 Stripe 读卡终端在门口收款。账户页面涵盖骑手的个人资料与车辆信息、货到付款（现金）登记、提前提现，以及欧盟 DAC7 税务报告。该应用面向 Wolt 在柏林、巴库等城市的骑手伙伴发布，位于 Wolt 餐厅、杂货与 Wolt Market 配送网络中承担实际作业的一端；这些骑手常常同时使用 Uber Eats、Lieferando、Bolt Food 和 Glovo。

限时班次在骑手上线时记下一个 session_pdrn，进行中的班次带有 scheduled_end_time 与 earning_mode，骑手临时离开时还会留下 pause_reason。资料卡保存 courier_id、preferred_name、vehicle_type，以及以 dac7_reports 形式列出的欧盟 DAC7 记录，每条都带一个签名 url，在 valid_until 到期。

新任务以 offer_id 页面的形式到达，骑手接受后落到某个 task_group_id 上；货到付款登记暴露 status 与 time_created；Stripe 货到刷卡先签发 connection_token，再生成 payment_intent；提前提现则给出介于 min 与 max 之间、以 currencyCode 计价的金额。车队薪酬、税务打包工具和实时运营看板都在使用这些字段，openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

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

骑手个人资料

GET /v1/partners/me osint

读取已登录骑手的身份信息、紧急联系人、车辆和 DAC7 报告列表，用于支撑账户与个人资料页面。

认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）

personal_information
courier_id
display_name
preferred_name
phone
email
address
join_date
hero_initials
emergency_contact
gear
reports
dac7_reports
account
profile_photo_url
vehicle_details
vehicle_type
registration
courier_declared_capacity

GET /v1/partners/me HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "data": {
    "personal_information": {
      "courier_id": {"type": "WOLT", "id": "crr_7f21a9"},
      "display_name": "Mika L.",
      "preferred_name": "Mika",
      "phone": "+358401234567",
      "email": "[email protected]",
      "address": "Mannerheimintie 1, Helsinki",
      "join_date": "2023-04-12T09:00:00Z",
      "hero_initials": "ML"
    },
    "emergency_contact": {"name": "Anna L.", "phone": "+358409998877"},
    "gear": {"items": []},
    "reports": {"dac7_reports": [{"year": 2025, "country_code": "DE"}]},
    "account": {"delete_account": {"disabled_reason": null}},
    "profile_photo_url": "https://cdn.example.com/couriers/crr_7f21a9.jpg",
    "vehicle_details": {"vehicle_type": "BICYCLE", "registration": null, "courier_declared_capacity": 2}
  },
  "configurations": {},
  "meta": {}
}

DAC7 税务报告下载链接
GET /v1/partners/tax-reports/{year}/{country_code}/download openfinance
为指定年份和国家签发限时有效的下载地址，用于获取骑手的欧盟 DAC7 平台运营方税务报告。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- year
- country_code
- url
- valid_until
```
GET /v1/partners/tax-reports/2025/DE/download HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "year": 2025,
  "country_code": "DE",
  "url": "https://cdn.example.com/tax-reports/2025/DE/crr_7f21a9.pdf?sig=...",
  "valid_until": "2026-10-08T16:30:00Z"
}
```

开启骑手班次

POST /v1/shifts/begin opendata

让骑手上线开始一段限定时长的班次，并返回 session_pdrn，供暂停、恢复、修改结束时间和结束班次等调用使用。

认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）

session_pdrn
earning_mode
scheduled_end_time
vehicle_type
status

POST /v1/shifts/begin HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "earning_mode": "OFFER",
  "scheduled_end_time": "2026-10-08T20:00:00Z",
  "vehicle_type": "BICYCLE"
}

{
  "session_pdrn": "pdrn:wolt:session:ses_9c41",
  "earning_mode": "OFFER",
  "scheduled_end_time": "2026-10-08T20:00:00Z",
  "status": "ACTIVE"
}

当前骑手班次
GET /v1/shifts/current opendata
返回骑手当前进行中的班次；骑手离线时返回为空——对应首页的在线状态。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- session_pdrn
- earning_mode
- scheduled_end_time
- preferred_end_time
- status
```
GET /v1/shifts/current HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "session_pdrn": "pdrn:wolt:session:ses_9c41",
  "earning_mode": "OFFER",
  "scheduled_end_time": "2026-10-08T20:00:00Z",
  "preferred_end_time": "2026-10-08T20:00:00Z",
  "status": "ACTIVE"
}
```
暂停骑手班次
POST /v1/shifts/{session_pdrn}/pause opendata
以原因码暂停进行中的班次，让骑手不再收到邀约，但班次并不结束。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- session_pdrn
- pause_reason
- status
```
POST /v1/shifts/pdrn:wolt:session:ses_9c41/pause HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "pause_reason": "BREAK"
}
```
```
{
  "session_pdrn": "pdrn:wolt:session:ses_9c41",
  "status": "PAUSED",
  "pause_reason": "BREAK"
}
```

任务邀约页面

POST /v1/offers/preview opendata

加载弹出的配送邀约页面：骑手接单前能看到的取货商户、时间和计酬模式。

认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）

offer_id
task_group_id
pickup_business_name
estimated_pickup_end_time
earning_mode

POST /v1/offers/preview HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "offer_id": "off_3c91",
  "task_group_id": "tg_8841"
}

{
  "offer_id": "off_3c91",
  "task_group_id": "tg_8841",
  "pickup_business_name": "Fazer Cafe Kamppi",
  "estimated_pickup_end_time": "2026-10-08T17:12:00Z",
  "earning_mode": "OFFER"
}

接受任务邀约

POST /v1/offers/accept opendata

从骑手当前位置接受已派发的配送邀约，并把 task_group_id 绑定到当前班次。

认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）

offer_id
task_group_id
lat
lng
status

POST /v1/offers/accept HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "offer_id": "off_3c91",
  "task_group_id": "tg_8841",
  "lat": 52.5200,
  "lng": 13.4050
}

{
  "offer_id": "off_3c91",
  "task_group_id": "tg_8841",
  "status": "ACCEPTED"
}

完成配送步骤
POST /v1/deliveries/advance opendata
骑手推进实时订单时，把配送途中的当前工作流步骤（取货、送达、返回）标记为完成。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- task_group_id
- step
- status
```
POST /v1/deliveries/advance HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "task_group_id": "tg_8841",
  "step": "DROPOFF"
}
```
```
{
  "task_group_id": "tg_8841",
  "step": "DROPOFF",
  "status": "COMPLETED"
}
```
提前提现额度
GET /v1/payouts/early-quote openfinance
返回提前提现的额度：以最小货币单位计的可用最小、最大与默认金额，以及区域设置，供提前提现页面使用。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- moneyContext
- max
- min
- defaultAmount
- currencyCode
- value
- decimalPlaces
- overMaxAmountMessage
- locale
```
GET /v1/payouts/early-quote HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "moneyContext": {
    "max": {"currencyCode": "EUR", "value": 18500},
    "min": {"currencyCode": "EUR", "value": 500},
    "defaultAmount": {"currencyCode": "EUR", "value": 5000},
    "decimalPlaces": 2,
    "overMaxAmountMessage": "Amount exceeds available balance",
    "locale": "de-DE"
  }
}
```
货到付款登记
GET /v1/payments/cash/enrollment openfinance
读取骑手是否已登记在送达时收取现金，包括货到付款登记面板上展示的状态时间戳。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- enrollment
- courier_id
- status
- time_created
- time_last_modified
- updated_by_user_id
```
GET /v1/payments/cash/enrollment HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "enrollment": {
    "courier_id": "crr_7f21a9",
    "status": "ENROLLED",
    "time_created": "2025-03-02T11:14:00Z",
    "time_last_modified": "2026-09-18T08:02:00Z",
    "updated_by_user_id": "usr_ops_11"
  }
}
```
Stripe 读卡终端连接令牌
GET /v1/payments/card-reader/connection-token openfinance
生成 Stripe Terminal 的 connection_token，让骑手的手机能与读卡器通信，用于货到刷卡。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- connection_token
- psp_id
```
GET /v1/payments/card-reader/connection-token HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "connection_token": "pst_test_example_token",
  "psp_id": "stripe"
}
```
货到刷卡支付意图
POST /v1/payments/card-reader/payment-intent/{task_group_id} openfinance
为指定任务组创建 Stripe PaymentIntent，用于送达时刷卡收款。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- task_group_id
- client_secret
- payment_intent
- amount
- currency
```
POST /v1/payments/card-reader/payment-intent/tg_8841 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "task_group_id": "tg_8841"
}
```
```
{
  "task_group_id": "tg_8841",
  "client_secret": "pi_example_secret_abc",
  "payment_intent": "pi_example",
  "amount": 2490,
  "currency": "eur"
}
```
离线首页
GET /v1/home/offline-screen opendata
加载离线首页：骑手开始班次之前显示的车辆、需求预测和加成日历等功能开关。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- courier_id
- vehicle_type
- demand_forecast
- boost_calendar
- top_pill
```
GET /v1/home/offline-screen HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "courier_id": "crr_7f21a9",
  "vehicle_type": "BICYCLE",
  "demand_forecast": "VISIBLE",
  "boost_calendar": "VISIBLE",
  "top_pill": "VISIBLE"
}
```
按类型查询车辆
GET /v1/vehicles/by-type opendata
返回骑手所选车辆类型的载量和是否支持刷卡的标记，供上线时使用。
认证方式：骑手登录时签发的 Bearer 访问令牌（Authorization: Bearer 请求头）
- vehicle_type
- courier_declared_capacity
- card_capable
```
GET /v1/vehicles/by-type?vehicle_type=BICYCLE HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "vehicle_type": "BICYCLE",
  "courier_declared_capacity": 2,
  "card_capable": false
}
```

数据类别

骑手资料
班次
任务邀约
配送
提前提现
DAC7 税务报告
货到刷卡
货到付款

数据使用场景与案例

欧盟 DAC7 税务资料包整理
薪酬与税务工具先从骑手资料中读取 dac7_reports，再在 valid_until 之前取回每年的签名 url，让德国及其他欧盟运营方无需等待 PDF 邮件即可提交平台经济申报。
班次利用率看板
运营叠加层监测进行中班次的 session_pdrn、earning_mode 和 scheduled_end_time，以及 pause_reason，用来衡量每位骑手的在线时长、休息时间和接单模式占比。
货到刷卡结算
财务机器人按 task_group_id 把 Stripe 的 connection_token 与 payment_intent 记录同货到付款登记状态关联，让当面刷卡的收款与骑手提前提现的 min/max 额度对得上账。
实时邀约接受信息流
调度监控流式读取 /v1/offers/preview 与 /v1/offers/accept 事件（offer_id、取货时间），并与 /v1/deliveries/advance 的送达记录并排比对，找出柏林和巴库停滞的任务组。

常见问题

资料接口会返回哪些骑手身份字段？

GET /v1/partners/me 返回 personal_information（含 courier_id、display_name、preferred_name、phone、email、address、join_date 和 hero_initials），以及 vehicle_details（vehicle_type、courier_declared_capacity）和 dac7_reports 列表。

限时班次在 API 里是怎么运作的？

POST /v1/shifts/begin 开启班次并返回 session_pdrn；GET /v1/shifts/current 读取进行中班次的 earning_mode 与 scheduled_end_time；POST /v1/shifts/{session_pdrn}/pause 记录 pause_reason，但不会结束班次。

货到刷卡的款项在哪里收取？

应用先获取读卡终端的 connection_token，再为 task_group_id 创建 payment_intent。/v1/payments/cash/enrollment 上的货到付款登记则是另一套状态（ENROLLED 及时间戳），适用于当面收现金的市场。

骑手是如何认证的？

骑手登录后，应用持有访问令牌，并在每次数据调用中以 Authorization: Bearer 请求头附带；资料、班次、邀约与支付路由都使用同一枚令牌。

与 Wolt Courier Partner 相似的应用

DoorDash - Dasher — DoorDash 的 Dasher 是该公司在北美和大洋洲自有品牌下的骑手端；DoorDash 于 2022 年 5 月收购 Wolt 后，在欧洲和亚洲继续使用 Wolt 子品牌。
Uber - Driver: Drive & Deliver — Uber 司机端也承接 Uber Eats 外卖单；维基百科将 Uber Eats 列为与 DoorDash、Deliveroo 和 Just Eat Takeaway 竞争的餐饮外卖平台，并覆盖德国、芬兰等与 Wolt 重叠的市场。
Glovo — Glovo 是总部位于巴塞罗那的即时配送应用，自 2022 年起由 Delivery Hero 控股，骑手通过它承接餐厅、杂货及其他本地商家订单，覆盖多个国家。
Lieferando — Lieferando 是 Just Eat Takeaway 在德国的餐饮外卖品牌，德国骑手常把它当作 Takeaway.com 体系里对标 Wolt 的接单应用。
Bolt Food — Bolt Food 是爱沙尼亚出行公司 Bolt 的餐饮与杂货配送服务，2019 年在塔林上线，之后扩展到 20 个国家的 80 多座城市。
Deliveroo — Deliveroo 是总部位于伦敦的餐饮外卖公司，2025 年 10 月起由 DoorDash 控股；自雇自行车和摩托车骑手在英国、法国、比利时、爱尔兰、意大利和阿联酋承接餐厅与杂货订单。
Amazon Flex — Amazon Flex 是亚马逊 2015 年推出的零工配送平台，独立承包人用专用应用完成 Prime Now 及其他末端派送。

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

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

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

获取报价

Wolt Courier Partner 骑手数据 API

应用截图

API 端点一览

骑手个人资料

DAC7 税务报告下载链接

开启骑手班次

当前骑手班次

暂停骑手班次

任务邀约页面

接受任务邀约

完成配送步骤

提前提现额度

货到付款登记

Stripe 读卡终端连接令牌

货到刷卡支付意图

离线首页

按类型查询车辆

数据类别

数据使用场景与案例

欧盟 DAC7 税务资料包整理

班次利用率看板

货到刷卡结算

实时邀约接受信息流

常见问题

与 Wolt Courier Partner 相似的应用

更多外卖类应用

DiDi Delivery: Deliver & Earn

DoorDash - Dasher

GoFood Merchant

iFood para Entregadores

相关主题

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

Wolt Courier Partner 骑手数据 API

应用截图

API 端点一览

骑手个人资料

DAC7 税务报告下载链接

开启骑手班次

当前骑手班次

暂停骑手班次

任务邀约页面

接受任务邀约

完成配送步骤

提前提现额度

货到付款登记

Stripe 读卡终端连接令牌

货到刷卡支付意图

离线首页

按类型查询车辆

数据类别

数据使用场景与案例

欧盟 DAC7 税务资料包整理

班次利用率看板

货到刷卡结算

实时邀约接受信息流

常见问题

相关应用

与 Wolt Courier Partner 相似的应用

更多外卖类应用

DiDi Delivery: Deliver & Earn

DoorDash - Dasher

GoFood Merchant

iFood para Entregadores

相关主题

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