iFood Benefícios 数据 API：PAT 余额、卡片与 PIX 字段

iFood Delivery de Comida e Mercado · 支付

iFood Benefícios 是巴西餐饮配送企业 iFood Delivery de Comida e Mercado 推出的员工福利钱包，面向使用雇主发放的 PAT 餐饮券、食品券和出行额度的员工，消费载体是带 Elo 标识的 iFood Benefícios 卡。用户通过 CPF（巴西个人税号）登录，并可选择设备生物识别；首页显示 Refeição（餐饮）、Alimentação（食品）和 Mobilidade（出行）钱包余额，提供商户刷卡及 iFood 应用内订单的消费明细，还可查看能够添加到 Google Pay 或 Apple Pay 的 Elo 虚拟卡号、实体卡制卡及承运配送进度，以及支持该卡的附近餐厅地图。在同一登录会话中，持卡人还可以开通 iFood Pago 数字账户、登记 PIX 收款标识、支付 boleto 账单、合并钱包余额、申请附加卡、选择雇主 PAT 福利分配比例，在充值后解锁 Clube iFood 权益，并完成证件核验与活体身份验证。该应用面向巴西市场发行，Play 包名为 br.com.ifood.benefits，iOS 列表 ID 为 1550867930，与 Alelo、Pluxee Brasil、Ticket（Edenred Brasil）、VR Benefícios、Caju 和 Flash Benefícios 同处 PAT 福利钱包市场。

PAT 钱包记录通过 walletId 和 benefitType 区分雇主发放的餐饮、食品和出行额度，示例类别分别为 REFEICAO、ALIMENTACAO 和 MOBILIDADE。余额快照将 availableBalance、blockedBalance 与取值为 BRL 的 currency、充值金额 lastRechargeAmount 及充值时间 lastRechargeAt 配对。消费明细另含 transactionId、merchantName、mcc、amount 和 occurredAt；取值为 APPROVED、REVERSED 或 CANCELED 的 status 标明交易结果，POS 或 IFOOD_APP channel 则区分餐厅刷卡与应用内订单。

Elo 卡片记录包含 cardId、panLast4、formFactor、有效期和状态，以及独立的 googlePayTokenized 与 applePayTokenized 标记。虚拟卡示例还包含 linkedCardId、cvvSet 和 createdAt。配送记录以 trackingStatus 表示 IN_PRODUCTION、IN_TRANSIT、DELIVERED、ASTRAY 或 RETURNED 状态，并提供 carrier、estimatedDeliveryDate 和 remainingAttempts。卡片运营团队可据此设计视图，将卡片形态、数字钱包绑定情况与实体卡配送状态分别呈现。

PIX 收款标识记录包含 pixKeyType、claimId 和 portabilityId；付款示例包含 endToEndId、dailyLimitRemaining、receiptId 及 rejectReason，其中拒绝原因包括 INSUFFICIENT_BALANCE。iFood Pago 账户快照补充取值为 PENDING_KYC、ACTIVE、REJECTED 或 CLOSED 的 accountStatus，以及 pendingDocuments 和 pendingPersonalData。boleto 记录包含 typedLine、payeeName、dueDate 和付款回执标识。资金管理工具的设计者可用这些独立字段区分账户是否就绪、付款结果与回执对账。

商户受理记录将 latitude、longitude 和 distanceMeters 与 acceptsRefeicao、acceptsAlimentacao 结合；PAT 福利分配记录则提供 mealPercent、foodPercent、effectiveMonth 和 distributionAvailable。薪酬团队可据此设计充值与福利分配的核对流程，费用管理团队可分析商户类别和消费渠道构成，外勤团队可绘制受理网络地图。本页端点说明与示例用于展示数据结构，并非 iFood 官方支持的开发者 API；openData Studio 将应用数据转化为可调用的开放数据，支持这些集成工作流。

应用截图

API 端点一览

请求/响应示例为依据应用界面重构的示意示例，并非实时抓包。

列出 PAT 钱包与余额

GET /v1/pat/purses openbanking

返回当前登录员工的全部 PAT 钱包，包括 Refeição（餐饮）、Alimentação（食品）和 Mobilidade（出行），提供以 BRL 计价的可用余额、冻结余额及雇主最近一次充值信息，用于首页余额卡片。

认证方式：通过 CPF 登录后使用 Bearer accessToken

walletId
benefitType
productName
availableBalance
blockedBalance
currency
lastRechargeAmount
lastRechargeAt
hiddenBalance

