Ticket Edenred 巴西 PAT 卡、PIX 与商户接口

Ticket Serviços S/A · 支付

Ticket 是 Ticket Serviços S/A 面向员工的福利钱包。该公司是 Edenred 在巴西的发卡机构，发放受 PAT 约束的餐券与食品券，以及文化、出行、健康、弹性、礼品和燃油卡。用户凭 CPF 经 Azure AD B2C 登录后，首页钱包会列出该员工持有的每一张卡——Ticket Alimentação、Ticket Restaurante、Ticket Flex、Ticket Super Flex、Ticket Car、Ticket Cultura、Ticket Saúde、Ticket Transporte、Ticket Plus 以及电子礼品卡——并提供余额（saldo）、流水（extrato）、PIN/CVV、挂失冻结、卡片物流追踪，以及 Google Pay / Apple Pay 开卡。持卡人可用这些余额发起 PIX、做 TED 式贷记转账、在 Flex 钱袋之间拆分餐与食额度、购买 Cuponeria 电子礼券、缴 boleto、NFC 闪付，并在受理商户地图上查找网点（含 Rappi 与 Cielo Pay 合作方）。应用面向巴西，与 Alelo、Pluxee Brasil、VR Benefícios、Caju 和 Flash Benefícios 争夺同一批 PAT 钱包。

餐券钱袋合计落在 totalAvailableAmount，旁边是每张卡的 cardBalance，cardProductType 用来区分 Ticket Alimentação、Ticket Restaurante、Flex、Car、Cultura 与 Saúde。同一会话分页返回 extrato 上的 TransactionAmount 与 MerchantName，列出已登记的 pixKey / pixKeyType，并在 PIX 提现后给出 endToEndId。

受理网络行带有 cnpj、fantasyName 与 partnerProduct；Google Pay 状态在 isTokenized 与 walletDeviceTokenId。薪酬对账、PIX 策略机器人与覆盖地图会用到这些字段；openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

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

列出钱包卡片

GET /v1/benefit-cards openfinance

返回登录受益人名下全部 Ticket 实体卡与电子卡：产品类型（Alimentação、Restaurante、Flex、Car）、卡号尾号、昵称与是否已写入钱包，供首页钱包轮播使用。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

cardId
cardLastNumbers
lastNumbers
cardBin
cardType
cardProductType
cardProductId
nickName
cardNickName
cardHolder
brand
status
isTokenized
DigitalCard

GET /v1/benefit-cards HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "cards": [
    {
      "cardId": "crd_88100214",
      "cardLastNumbers": "4419",
      "lastNumbers": "4419",
      "cardBin": "650485",
      "cardType": "TAE",
      "cardProductType": "ALIMENTACAO",
      "cardProductId": "TAE",
      "nickName": "Alimentação empresa",
      "cardNickName": "Alimentação empresa",
      "cardHolder": "ANA SOUZA",
      "brand": "Elo",
      "status": "ACTIVE",
      "isTokenized": false,
      "DigitalCard": true
    }
  ]
}

卡片余额

GET /v1/benefit-cards/{cardId}/balance openbanking

读取一张卡上的当前 PAT 钱袋：totalAvailableAmount、分线路的 benefitBalance 以及冻结额，供余额磁贴与显示/隐藏余额开关使用。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

cardId
balance
cardBalance
benefitBalance
lineBalance
totalAvailableAmount
balances
blocked
limit

GET /v1/benefit-cards/crd_88100214/balance HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "cardId": "crd_88100214",
  "balance": 842.50,
  "cardBalance": 842.50,
  "benefitBalance": 842.50,
  "lineBalance": 842.50,
  "totalAvailableAmount": 842.50,
  "balances": [
    {
      "cardProductType": "ALIMENTACAO",
      "balance": 842.50
    }
  ],
  "blocked": 0,
  "limit": 842.50
}

卡片流水

GET /v1/benefit-cards/{cardId}/transactions openbanking

分页返回一张卡的 extrato：商户、金额、转入/转出标记与结算日，对应首页流水搜索与筛选界面。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

cardId
transactionId
transactionDate
TransactionAmount
MerchantName
description
CreditOfTransfer
DebitOfTransfer
status
settleDate
isLastPage
endDateUtc

GET /v1/benefit-cards/crd_88100214/transactions?endDateUtc=2026-10-19T23:59:59Z HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "cardId": "crd_88100214",
  "items": [
    {
      "transactionId": "txn_9f21aa",
      "transactionDate": "2026-10-18T12:41:00Z",
      "TransactionAmount": 32.90,
      "MerchantName": "Padaria Central",
      "description": "Compra alimentacao",
      "CreditOfTransfer": false,
      "DebitOfTransfer": false,
      "status": "APPROVED",
      "settleDate": "2026-10-18"
    }
  ],
  "isLastPage": false
}

