openData StudioEnglish
iFood para Entregadores 图标

iFood para Entregadores——骑手财务数据 API

iFood Delivery de Comida e Mercado · 外卖

在 Google Play 中打开

iFood para Entregadores 是 iFood Delivery de Comida e Mercado 推出的骑手应用——这家公司运营着巴西最大的餐饮与超市外卖网络，平台的配送员在这里打理与收入有关的一切。骑手在自己的手机上用密码、一次性验证码或生物识别登录，随后在每周收入页面查看任意日期区间内按单累计的收入总额与逐日明细；「Meus Repasses」页面列出每一笔合并打款，可按周期和付款类型筛选，点开即可看到这笔打款到手多少、扣了多少手续费、何时结算。钱包页面显示可用余额与待结算余额，以及接收打款的巴西本地银行账户；提前收款（antecipação）页面则让骑手把待结算的应收款提前兑付，并写明手续费、可兑付的最低与最高金额、兑付频率，以及当日和当月还剩几次可申请。该应用面向巴西发布，服务为 iFood 运送餐厅与超市订单的配送员；在争夺骑手接单时间上，它的对手包括 Rappi 的 Soy Rappi、滴滴于 2025 年在巴西重新推出的 99Food，以及同年进入巴西市场的美团旗下 Keeta，而 Loggi Entregador、Lalamove 等包裹配送应用也常被骑手与它同时使用。

按单计费条目是骑手账本的起点：每完成一单 iFood 配送就记下一条，在任意请求的日期区间内汇总为 weeklyAmount 总额，以及按日给出 date 与 amount 的 weeklyEarnings 序列。已结算的钱随后以合并打款记录呈现——每条带有 id、结算周期 period、paymentDate 与 paymentTime、付款类型 paymentType（如按周）、状态 status（如已支付）、打款金额 amount 以及扣除的 feeAmount——按周期以 summary 汇总加分页 data 列表返回，也可逐笔读取单笔详情。

与这本账并列的是骑手钱包：包含可用与待结算金额的 balance，以及已登记的巴西收款账户——bankCode、bankName、branchNumber、accountNumber 及其校验位 accountDigit、accountType，还有以脱敏形式返回的账户持有人证件号 ownerDocument。提前收款一侧补上应收款提前兑付计划：计划 name、收取的 feeAmount、可提前兑付的 minAmount 与 maxAmount、paymentFrequency，以及记录每日与每月申请额度的 requested 与 available 计数。登录时签发的 driverId 与 userUuid 把上述每条记录归属到具体骑手，因此打款、收入、余额与提前兑付可以按骑手逐一对齐。

这本骑手财务账支撑着三类产品。记账工具每晚拉取打款历史与单笔明细，把 paymentDate、amount 和 feeAmount 与银行流水逐笔核对，让骑手的账目自动轧平；车队运营方汇总旗下骑手的周金额、计费条目与每日明细，用来排名产能并预测当周的现金支出；信贷产品读取提前兑付计划的手续费、额度上下限与 paymentFrequency，结合钱包 balance，为骑手预审应收款提前到账的额度。openData Studio 把这些 iFood 骑手财务数据变成可调用的开放数据，让对账、收入看板与提前收款类集成可以直接基于它构建。

应用截图

  • iFood para Entregadores 应用截图 1
  • iFood para Entregadores 应用截图 2
  • iFood para Entregadores 应用截图 3
  • iFood para Entregadores 应用截图 4
  • iFood para Entregadores 应用截图 5
  • iFood para Entregadores 应用截图 6
  • iFood para Entregadores 应用截图 7

API 端点一览

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

  • OAuth2 骑手令牌签发

    POST /v1/identity/session openfinance

    认证骑手身份（密码 / 验证码 / 生物识别 / 刷新令牌等授权方式），返回后续调用所需的 Bearer 令牌。

    认证方式： 无（用于签发令牌）。表单编码请求体；设备与安装标识请求头用于标识骑手的手机。

    • accessToken
    • tokenType
    • refreshToken
    • expiresIn
    • userUuid
    • tenant
    • driverId
    • challengeType
    • factors
    POST /v1/identity/session HTTP/1.1