GET /v1/pat/purses HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "wallets": [
    {
      "walletId": "wal_refeicao_4419",
      "benefitType": "REFEICAO",
      "productName": "iFood Benefícios Refeição",
      "availableBalance": 642.80,
      "blockedBalance": 0,
      "currency": "BRL",
      "lastRechargeAmount": 700.00,
      "lastRechargeAt": "2026-10-01T08:12:00Z",
      "hiddenBalance": false
    },
    {
      "walletId": "wal_alimentacao_4419",
      "benefitType": "ALIMENTACAO",
      "productName": "iFood Benefícios Alimentação",
      "availableBalance": 318.45,
      "blockedBalance": 12.00,
      "currency": "BRL",
      "lastRechargeAmount": 400.00,
      "lastRechargeAt": "2026-10-01T08:12:00Z",
      "hiddenBalance": false
    },
    {
      "walletId": "wal_mobilidade_4419",
      "benefitType": "MOBILIDADE",
      "productName": "iFood Benefícios Mobilidade",
      "availableBalance": 95.00,
      "blockedBalance": 0,
      "currency": "BRL",
      "lastRechargeAmount": 150.00,
      "lastRechargeAt": "2026-09-15T09:00:00Z",
      "hiddenBalance": false
    }
  ]
}

钱包消费明细

GET /v1/pat/purses/{walletId}/transactions openbanking

分页返回指定 PAT 钱包的消费明细，包含商户、MCC、金额、APPROVED、REVERSED、CANCELED 状态及 POS 与 iFood 应用内渠道区分，用于消费明细标签页。

认证方式：通过 CPF 登录后使用 Bearer accessToken

walletId
page
pageSize
transactionId
merchantName
mcc
amount
currency
benefitType
status
channel
occurredAt

GET /v1/pat/purses/wal_refeicao_4419/transactions?from=2026-10-01&to=2026-10-23&page=1 HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "walletId": "wal_refeicao_4419",
  "page": 1,
  "pageSize": 20,
  "transactions": [
    {
      "transactionId": "txn_9f21c4",
      "merchantName": "Padaria Central",
      "mcc": "5812",
      "amount": 32.90,
      "currency": "BRL",
      "benefitType": "REFEICAO",
      "status": "APPROVED",
      "channel": "POS",
      "occurredAt": "2026-10-22T12:14:03Z"
    },
    {
      "transactionId": "txn_9f21aa",
      "merchantName": "iFood Pedido",
      "mcc": "5814",
      "amount": 48.50,
      "currency": "BRL",
      "benefitType": "REFEICAO",
      "status": "REVERSED",
      "channel": "IFOOD_APP",
      "occurredAt": "2026-10-21T19:02:11Z"
    }
  ]
}

列出 Elo 实体卡与虚拟卡

GET /v1/elo-cards openfinance

列出员工名下所有 Elo 实体和虚拟 iFood Benefícios 卡，包含卡号尾号、卡片形态、数字钱包令牌化标记及状态，用于卡片轮播和 Google Pay、Apple Pay 功能卡片。

认证方式：通过 CPF 登录后使用 Bearer accessToken

cardId
panLast4
brand
formFactor
status
googlePayTokenized
applePayTokenized
expiryMonth
expiryYear
holderName

GET /v1/elo-cards HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "cards": [
    {
      "cardId": "crd_ifb_4419",
      "panLast4": "4419",
      "brand": "ELO",
      "formFactor": "PHYSICAL",
      "status": "ACTIVE",
      "googlePayTokenized": true,
      "applePayTokenized": false,
      "expiryMonth": 8,
      "expiryYear": 2028,
      "holderName": "ANA SOUZA"
    },
    {
      "cardId": "crd_ifb_vc_8821",
      "panLast4": "8821",
      "brand": "ELO",
      "formFactor": "VIRTUAL",
      "status": "ACTIVE",
      "googlePayTokenized": false,
      "applePayTokenized": false,
      "expiryMonth": 8,
      "expiryYear": 2028,
      "holderName": "ANA SOUZA"
    }
  ]
}

签发 Elo 虚拟卡

POST /v1/elo-cards/virtual openfinance

基于员工的实体卡签发 Elo 虚拟卡号，使实体卡仍在制卡或被冻结时，用户也能进行 iFood 线上订餐和应用内结账。

认证方式：通过 CPF 登录后使用 Bearer accessToken