卡片状态与冻结
GET /v1/benefit-cards/{cardId}/controls openfinance
返回卡片是否可用、是否被 HR/风控/安全冻结、是否锁密以及能否用于手机支付——对应挂失、解冻与重置密码界面上的标志。
认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。
- cardId
- status
- walletBlocked
- isBlockCard
- blockedPassword
- blockedRH
- blockedRisk
- blockedSecurity
- needSetPassword
- mobilePayStatus
```
GET /v1/benefit-cards/crd_88100214/controls HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>
```
```
{
  "cardId": "crd_88100214",
  "status": "ACTIVE",
  "walletBlocked": false,
  "isBlockCard": false,
  "blockedPassword": false,
  "blockedRH": false,
  "blockedRisk": false,
  "blockedSecurity": false,
  "needSetPassword": false,
  "mobilePayStatus": "ENABLED"
}
```
转账开通标志
GET /v1/cash-out/eligibility openfinance
告知当前会话是否已开通福利互转与 PIX 提现通道，并带上金额选择页使用的 pixLimit 与 pixMinValue。
认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。
- status
- pixLimit
- pixMinValue
- pixFee
- walletBlocked
```
GET /v1/cash-out/eligibility HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>
```
```
{
  "status": "ENABLED",
  "pixLimit": 500.00,
  "pixMinValue": 1.00,
  "pixFee": 0,
  "walletBlocked": false
}
```
已登记 PIX 密钥
GET /v1/cash-out/pix-keys openfinance
列出该受益人已登记的 PIX 密钥（CPF、邮箱、手机或随机键），供 PIX 金额页填写收款方。
认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。
- pixKey
- pixKeyType
- branch
- status
```
GET /v1/cash-out/pix-keys HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>
```
```
{
  "keys": [
    {
      "pixKey": "[email protected]",
      "pixKeyType": "EMAIL",
      "branch": "0001",
      "status": "ACTIVE"
    }
  ]
}
```

提交 PIX 转账

POST /v1/cash-out/pix-payments openfinance

在金额选择与可选人脸核验之后，把福利余额经 PIX 转出，返回收据页使用的 endToEndId。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id；资金类调用可能还要过一次加强验证。

cardId
pixKey
pixKeyType
amount
challengeId
transactionId
endToEndId
pixFee
status
payerName

POST /v1/cash-out/pix-payments HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>
Content-Type: application/json

{
  "cardId": "crd_88100214",
  "pixKey": "11987654321",
  "pixKeyType": "PHONE",
  "amount": 50.00,
  "challengeId": "chg_44ab"
}

{
  "transactionId": "pix_e2e_20261019",
  "endToEndId": "E60746948202610191241s0a1b2c3d4",
  "amount": 50.00,
  "pixFee": 0,
  "status": "COMPLETED",
  "payerName": "ANA SOUZA",
  "receipt": {
    "transactionId": "pix_e2e_20261019"
  }
}

PIX 回单

GET /v1/cash-out/pix-payments/{transactionId}/voucher openbanking

重新加载已完成的 PIX 回单，供分享/复制收据页使用。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

transactionId
endToEndId
amount
pixFee
payerName
transactionDate
status

GET /v1/cash-out/pix-payments/pix_e2e_20261019/voucher HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "transactionId": "pix_e2e_20261019",
  "endToEndId": "E60746948202610191241s0a1b2c3d4",
  "amount": 50.00,
  "pixFee": 0,
  "payerName": "ANA SOUZA",
  "transactionDate": "2026-10-19T12:41:00Z",
  "status": "COMPLETED"
}

贷记转账（TED / 钱袋互转）
POST /v1/purse-transfers openbanking
提交资金兑换贷记转账，用于福利钱袋互转（Ticket Restaurante ↔ Alimentação 的 Flex 拆分）以及银行 TED；返回的 transactionId 之后可用于轮询最终状态。
认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id；资金类调用可能还要过一次加强验证。
- cardId
- amount
- cardProductType
- challengeId
- transactionId
- status
- CreditOfTransfer
```
POST /v1/purse-transfers HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>
Content-Type: application/json

{
  "cardId": "crd_88100214",
  "amount": 100.00,
  "cardProductType": "RESTAURANTE",
  "challengeId": "chg_55cd"
}
```
```
{
  "transactionId": "xfer_10482",
  "status": "COMPLETED",
  "amount": 100.00,
  "CreditOfTransfer": true,
  "cardProductType": "RESTAURANTE"
}
```

