Careem Captain 数据 API：钱包、收入与订单

Careem · 出行

Careem Captain 是 Careem 的司机端应用——Careem 是在迪拜创立、自 2020 年起归 Uber 所有的网约车平台，其司机被称为 Captain，在阿联酋各地用这款应用跑完每个班次。Captain 在应用里上线、接受打车与配送邀约，跟随行程地图依次完成到达、接到乘客、送达等步骤，在送达时确认乘客支付的现金，并在行程结束后查看车费回执。收入首页按周期展示总额，并拆分为行程收入、小费、奖励、保底补贴、罚款和驾驶行为扣款；订单页按提现周期列出逐单行程记录；支付方式与提现页面把已结算收入转入银行账户或 Careem Pay 钱包，也可以先转入应用内钱包，在新订单被冻结前结清欠缴的现金。绩效首页跟踪接单率 KPI——低于门槛的 Captain 可能被停止派单——同时展示评分、完成单数、取消率和在线时长；区域与排班制 Captain 按预约的班次出车，“去哪儿接单”页面推荐司机附近的高需求区域，“我的资料”页则记录 Captain 所在城市与车辆。在阿联酋，它与 Uber 自有司机端、Bolt、Yango 和 inDrive 争夺同一批司机。

送达乘客时收取的现金是这本账的起点：钱包头寸里，walletBalance 旁边是 cashBalanceAmount——司机手里尚未上缴的乘客现金，它以 warningCashLimit 和 blockingCashLimit 为界，并汇总为 cashStatus；每次确认收现都会按订单的 jobUid 更新这笔余额。收入汇总为 totalEarnings，其 breakdown 拆分为 tripEarnings、tips、matchedTips、bonuses、guarantees、fines、finesRefunds 与 behaviorPenalties；提现周期明细把 jobId、tripId 与 amount、vertical、status 对应起来，unverifiedTransactions 则记录仍在等待结算的现金行程。

每趟行程都以一条车费记录收尾：tripPrice、discount、promotionalDiscount、userCreditUsed 以及司机所得的 captainEarning；资金经由提现目的地流出，其中含 bankName、accountIBAN、walletNumber 与 nationalId，每笔提现都记在一个 disbursementId 之下。围绕资金的是运营信号：接单表现为 acceptanceRate 对照 acceptanceThreshold；绩效为 rating、completedTrips、cancellationRate 与 onlineMinutes；排班出勤为每个预约 startTime–endTime 时段内的 attendedMinutes；“去哪儿接单”区域按 demandScore 与 etaMinutes 打分；接送步骤带有 lat 与 lng 坐标；资料页则把每个 captainId 关联到 cityId 与 carId。

服务阿联酋 Captain 的车队运营方与提现工具用这份记录按存档的 IBAN 核对提现与钱包充值、关闭每个提现周期，在手头现金逼近冻结新订单的上限前发出预警，找出哪些区域能把邀约转化为已完成行程、Captain 该往哪里转移，并标记回执收入与周期台账不符的行程。openData Studio 将这份钱包、收入、提现与绩效记录变为可供这些集成调用的开放数据。

应用截图

API 端点一览

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

司机钱包与现金状态
GET /v1/wallet/cash-status/{captainId} openbanking
读取已登录司机的钱包余额与手头现金头寸，包括未上缴现金过高时会冻结新订单的预警 / 冻结现金限额。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- captainId
- walletBalance
- cashBalanceAmount
- warningCashLimit
- blockingCashLimit
- balance
- currency
- cashStatus
```
GET /v1/wallet/cash-status/18422109 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "captainId": 18422109,
  "walletBalance": 1260.5,
  "cashBalanceAmount": -85.0,
  "warningCashLimit": 150,
  "blockingCashLimit": 300,
  "balance": -85.0,
  "currency": "AED",
  "cashStatus": "WARNING"
}
```

按类型聚合收入

GET /v1/drivers/{captain_id}/earnings/aggregate/{window} openfinance

驱动收入落地页：周期总额，以及司机收入按行程收入、小费、奖励、保底、罚款与行为处罚的拆分。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

currencyCode
overview
totalEarnings
aggregationByTime
earnings
startDate
endDate
breakdown
tripEarnings
tips
matchedTips
bonuses
guarantees
fines
finesRefunds
behaviorPenalties
other