linkedCardId
label
cardId
panLast4
expiryMonth
expiryYear
cvvSet
status
formFactor
createdAt

POST /v1/elo-cards/virtual HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "linkedCardId": "crd_ifb_4419",
  "label": "Pedido iFood"
}

{
  "cardId": "crd_ifb_vc_8821",
  "linkedCardId": "crd_ifb_4419",
  "panLast4": "8821",
  "expiryMonth": 8,
  "expiryYear": 2028,
  "cvvSet": true,
  "status": "ACTIVE",
  "formFactor": "VIRTUAL",
  "createdAt": "2026-10-23T11:04:00Z"
}

卡片配送跟踪
GET /v1/elo-cards/{cardId}/delivery opendata
返回新签发实体卡从制卡到送达的进度，包括 IN_PRODUCTION、IN_TRANSIT、DELIVERED、ASTRAY、RETURNED 状态，以及承运商和剩余投递次数。
认证方式：通过 CPF 登录后使用 Bearer accessToken
- cardId
- trackingStatus
- carrier
- trackingCode
- estimatedDeliveryDate
- deliveryAttempt
- remainingAttempts
- lastEventAt
```
GET /v1/elo-cards/crd_ifb_4419/delivery HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "cardId": "crd_ifb_4419",
  "trackingStatus": "IN_TRANSIT",
  "carrier": "LOGGI",
  "trackingCode": "IFB4419BR",
  "estimatedDeliveryDate": "2026-10-28",
  "deliveryAttempt": 1,
  "remainingAttempts": 2,
  "lastEventAt": "2026-10-23T09:41:00Z"
}
```

已登记的 PIX 收款标识

GET /v1/pix/keys openfinance

列出当前 iFood Pago 或福利账户会话绑定的 PIX 收款标识，包括 CPF、电子邮箱、手机号和 EVP，并提供归属申领与可携转状态，用于收款标识管理页面。

认证方式：通过 CPF 登录后使用 Bearer accessToken

pixKey
pixKeyType
status
claimId
portabilityId
createdAt
maxKeys

GET /v1/pix/keys HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "keys": [
    {
      "pixKey": "12345678901",
      "pixKeyType": "CPF",
      "status": "ACTIVE",
      "claimId": null,
      "portabilityId": null,
      "createdAt": "2026-08-12T14:00:00Z"
    },
    {
      "pixKey": "[email protected]",
      "pixKeyType": "EMAIL",
      "status": "CLAIM_PENDING",
      "claimId": "clm_77ab",
      "portabilityId": null,
      "createdAt": "2026-10-20T10:22:00Z"
    }
  ],
  "maxKeys": 5
}

PIX 转出付款

POST /v1/pix/payments openfinance

从 PAT 或数字账户钱包提交 PIX 转出付款，返回 endToEndId、剩余额度，以及余额不足或超出限额等拒绝原因。

认证方式：通过 CPF 登录后使用 Bearer accessToken

debitWalletId
pixKey
pixKeyType
amount
currency
description
paymentId
endToEndId
status
rejectReason
dailyLimitRemaining
receiptId

POST /v1/pix/payments HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "debitWalletId": "wal_refeicao_4419",
  "pixKey": "98765432100",
  "pixKeyType": "CPF",
  "amount": 80.00,
  "currency": "BRL",
  "description": "Repasse almoço"
}

{
  "paymentId": "pix_3c91",
  "endToEndId": "E12345678202610231104abc",
  "debitWalletId": "wal_refeicao_4419",
  "amount": 80.00,
  "currency": "BRL",
  "status": "REJECTED",
  "rejectReason": "INSUFFICIENT_BALANCE",
  "dailyLimitRemaining": 250.00,
  "receiptId": null
}

附近支持福利卡的餐厅

GET /v1/merchants/nearby opendata

返回员工附近 PAT 受理网络商户的地理位置，并分别标记是否支持 Refeição（餐饮）或 Alimentação（食品）福利，用于餐厅标记地图。

认证方式：通过 CPF 登录后使用 Bearer accessToken

merchantId
name
category
latitude
longitude
distanceMeters
acceptsRefeicao
acceptsAlimentacao
pinCount

GET /v1/merchants/nearby?lat=-23.5505&lng=-46.6333&radiusMeters=1500&benefitType=REFEICAO HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "merchants": [
    {
      "merchantId": "mct_padaria_central",
      "name": "Padaria Central",
      "category": "RESTAURANT",
      "latitude": -23.5512,
      "longitude": -46.6341,
      "distanceMeters": 180,
      "acceptsRefeicao": true,
      "acceptsAlimentacao": false,
      "pinCount": 1
    }
  ]
}