受益人资料

GET /v1/beneficiaries/me/profile osint

返回登录受益人的姓名、脱敏 CPF、邮箱、手机、出生日期与母亲姓名，供资料页、联系方式更新与 MFA 登记使用。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

userId
fullName
socialName
maskedCpf
email
maskedEmail
cellPhoneNumber
birthDate
motherName

GET /v1/beneficiaries/me/profile HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "userId": "usr_10482",
  "fullName": "Ana Souza",
  "socialName": "Ana",
  "maskedCpf": "123.***.***-01",
  "email": "[email protected]",
  "maskedEmail": "a***@empresa.com.br",
  "cellPhoneNumber": "11987654321",
  "birthDate": "1992-04-17",
  "motherName": "Maria Souza"
}

受理商户网络

GET /v1/merchants/nearby opendata

按福利产品在 Ticket 受理网络（where-accept 地图）上做地理检索，返回 CNPJ、商号、坐标与距离。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

partnerId
partnerName
fantasyName
cnpj
latitude
longitude
distance
placeId
partnerLogo
partnerProduct

GET /v1/merchants/nearby?latitude=-23.5505&longitude=-46.6333&distance=5 HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "merchants": [
    {
      "partnerId": "mct_9921",
      "partnerName": "Restaurante da Esquina",
      "fantasyName": "Da Esquina",
      "cnpj": "12345678000199",
      "latitude": -23.5512,
      "longitude": -46.6341,
      "distance": 0.4,
      "placeId": "ChIJxxxxxxxx",
      "partnerLogo": "https://cdn.example.com/logos/esquina.png",
      "partnerProduct": ["RESTAURANTE", "ALIMENTACAO"]
    }
  ]
}

Cuponeria 电子礼券目录

GET /v1/gift-vouchers opendata

列出钱包可购买的 Cuponeria 电子礼券 SKU（门店列表、购买与回执界面），带折扣与有效期，供礼券商店使用。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

couponId
voucherId
storeId
storeImage
discount
valueWithDiscount
expirationDate
status

GET /v1/gift-vouchers HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "coupons": [
    {
      "couponId": "cpn_50",
      "voucherId": "vch_50",
      "storeId": "str_ifood",
      "storeImage": "https://cdn.example.com/gifts/ifood.png",
      "discount": 10,
      "valueWithDiscount": 45.00,
      "expirationDate": "2026-12-31",
      "status": "AVAILABLE"
    }
  ]
}

SDUI 首页钱包

GET /v1/home/wallet-view opendata

服务端驱动的首页载荷，拼出钱包轮播：每张卡的余额以及未读通知数，无需客户端改布局。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

featureToggle
cardId
cardLastNumbers
cardBalance
totalAvailableAmount
cardProductType
unseenCount

GET /v1/home/wallet-view HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "featureToggle": "wallet_home",
  "cards": [
    {
      "cardId": "crd_88100214",
      "cardLastNumbers": "4419",
      "cardBalance": 842.50,
      "totalAvailableAmount": 842.50,
      "cardProductType": "ALIMENTACAO"
    }
  ],
  "unseenCount": 2
}

设备开卡详情

GET /v1/devices/current/wallet-tokens openfinance

列出本设备上哪些 Ticket 卡已写入 Google Pay / Apple Pay、哪些仍在等待，供推送开卡与已登记卡片页使用。

认证方式： Azure AD B2C 的 Bearer accessToken，另附 Ocp-Apim-Subscription-Key 与 X-Request-Id。

deviceId
cardId
tokenId
walletDeviceTokenId
isTokenized
activeTokens
pendingTokens
mobilePayStatus

GET /v1/devices/current/wallet-tokens HTTP/1.1
Authorization: Bearer <access_token>
Ocp-Apim-Subscription-Key: <subscription-key>
X-Request-Id: <uuid>

{
  "deviceId": "dev_pixel_8",
  "cards": [
    {
      "cardId": "crd_88100214",
      "tokenId": "dpan_77ab",
      "walletDeviceTokenId": "gpay_token_77ab",
      "isTokenized": true,
      "activeTokens": 1,
      "pendingTokens": 0,
      "mobilePayStatus": "ENABLED"
    }
  ]
}

数据类别

卡片余额
交易流水
PIX 转账
受益人资料
受理商户网络
电子礼券

数据使用场景与案例