GET /v1/drivers/18422109/earnings/aggregate/WEEKLY?from=1727049600000&to=1727654400000 HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "currencyCode": "AED",
  "overview": {
    "totalEarnings": 2140.75,
    "aggregationByTime": [
      {"earnings": 380.5, "startDate": "2026-09-21", "endDate": "2026-09-21"},
      {"earnings": 412.0, "startDate": "2026-09-22", "endDate": "2026-09-22"}
    ]
  },
  "breakdown": {
    "tripEarnings": 1680.0,
    "tips": 210.5,
    "matchedTips": 40.0,
    "bonuses": 180.0,
    "guarantees": 50.0,
    "fines": 15.0,
    "finesRefunds": 0.0,
    "behaviorPenalties": 4.75,
    "other": 0.0
  }
}

按周期列出收入交易
GET /v1/earnings/transactions/{captainId}/cycle/{cycle} openfinance
列出一个提现周期的逐行程收入明细行——任务、行程、地点、金额与业务线——展示在订单 / 行程历史的收入页签。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- bookings
- jobId
- tripId
- location
- dateTimeIso
- currency
- amount
- vertical
- status
```
GET /v1/earnings/transactions/18422109/cycle/38?page=0 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "bookings": [
    {
      "jobId": 99218411,
      "tripId": "TRP-88A21",
      "location": "Downtown Dubai",
      "dateTimeIso": "2026-09-24T18:41:00Z",
      "currency": "AED",
      "amount": 42.5,
      "vertical": "RIDE",
      "status": "COMPLETED"
    }
  ]
}
```
未核销的收入交易
GET /v1/earnings/transactions/{captainId}/pending openfinance
返回仍待核销的收入——通常是等待结算的现金行程——它们会阻塞或延迟一个提现周期。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- unverifiedTransactions
- jobId
- tripId
- amount
- currency
- status
- dateTimeIso
```
GET /v1/earnings/transactions/18422109/pending?limit=20 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "unverifiedTransactions": [
    {
      "jobId": 99219002,
      "tripId": "TRP-88B04",
      "amount": 18.0,
      "currency": "AED",
      "status": "UNVERIFIED",
      "dateTimeIso": "2026-09-24T21:05:11Z"
    }
  ]
}
```

提现支付方式

GET /v1/payouts/methods/{captainId} openbanking

列出司机的提现目的地（银行 IBAN、钱包、国民身份证），用于支付方式与提现界面。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

paymentMethods
id
optionType
optionName
status
primary
detail
bankName
accountIBAN
careemCustomerId
walletNumber
nationalId

GET /v1/payouts/methods/18422109 HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "paymentMethods": [
    {
      "id": 44102881,
      "optionType": "BANK_ACCOUNT",
      "optionName": "Emirates NBD",
      "status": "VERIFIED",
      "primary": true,
      "detail": {
        "bankName": "Emirates NBD",
        "accountIBAN": "AE070331234567890123456",
        "careemCustomerId": "c_9b0e12f4",
        "walletNumber": null,
        "nationalId": "784-1988-1234567-1"
      }
    }
  ]
}

提现收入

POST /v1/payouts/disburse openfinance

把司机已结算的收入提现到主提现方式（银行账户或钱包）。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

disbursementId
captainId
amount
currency
paymentMethodId
status

POST /v1/payouts/disburse HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "captainId": 18422109,
  "amount": 800.0,
  "currency": "AED",
  "paymentMethodId": 44102881
}

{
  "disbursementId": "dsb_77a1c0",
  "captainId": 18422109,
  "amount": 800.0,
  "currency": "AED",
  "paymentMethodId": 44102881,
  "status": "PROCESSING"
}

从收入向钱包充值
POST /v1/wallet/topup openfinance
把已结算的行程收入转入司机钱包，用于支付未结清的现金余额或在应用内消费。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- captainId
- amount
- currency
- walletBalance
- status
```
POST /v1/wallet/topup HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "captainId": 18422109,
  "amount": 150.0,
  "currency": "AED"
}
```
```
{
  "captainId": 18422109,
  "amount": 150.0,
  "currency": "AED",
  "walletBalance": 1410.5,
  "status": "SUCCEEDED"
}
```

确认订单邀约

POST /v1/dispatch/offers/acknowledge opendata

接受或确认传入的打车 / 配送邀约，使任务分配给该司机并出现在实时行程界面。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

jobUid
id
uid
viewUid
status
forcedSyncKey
accepted
captainId

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

{
  "jobUid": "job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234",
  "captainId": 18422109,
  "accepted": true
}

{
  "jobUid": "job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234",
  "id": 99218411,
  "uid": "job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234",
  "viewUid": "vw_99218411",
  "status": "ASSIGNED",
  "forcedSyncKey": "sync_4410"
}

标记任务步骤完成

POST /v1/dispatch/jobs/{jobUid}/steps/{stepUid}/complete opendata

推进任务经过接驾 / 送达各步骤（到达、已接驾、已送达），驱动行程中地图与下一站 UI。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