PAT 福利分配选择
GET /v1/pat/elections openfinance
读取员工在当前雇主处选择的 PAT 餐饮与食品福利分配比例，并返回当前是否开放新一轮分配调整。
认证方式：通过 CPF 登录后使用 Bearer accessToken
- electionId
- employerId
- employerName
- mealPercent
- foodPercent
- status
- effectiveMonth
- distributionAvailable
```
GET /v1/pat/elections HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "electionId": "pat_2026_10",
  "employerId": "emp_acme_br",
  "employerName": "ACME Alimentos Ltda",
  "mealPercent": 60,
  "foodPercent": 40,
  "status": "CONFIRMED",
  "effectiveMonth": "2026-11",
  "distributionAvailable": true
}
```
iFood Pago 数字账户
GET /v1/digital-account openbanking
返回 iFood Pago 数字账户快照，包含 PENDING_KYC、ACTIVE、REJECTED、CLOSED 等状态、分行与账号信息，以及是否仍需提交证件或补充个人资料。
认证方式：通过 CPF 登录后使用 Bearer accessToken
- accountId
- accountStatus
- branch
- accountNumber
- availableBalance
- currency
- pendingDocuments
- pendingPersonalData
```
GET /v1/digital-account HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "accountId": "acc_pago_0091",
  "accountStatus": "PENDING_KYC",
  "branch": "0001",
  "accountNumber": "123456-7",
  "availableBalance": 0,
  "currency": "BRL",
  "pendingDocuments": true,
  "pendingPersonalData": true
}
```

使用钱包支付 boleto 账单

POST /v1/bills/pay openfinance

校验 boleto 账单的数字付款码，并从选定的 PAT 或数字账户钱包付款，返回到期日、收款方和回执 ID，用于账单列表。

认证方式：通过 CPF 登录后使用 Bearer accessToken

typedLine
debitWalletId
billId
amount
dueDate
payeeName
status
receiptId

POST /v1/bills/pay HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "typedLine": "23793.38128 60000.000003 00000.000400 1 84440000008000",
  "debitWalletId": "wal_alimentacao_4419"
}

{
  "billId": "bol_4411",
  "typedLine": "23793.38128 60000.000003 00000.000400 1 84440000008000",
  "amount": 80.00,
  "dueDate": "2026-10-30",
  "payeeName": "Companhia de Energia",
  "debitWalletId": "wal_alimentacao_4419",
  "status": "PAID",
  "receiptId": "rcpt_bol_4411"
}

数据类别

卡片余额
交易记录
虚拟卡
卡片配送
PIX 收款标识
PIX 付款
商户受理网络
PAT 福利分配选择
数字账户
boleto 账单付款

数据使用场景与案例

薪酬福利 PAT 对账
人力资源自动化工具在雇主每次充值后，按 benefitType（REFEICAO、ALIMENTACAO、MOBILIDADE）读取 availableBalance 与 lastRechargeAmount，并核对 PAT 福利分配选择中下一 effectiveMonth 的 mealPercent 和 foodPercent。
餐饮消费分析
费用管理工具从消费明细中获取 transactionId、merchantName、mcc、amount 以及 APPROVED、REVERSED 状态，按 POS 与 IFOOD_APP 渠道区分消费，无需抓取消费明细页面。
PIX 转出与 boleto 账单处理
资金管理团队关注 pixKey 的归属申领和可携转状态，在钱包余额足够时提交 PIX 付款或 boleto 账单付款，并跟踪 endToEndId、dailyLimitRemaining、typedLine 与 receiptId。
商户受理网络与实体卡运营
外勤团队利用 acceptsRefeicao、distanceMeters 等信息绘制附近商户地图；卡片运营团队跟踪 trackingStatus 和 remainingAttempts，在 Elo 实体卡仍处于 IN_TRANSIT 状态时，用 formFactor 为 VIRTUAL 的虚拟卡号满足消费需求。

常见问题

这里列出了哪些福利钱包与充值字段？

示例涵盖 REFEICAO（餐饮）、ALIMENTACAO（食品）和 MOBILIDADE（出行），通过 benefitType 和 walletId 区分。availableBalance、blockedBalance 和 lastRechargeAmount 是 BRL 金额，lastRechargeAt 是充值时间。PAT 福利分配记录另外提供 mealPercent、foodPercent 和 effectiveMonth，供对账方案设计参考。