PAT 钱袋对账
薪酬与福利台账每晚拉取 totalAvailableAmount 与分产品的 cardBalance，再用 extrato 上的 TransactionAmount 与 MerchantName 对照雇主的 PAT 注资文件。
PIX 提现监控
资金台账观察 pixLimit / pixMinValue 以及每笔完成的 endToEndId，确保餐券提现在雇主的 PIX 策略之内。
受理网络覆盖
拓展团队按办公地点检索 partnerName、cnpj 与 partnerProduct，查看附近是否受理 Ticket Restaurante 与 Ticket Alimentação。
Google Pay 开卡核对
设备车队工具读取 isTokenized、activeTokens 与 walletDeviceTokenId，确认补卡前哪些实体卡已写入 Google Pay。

常见问题

哪些 Ticket 产品能查到余额？

钱包轮播按产品类型各返回一张卡——Ticket Alimentação、Ticket Restaurante、Ticket Flex / Super Flex、Ticket Car、Ticket Cultura、Ticket Saúde、Ticket Transporte、Ticket Plus 以及电子礼品卡——每张都有 cardBalance、benefitBalance 与 totalAvailableAmount。

除了刷卡消费，应用是否提供 PIX？

提供。已登记密钥以 pixKey 加 pixKeyType 返回；转账会给出 endToEndId、pixFee 与 payerName，收据页可再加载同一张回单用于分享或复制。

调用方如何鉴权？

受益人凭 CPF 经 Azure AD B2C 登录。后续请求携带下发的 Bearer accessToken、Ocp-Apim-Subscription-Key 与 X-Request-Id。PIX 与钱袋互转可能还要附加钱包挑战。

能否列出受理 Ticket 的商户？

受理网络接口按纬度、经度与距离做地理检索，返回 partnerName、fantasyName、cnpj 以及 partnerProduct 列表（Restaurante、Alimentação 等）。

与 Ticket 相似的应用

Meu Alelo — Alelo 面向巴西职工发行 PAT 餐补（Refeição）与食品券（Alimentação），以及文化、出行和多福利卡；Meu Alelo 是查询余额、流水、扫码支付并写入 Google Pay / Apple Pay 的持卡人应用。
Pluxee Brasil — Pluxee Brasil（原 Sodexo Benefícios e Incentivos）是 Pluxee 餐补、食品、文化、礼品、燃油和 Multibenefícios 卡的持卡人应用，卡片在巴西 PAT 框架下使用。
SuperApp VR — SuperApp VR 是 VR Benefícios 的职工应用，用来查看 PAT 餐券、食品券以及居家办公和用车津贴余额，并用虚拟卡或二维码付款。
Flash Benefícios — Flash 是巴西的多福利 Visa 卡及职工应用，覆盖 PAT 食品券与餐券，以及出行、文化、健康、教育和居家办公等品类。
Caju — Caju 是巴西的福利与支出平台，把 CLT、PAT 与弹性福利余额放在一张 Visa 受理卡上，职工可在配套应用里查看各钱袋。
iFood Benefícios — iFood Benefícios 是已登记 PAT 的多余额卡，覆盖餐、食、出行、文化、健康、教育和居家办公津贴，可在 iFood 应用及 Elo 商户消费。
Swile Brasil — Swile Brasil 是已登记 PAT 的多福利 Mastercard，把餐、食及其他员工福利钱包放在一张卡上，职工可在应用里查看实时余额并做闪付。

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

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

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

获取报价

Ticket Edenred 巴西 PAT 卡、PIX 与商户接口

应用截图

API 端点一览

列出钱包卡片

卡片余额

卡片流水

卡片状态与冻结

转账开通标志

已登记 PIX 密钥

提交 PIX 转账

PIX 回单

贷记转账（TED / 钱袋互转）

受益人资料

受理商户网络

Cuponeria 电子礼券目录

SDUI 首页钱包

设备开卡详情

数据类别

数据使用场景与案例

PAT 钱袋对账

PIX 提现监控

受理网络覆盖

Google Pay 开卡核对

常见问题

与 Ticket 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Ticket Edenred 巴西 PAT 卡、PIX 与商户接口

应用截图

API 端点一览

列出钱包卡片

卡片余额

卡片流水

卡片状态与冻结

转账开通标志

已登记 PIX 密钥

提交 PIX 转账

PIX 回单

贷记转账（TED / 钱袋互转）

受益人资料

受理商户网络

Cuponeria 电子礼券目录

SDUI 首页钱包

设备开卡详情

数据类别

数据使用场景与案例

PAT 钱袋对账

PIX 提现监控

受理网络覆盖

Google Pay 开卡核对

常见问题

相关应用

与 Ticket 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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