Content-Type: application/x-www-form-urlencoded
X-Device-Id: 3f2b8c1d-9a1e-4c2b
X-Installation-Id: 7a91f0e2-55c1

application=driver-app&username=11987654321&password=******
    {
  "accessToken": "eyJhbGciOi...",
  "tokenType": "Bearer",
  "refreshToken": "d8f1c2...",
  "expiresIn": 3600,
  "userUuid": "9b0e12f4-...",
  "tenant": "IFood",
  "driverId": "a41c9e02-..."
}

  • 查询历史提现记录

    GET /v1/payouts/history openfinance

    按周期返回骑手的汇总提现历史（汇总 + 明细列表），含付款方式与状态。

    认证方式： 来自 /v1/identity/session 的 Bearer accessToken

    • id
    • paymentDate
    • period
    • paymentTime
    • paymentType
    • status
    • amount
    • feeAmount
    • summary
    • data
    GET /v1/payouts/history?period=2026-08&paymentType=WEEKLY&page=0&size=20 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
    {
  "summary": {"id": "sum", "paymentDate": "2026-08-31", "paymentType": "WEEKLY", "status": "PAID", "amount": 128540, "feeAmount": 0},
  "data": [
    {"id": "pay_01H...", "paymentDate": "2026-08-24", "period": {"start": "2026-08-18", "end": "2026-08-24"}, "paymentTime": "14:02:11", "paymentType": "WEEKLY", "status": "PAID", "amount": 64210, "feeAmount": 0}
  ]
}

  • 查询提现详情

    GET /v1/payouts/{payoutId} openfinance

    读取单笔提现的完整明细（金额、手续费、结算周期、状态），用于提现详情页。

    认证方式： 来自 /v1/identity/session 的 Bearer accessToken

    • id
    • paymentDate
    • period
    • paymentTime
    • paymentType
    • status
    • amount
    • feeAmount
    GET /v1/payouts/pay_01H... HTTP/1.1
Authorization: Bearer eyJhbGciOi...
    {
  "id": "pay_01H...",
  "paymentDate": "2026-08-24",
  "period": {"start": "2026-08-18", "end": "2026-08-24"},
  "paymentTime": "14:02:11",
  "paymentType": "WEEKLY",
  "status": "PAID",
  "amount": 64210,
  "feeAmount": 0
}

  • 查询计费收入汇总

    GET /v1/earnings/summary openfinance

    把骑手每笔配送的计费条目按日期区间聚合成收入总额。

    认证方式： 来自 /v1/identity/session 的 Bearer accessToken

    • weeklyAmount
    • weeklyEarnings
    • amount
    • date
    GET /v1/earnings/summary?startDate=2026-08-01&endDate=2026-08-31 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
    {
  "weeklyAmount": 128540,
  "weeklyEarnings": [
    {"date": "2026-08-24", "amount": 64210, "entriesCount": 31}
  ]
}

  • 查询余额与支付方式

    GET /v1/wallet openfinance

    同时读取骑手当前余额 / 支付列表，以及已绑定的巴西本地银行账户。

    认证方式： 来自 /v1/identity/session 的 Bearer accessToken

    • balance
    • accountType
    • accountNumber
    • accountDigit
    • branchNumber
    • bankCode
    • bankName
    • ownerDocument
    GET /v1/wallet HTTP/1.1