数据是否包含 PIX、Elo 卡片和 iFood Pago 账户？

包含。PIX 示例以 pixKeyType、claimId 和 portabilityId 描述收款标识管理，以 endToEndId、dailyLimitRemaining 和 rejectReason 描述付款。Elo 卡片记录包含 formFactor 以及 Google Pay、Apple Pay 的令牌化标记。数字账户快照提供 accountStatus、pendingDocuments 和 pendingPersonalData，boleto 记录则包含 typedLine 和 receiptId。

哪些字段可用于设计餐厅受理地图？

附近商户示例包含 merchantId、name、latitude、longitude 和 distanceMeters。acceptsRefeicao 与 acceptsAlimentacao 分别标明餐饮福利和食品福利的受理情况，便于地图设计者区分商户位置与可接受的福利类型。

这是 iFood 官方支持的开发者 API 吗？

不是。本页根据应用功能提供示例端点说明与字段，供集成方案设计参考，并非 iFood 官方支持的开发者 API。文档示例注明，认证使用 CPF 登录后取得的 Bearer accessToken。

与 iFood Benefícios 相似的应用

Meu Alelo — Meu Alelo 是 Alelo 面向巴西职工的应用，覆盖 PAT 食品券与餐券以及出行福利，用来查消费明细、修改卡片密码，并在受理商户用二维码付款。
Pluxee Brasil — Pluxee Brasil 是 Pluxee 的 PAT 食品券与餐券持卡人应用，覆盖超市消费、餐厅和外卖 App 的 Refeição，以及一张最多七个钱包的 Multibenefícios 卡。
Ticket — Ticket 是 Edenred 在巴西的员工福利品牌；官方应用用来查询 Ticket Alimentação、Restaurante、Flex、Transporte 和 Mobilidade 卡的余额与账单。
SuperApp VR — SuperApp VR 是 VR Benefícios 的职工应用，覆盖符合 PAT 的餐券与食品券，以及 Multi、居家办公和用车津贴余额，并支持在应用内靠近支付、无需实体卡。
Flash | Benefícios e Despesas — Flash 是巴西的多福利卡及职工应用，把企业福利、PAT 餐食钱包、交通券和报销管理放在一张 Flash 卡上。
Caju — Caju 是巴西的福利与支出平台，把 PAT、CLT 与弹性福利品类（含餐补、食品、出行、交通券和居家办公）放在一张 Visa 受理卡上，并配职工应用。
Swile Brasil — Swile Brasil 是符合 PAT 与 CLT 的多福利 Mastercard，把餐、食、健康、出行、居家办公、教育、燃油和奖励钱包放在一张卡上，职工可在应用里查看实时余额并写入 Apple Pay / Google Pay。

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

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

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

获取报价

iFood Benefícios 数据 API：PAT 余额、卡片与 PIX 字段

应用截图

API 端点一览

列出 PAT 钱包与余额

钱包消费明细

列出 Elo 实体卡与虚拟卡

签发 Elo 虚拟卡

卡片配送跟踪

已登记的 PIX 收款标识

PIX 转出付款

附近支持福利卡的餐厅

PAT 福利分配选择

iFood Pago 数字账户

使用钱包支付 boleto 账单

数据类别

数据使用场景与案例

薪酬福利 PAT 对账

餐饮消费分析

PIX 转出与 boleto 账单处理

商户受理网络与实体卡运营

常见问题

与 iFood Benefícios 相似的应用

更多支付类应用

BharatPe for Business

BukuWarung Apps for MSMEs

C3Pay

Cartão Mais!

相关主题

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

iFood Benefícios 数据 API：PAT 余额、卡片与 PIX 字段

应用截图

API 端点一览

列出 PAT 钱包与余额

钱包消费明细

列出 Elo 实体卡与虚拟卡

签发 Elo 虚拟卡

卡片配送跟踪

已登记的 PIX 收款标识

PIX 转出付款

附近支持福利卡的餐厅

PAT 福利分配选择

iFood Pago 数字账户

使用钱包支付 boleto 账单

数据类别

数据使用场景与案例

薪酬福利 PAT 对账

餐饮消费分析

PIX 转出与 boleto 账单处理

商户受理网络与实体卡运营

常见问题

相关应用

与 iFood Benefícios 相似的应用

更多支付类应用

BharatPe for Business

BukuWarung Apps for MSMEs

C3Pay

Cartão Mais!

相关主题

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