jobUid
stepUid
status
id
schedule
lat
lng

POST /v1/dispatch/jobs/job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234/steps/stp_pickup/complete HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "lat": 25.1972,
  "lng": 55.2744,
  "status": "ARRIVED_PICKUP"
}

{
  "jobUid": "job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234",
  "stepUid": "stp_pickup",
  "status": "ARRIVED_PICKUP",
  "id": 99218411,
  "schedule": {"etaSeconds": 420}
}

确认现金已收

POST /v1/dispatch/jobs/{jobUid}/cash-confirm openfinance

记录乘客在送达时以现金付款，更新司机未结清的手头现金余额。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

jobUid
amount
currency
status
cashBalanceAmount

POST /v1/dispatch/jobs/job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234/cash-confirm HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "amount": 42.5,
  "currency": "AED"
}

{
  "jobUid": "job_8f21c0a4-9b11-4e02-a1c3-77d4e8b01234",
  "amount": 42.5,
  "currency": "AED",
  "status": "CASH_PAID",
  "cashBalanceAmount": -127.5
}

订单车费明细

GET /v1/trips/{bookingId}/fare-breakdown openfinance

返回行程后的车费回执——乘客价格、折扣与 captainEarning——展示在行程结束 / 行程回执界面。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

tripId
tripPrice
discount
promotionalDiscount
captainEarning
baseAmount
userCredit
userCreditUsed
creditCardsOnFile
isOffline
currency
basePriceType

GET /v1/trips/99218411/fare-breakdown HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "tripId": 99218411,
  "tripPrice": 48.0,
  "discount": 5.5,
  "promotionalDiscount": 2.0,
  "captainEarning": 36.4,
  "baseAmount": 32.0,
  "userCredit": 0.0,
  "userCreditUsed": 0.0,
  "creditCardsOnFile": 1,
  "isOffline": false,
  "currency": {"code": "AED", "name": "United Arab Emirates dirham"},
  "basePriceType": "METERED"
}

司机接单率
GET /v1/metrics/acceptance-rate opendata
读取自动派单与绩效卡片使用的司机接单 KPI；低于阈值可能冻结司机。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- acceptanceRate
- acceptanceFlag
- acceptanceThreshold
- captainId
```
GET /v1/metrics/acceptance-rate?captainId=18422109&from=1727049600000 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "acceptanceRate": 0.86,
  "acceptanceFlag": "HEALTHY",
  "acceptanceThreshold": 0.7,
  "captainId": 18422109
}
```
绩效报告概览
GET /v1/performance/overview/{captainId} opendata
加载司机绩效报告概览——评分、完成行程数、取消率与在线时长——展示在参与度 / 绩效首页。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- captainId
- acceptanceRate
- rating
- completedTrips
- cancellationRate
- onlineMinutes
```
GET /v1/performance/overview/18422109 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "captainId": 18422109,
  "acceptanceRate": 0.86,
  "rating": 4.92,
  "completedTrips": 1842,
  "cancellationRate": 0.04,
  "onlineMinutes": 2460
}
```

班次出勤

GET /v1/shifts/attendance/{captainId} opendata

返回区域 / 班次司机使用的排班出勤——预订时段与实际在线分钟数的对比。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

captainId
shifts
shiftId
startTime
endTime
attendedMinutes
status

GET /v1/shifts/attendance/18422109?from=1727049600000&to=1727654400000 HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "captainId": 18422109,
  "shifts": [
    {
      "shiftId": "sh_44102",
      "startTime": "2026-09-24T06:00:00Z",
      "endTime": "2026-09-24T14:00:00Z",
      "attendedMinutes": 455,
      "status": "COMPLETED"
    }
  ]
}

去哪接单推荐

GET /v1/demand/recommendations opendata

根据司机当前位置推荐高需求区域，让司机向订单密度更高的地方转移。

认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）

recommendations
zoneId
name
demandScore
etaMinutes
lat
lng

GET /v1/demand/recommendations?lat=25.2048&lng=55.2708 HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "recommendations": [
    {
      "zoneId": "dxb_downtown",
      "name": "Downtown Dubai",
      "demandScore": 0.82,
      "etaMinutes": 8,
      "lat": 25.1972,
      "lng": 55.2744
    }
  ]
}

司机资料
GET /v1/drivers/profile osint
读取已登录司机的身份、城市与车辆信息，供“我的资料”与侧滑菜单头部使用。
认证方式：司机登录时签发的 Bearer 访问令牌（Authorization: Bearer）
- captainId
- firstName
- lastName
- phone
- cityId
- carId
- status
```
GET /v1/drivers/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "captainId": 18422109,
  "firstName": "Ahmed",
  "lastName": "Hassan",
  "phone": "+971501234567",
  "cityId": 1,
  "carId": 55201,
  "status": "ACTIVE"
}
```