Authorization: Bearer eyJhbGciOi...
    {
  "balance": {"available": 81240, "pending": 17300},
  "bankAccount": {"accountType": "CHECKING", "accountNumber": "00123456", "accountDigit": "7", "branchNumber": "0001", "bankCode": "341", "bankName": "Itaú", "ownerDocument": "123.***.***-45"}
}

  • 查询应收款提前兑付计划

    GET /v1/advance-pay/plan openfinance

    返回骑手的提前收款（应收款兑付）计划：费率、单笔最小 / 最大金额与可兑付额度。

    认证方式： 来自 /v1/identity/session 的 Bearer accessToken

    • name
    • feeAmount
    • minAmount
    • maxAmount
    • paymentFrequency
    • requested
    • available
    GET /v1/advance-pay/plan HTTP/1.1
Authorization: Bearer eyJhbGciOi...
    {
  "name": "Antecipação Semanal",
  "feeAmount": 199,
  "minAmount": 5000,
  "maxAmount": 250000,
  "paymentFrequency": "WEEKLY",
  "requested": {"count": 1},
  "available": {"count": 3}
}

数据类别

  • 提现
  • 收入
  • 余额
  • 支付
  • 银行账户
  • 应收款提前兑付
  • 认证令牌

数据使用场景与案例

  • 零工骑手薪资对账

    记账工具每晚拉取合并的打款历史与单笔打款明细，把打款日期、金额、手续费与银行流水逐笔核对，让骑手的账目自动轧平。

  • 车队收入看板

    车队运营方聚合旗下骑手的每周收入汇总——周金额、账单条目与每日明细——用于排名产能、预测每周现金支出。

  • 应收款提前变现

    信贷产品读取提前回款计划（手续费、最低/最高金额、回款频率）并结合钱包余额，为骑手预审应收款提前变现额度。

常见问题

iFood 骑手端使用什么数据 API？

应用调用一套私有 HTTPS API：登录走 POST /v1/identity/session（OAuth2 密码 / 验证码 / 生物识别 / 刷新令牌），登录后通过 GET /v1/payouts/history、GET /v1/earnings/summary 等端点以 JSON 返回收入与结算数据。

该 API 如何认证？

骑手先通过 POST /v1/identity/session 获取 Bearer 访问令牌（支持密码、短信验证码、生物识别与刷新令牌多种授权方式），之后所有财务端点都凭该令牌访问；没有公开的开发者密钥。

能否程序化读取骑手收入？

应用自身的收入界面由 GET /v1/earnings/summary 驱动，按日期区间聚合每笔配送的计费条目；提现历史则由 GET /v1/payouts/history 返回。两者都是需要会话令牌的私有端点，而非公开 API。

应收款提前兑付端点是什么？

GET /v1/advance-pay/plan 返回骑手的提前收款计划：手续费率、单笔最小 / 最大金额与可提前兑付的应收余额，对应应用内的提前收款界面。

与 iFood para Entregadores 相似的应用

  • Soy Rappi — Soy Rappi 是 Rappi 的配送员应用，也是 iFood 在巴西最主要的同城配送竞争平台；除餐饮外还承接药店、超市与便利店订单。
  • Loggi Entregador — Loggi 是巴西的物流平台，其配送员应用主要承接电商包裹与文件配送而非餐饮外卖，骑手常与外卖平台同时接单。
  • Lalamove Driver — Lalamove 是一家源自香港、在巴西运营的配送应用，按车型派单（从摩托车到货车），采用固定费用而非按单抽成。
  • 99Food — 99Food 是滴滴于 2025 年在巴西重新推出的外卖服务，投入 10 亿雷亚尔，在 99 应用生态内招募配送员，直接对标 iFood。
  • Keeta — Keeta 是中国外卖巨头美团的国际配送品牌，2025 年进入巴西并开始在圣保罗招募配送员，成为 iFood 的新竞争者。
  • aiqfome — aiqfome 是 Magalu 集团旗下的巴西外卖平台，主要覆盖中小型内陆城市，为大城市以外的配送员提供另一个接单渠道。

更多外卖类应用

相关主题

  • iFood 骑手 API
  • ifood entregador api
  • iFood 提现端点
  • 骑手收入 API
  • iFood 银行账户接口
  • 应收款提前兑付
  • 骑手财务数据 API

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

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

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

获取报价