数据类别

余额
交易
提现
行程
身份
绩效

数据使用场景与案例

司机提现对账
拉取每周收入聚合（tripEarnings、tips、bonuses、fines）与周期交易明细，再把提现与钱包充值同存档的银行 IBAN 比对，让车队运营方能结清每个提现周期。
手头现金风险监控
轮询钱包现金状态接口与现金收款任务事件。当 cashBalanceAmount 接近 warningCashLimit 或 blockingCashLimit 时告警，让司机在新订单冻结前向钱包充值。
订单质量与运力热力图
结合 acceptanceRate、班次出勤分钟数与去哪接单的 demandScore，看出哪些区域能把订单转化为完成的行程，以及司机应该转移到哪里接单。
行程级车费审计
把车费回执中的 captainEarning 与逐行程的 amount、vertical、status 明细行关联，标记回执收入与周期台账不符的行程。

常见问题

Careem Captain 暴露哪些收入字段？

收入聚合调用返回 currencyCode、totalEarnings，以及 tripEarnings、tips、matchedTips、bonuses、guarantees、fines、finesRefunds、behaviorPenalties 和 other 的拆分。周期交易另含 jobId、tripId、location、amount 和 vertical。

司机钱包与现金限额如何工作？

钱包现金状态调用返回 walletBalance 与手头现金（cashBalanceAmount），以及 warningCashLimit 和 blockingCashLimit。司机可以从收入向钱包充值，或提现到已验证的银行 IBAN。

哪些任务端点驱动进行中的行程？

订单在 POST /v1/dispatch/offers/acknowledge 确认，步骤（到达、接驾、送达）在 POST /v1/dispatch/jobs/{jobUid}/steps/{stepUid}/complete 打点，现金收款在 POST /v1/dispatch/jobs/{jobUid}/cash-confirm 确认。车费回执从 GET /v1/trips/{bookingId}/fare-breakdown 加载。

Careem Captain 是银行应用吗？

不是——它是打车司机应用。它仍然携带钱包、现金余额与提现方式数据，因为司机收取现金，并通过同一产品提现行程收入。

与 Careem Captain 相似的应用

Uber Driver — Uber 自 2020 年收购 Careem 后，仍在阿联酋并行运营自有品牌的司机端与乘客端应用。
Bolt — Bolt 于 2024 年 12 月进入阿联酋网约车市场，以预估动态计价面向注重价格的乘客。
Yango — 由 Yandex 支持的 Yango 于 2022 年 9 月进入迪拜（其首个海湾市场），采用固定预估价并使用自有地图导航。
inDrive — inDrive 由乘客为行程出价、司机接受、拒绝或还价，这一模式在迪拜有别于计价器或动态加价应用。
Jeeny — Jeeny 是沙特阿拉伯的即时出行平台，提供司机端接单与配送，作为 Careem 在当地的替代选择。
Kaiian — Kaiian 是 2016 年在沙特创立的出行平台，常被列为该国王国市场上 Careem 的网约车替代之一。

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

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

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

获取报价

Careem Captain 数据 API：钱包、收入与订单

应用截图

API 端点一览

司机钱包与现金状态

按类型聚合收入

按周期列出收入交易

未核销的收入交易

提现支付方式

提现收入

从收入向钱包充值

确认订单邀约

标记任务步骤完成

确认现金已收

订单车费明细

司机接单率

绩效报告概览

班次出勤

去哪接单推荐

司机资料

数据类别

数据使用场景与案例

司机提现对账

手头现金风险监控

订单质量与运力热力图

行程级车费审计

常见问题

与 Careem Captain 相似的应用

更多出行类应用

Australia Post

Borzo: Courier Delivery App

Delhivery: Courier App

Dostavista — работа курьером

相关主题

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

Careem Captain 数据 API：钱包、收入与订单

应用截图

API 端点一览

司机钱包与现金状态

按类型聚合收入

按周期列出收入交易

未核销的收入交易

提现支付方式

提现收入

从收入向钱包充值

确认订单邀约

标记任务步骤完成

确认现金已收

订单车费明细

司机接单率

绩效报告概览

班次出勤

去哪接单推荐

司机资料

数据类别

数据使用场景与案例

司机提现对账

手头现金风险监控

订单质量与运力热力图

行程级车费审计

常见问题

相关应用

与 Careem Captain 相似的应用

更多出行类应用

Australia Post

Borzo: Courier Delivery App

Delhivery: Courier App

Dostavista — работа курьером

相关主题

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