openData StudioEnglish
Pluxee Brasil 图标

Pluxee Brasil 私有数据 API：电子卡与钱包

PLUXEE BENEFÍCIOS BRASIL S.A · 支付 4.7 ★

在 Google Play 中打开

Pluxee Brasil 是 PLUXEE BENEFÍCIOS BRASIL S.A（Pluxee 巴西公司，2024 年由 Sodexo 福利与奖励业务更名）面向持有雇主发放 PAT 餐补、食品券以及文化、礼品、玩具、燃油与激励卡的职工钱包。登录方式与 pluxee.com.br 网站相同；首页用一张卡号即可查看名下所有卡的余额（saldo）与账单（extrato），按定位查找受理商户、看专属促销，并能找回或更换卡片密码、在遗失、被盗或新卡激活时冻结或解冻。Pluxee Refeição（餐券）、Pluxee Alimentação（食品券）、Pluxee Cultura、Pluxee Gift、Pluxee Premium、Pluxee Gift Brinquedo、Pluxee Combustível 与 Pluxee Alimentação Natal 都走这一个应用；虚拟电子卡、钱包 PIN 与 NFC 闪付与实体卡并列。仅服务巴西，Google Play 评分 4.71（1,675,678 条），安装量逾一千万，与 Alelo、VR Benefícios、Ticket（Edenred 巴西）、Caju、Flash Benefícios 争夺同一批 PAT 钱包。

虚拟卡号 vcnId 与 PAN 尾号 last4Digits、bin、expiryDate 以及 Active / Suspended / Deleted 的 status 写在同一行，并绑定实体卡 uniqueCardId 与支付次数上限 maxNumberOfPayments。状态写入发送 TOKEN_ACTIVATED、TOKEN_SUSPENDED 或 TOKEN_DELETED，回包为 newVcnStatus；PIN 展示在 walletCertificate 证明后返回 payLoad；钱包码重置以 CIAM 主体 ciamID 为键。

Google Pay MDES 注册提交 nameOnCard、deviceWalletId 与 uniqueConsumerId，读回 enrollmentData 和 opc；3-D Secure 结果携带 callerAuthenticationId、respondingWalletId 与 authenticationDate。薪酬、报销与 MDM 工具可同步 PAT 餐补与食品券的在用虚拟卡及代币状态，openData Studio 再把它做成可调用的开放数据。

应用截图

  • Pluxee Brasil 应用截图 1
  • Pluxee Brasil 应用截图 2
  • Pluxee Brasil 应用截图 3
  • Pluxee Brasil 应用截图 4
  • Pluxee Brasil 应用截图 5

API 端点一览

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

  • 列出虚拟电子卡

    GET /v1/virtual-cards openfinance

    按 uniqueCardId 返回已签发的全部虚拟卡号：vcnId、BIN/尾号、有效期、支付次数上限与 Active/Suspended/Deleted 状态，供电子卡列表页使用。

    认证方式： x-Issuer-Id 发卡机构请求头标识福利发卡方；uniqueCardId 查询参数指定电子卡所绑定的实体卡。

    • vcnId
    • providerId
    • name
    • bin
    • last4Digits
    • expiryDate
    • maxNumberOfPayments
    • maxValidityDate
    • status
    • creationDate
    • card.bin
    • card.last4Digits
    GET /v1/virtual-cards?uniqueCardId=CARD-88100214 HTTP/1.1
x-Issuer-Id: <issuer-id>
    [
  {
    "vcnId": "vcn-7f2a9c11",
    "providerId": "benefit-issuer-br",
    "name": "Almoço",
    "payload": "",
    "bin": "516292",
    "last4Digits": "4419",
    "expiryDate": "2027-08",
    "maxNumberOfPayments": 12,
    "maxValidityDate": "2027-08-31",
    "status": "Active",
    "creationDate": "2026-03-12T11:04:00Z",
    "card": {
      "bin": "516292",
      "last4Digits": "4419",
      "expiryDate": "2027-08",
      "creationDate": "2026-03-12T11:04:00Z"
    }
  }
]

  • 读取电子卡详情

    POST /v1/virtual-cards/{vcnId} openfinance

    在钱包用 walletCertificate 证明持有后，读取单张 VCN 的完整记录（BIN、尾号、有效期、状态及嵌套 card），供电子卡详情页使用。

    认证方式： x-Issuer-Id 发卡机构请求头；路径参数 vcnId；请求体携带 walletCertificate。

    • vcnId
    • providerId
    • name
    • payload
    • bin
    • last4Digits
    • expiryDate
    • maxNumberOfPayments
    • status
    • walletCertificate
    • clipboardCopyAllowed
    POST /v1/virtual-cards/vcn-7f2a9c11 HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"walletCertificate": "<device-wallet-cert>", "clipboardCopyAllowed": false}
    {
  "vcnId": "vcn-7f2a9c11",
  "providerId": "benefit-issuer-br",
  "name": "Almoço",
  "payload": "",
  "bin": "516292",
  "last4Digits": "4419",
  "expiryDate": "2027-08",
  "maxNumberOfPayments": 12,
  "maxValidityDate": "2027-08-31",
  "status": "Active",
  "creationDate": "2026-03-12T11:04:00Z",
  "card": {
    "bin": "516292",
    "last4Digits": "4419",
    "expiryDate": "2027-08",
    "creationDate": "2026-03-12T11:04:00Z"
  }
}

  • 创建虚拟电子卡

    POST /v1/virtual-cards openfinance

    按 UniqueCardId 签发新的 VCN，带展示名、支付次数上限与 ValidityDuration，返回新的 vcnId、尾号与 Active 状态。

    认证方式： x-Issuer-Id 发卡机构请求头。

    • UniqueCardId
    • Name
    • MaxNumberOfPayments
    • ValidityDuration
    • WalletCertificate
    • ClipboardCopyAllowed
    • vcnId
    • last4Digits
    • status
    POST /v1/virtual-cards HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"UniqueCardId": "CARD-88100214", "Name": "Almoço", "MaxNumberOfPayments": 12, "ValidityDuration": "P6M", "WalletCertificate": "<device-wallet-cert>", "ClipboardCopyAllowed": false}
    {
  "vcnId": "vcn-7f2a9c11",
  "providerId": "benefit-issuer-br",
  "name": "Almoço",
  "bin": "516292",
  "last4Digits": "4419",
  "expiryDate": "2027-08",
  "maxNumberOfPayments": 12,
  "maxValidityDate": "2027-08-31",
  "status": "Active",
  "creationDate": "2026-03-12T11:04:00Z"
}

  • 更新电子卡状态

    POST /v1/virtual-cards/{vcnId}/status openfinance

    通过 TOKEN_ACTIVATED / TOKEN_SUSPENDED / TOKEN_DELETED 激活、冻结或删除 VCN，返回 newVcnStatus（Active、Suspended 或 Deleted）。

    认证方式： x-Issuer-Id 发卡机构请求头；路径参数 vcnId。

    • action
    • reason
    • comments
    • customerServiceUser.id
    • customerServiceUser.name
    • customerServiceUser.organization
    • newVcnStatus
    POST /v1/virtual-cards/vcn-7f2a9c11/status HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"action": "TOKEN_SUSPENDED", "reason": "lost_device", "comments": "phone stolen", "customerServiceUser": {"id": "cs-1044", "name": "Ana Costa", "organization": "Pluxee Brasil"}}
    {
  "newVcnStatus": "Suspended"
}

  • 展示卡片 PIN

    POST /v1/cards/{cardId}/pin openfinance

    在钱包证书证明后，以 payLoad 返回卡片 PIN（及可选静态密文），供应用内密码/PIN 界面使用。

    认证方式： x-Issuer-Id 发卡机构请求头；路径参数 cardId；请求体携带 walletCertificate。

    • cardId
    • walletCertificate
    • type
    • clipboardCopyAllowed
    • payLoad
    POST /v1/cards/CARD-88100214/pin HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"walletCertificate": "<device-wallet-cert>", "type": "CARD_DETAILS_AND_STATIC_CRYPTOGRAM", "clipboardCopyAllowed": false}
    {
  "payLoad": "<ciphered-pin-payload>"
}

  • 重置钱包码

    POST /v1/wallets/{wallet_id}/access-code openfinance

    按 CIAM 主体 ciamID 重置 wallet_id 的设备钱包码，返回布尔 result。

    认证方式： x-Issuer-Id 发卡机构请求头；路径参数 wallet_id。

    • wallet_id
    • ciamID
    • result
    POST /v1/wallets/wlt-44c1/access-code HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"ciamID": "ciam-9b0e12f4"}
    {
  "result": true
}

  • 准备数字卡注册

    POST /v1/cards/{id}/wallet-enrolment openfinance

    为卡片 id 启动数字钱包注册，提交 nameOnCard、deviceWalletId、uniqueConsumerId 与 lifetime，返回给钱包 SDK 的 enrollmentData。

    认证方式： x-Issuer-Id 发卡机构请求头加 Country（BRA）；路径参数 id。

    • nameOnCard
    • deviceWalletId
    • uniqueConsumerId
    • lifetime
    • enrollmentData
    POST /v1/cards/CARD-88100214/wallet-enrolment HTTP/1.1
x-Issuer-Id: <issuer-id>
Country: BRA
Content-Type: application/json

{"nameOnCard": "MARIA SILVA", "deviceWalletId": "dwid-88a1", "uniqueConsumerId": "ucid-12ab", "lifetime": 1440}
    {
  "enrollmentData": "<opaque-enrolment-blob>"
}

  • 启动应用内代币开通

    POST /v1/cards/{id}/tokenization/session openfinance

    为卡片 id 启动发卡机构的应用内代币开通，返回支付 SDK 所需的 auth 与 cipheredCardData。

    认证方式： x-Issuer-Id 发卡机构请求头；路径参数 id。

    • id
    • auth
    • cipheredCardData
    POST /v1/cards/CARD-88100214/tokenization/session HTTP/1.1
x-Issuer-Id: <issuer-id>
    {
  "auth": "<provisioning-auth>",
  "cipheredCardData": "<ciphered-card-blob>"
}

  • 启动 Google Pay MDES 开通

    POST /v1/cards/{id}/tokenization/push openfinance

    为卡片 id 启动 Mastercard MDES 推送到 Google Pay 的开通，提交 PanSource，返回 TapAndPay SDK 所需的 opc。

    认证方式： x-Issuer-Id 发卡机构请求头；路径参数 id。

    • id
    • PanSource
    • opc
    POST /v1/cards/CARD-88100214/tokenization/push HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"PanSource": "CARD_ADDED_MANUALLY"}
    {
  "opc": "<opaque-payment-card>"
}

  • 回传 3-D Secure 认证结果

    POST /v1/authentications/outcome openfinance

    在确认交易界面之后，把钱包的 3-D Secure / SCA 判定（result、reason、authenticationMethodTypes、respondingWalletId、authenticationDate）回传给发卡机构。

    认证方式： x-Issuer-Id 发卡机构请求头。

    • id
    • callerAuthenticationId
    • context
    • result
    • reason
    • data
    • proof
    • authenticationMethodTypes
    • respondingWalletId
    • authenticationDate
    • riskInfo
    POST /v1/authentications/outcome HTTP/1.1
x-Issuer-Id: <issuer-id>
Content-Type: application/json

{"id": "sca-10044", "callerAuthenticationId": "3ds-88a1", "context": "PAYMENT", "result": "AUTHENTICATED", "reason": "BIOMETRIC", "data": "", "proof": "", "authenticationMethodTypes": "BIOMETRIC", "respondingWalletId": 4419, "authenticationDate": "2026-10-16T14:02:11Z", "riskInfo": ""}
    {}

数据类别

  • 电子卡
  • 虚拟卡
  • 卡号
  • 代币化
  • 3-D Secure
  • 钱包 PIN

数据使用场景与案例

  • 薪酬侧的 PAT 卡台账

    人事与福利平台按 uniqueCardId 拉取电子卡列表，查看每张在用 VCN 的 vcnId、last4Digits、expiryDate、maxNumberOfPayments 与 Active/Suspended/Deleted，无需打开职工端应用。

  • 按虚拟卡尾号对账的报销工具

    企业卡报销产品用 bin 与 last4Digits 匹配小票，并遵守 maxNumberOfPayments 与 maxValidityDate，避免一次性午餐 VCN 超额复用。

  • 丢失设备冻结

    MDM 或客服机器人提交 TOKEN_SUSPENDED（含 reason 与 customerServiceUser）并读取 newVcnStatus，避免被盗手机继续刷餐补 VCN。

  • SCA 结果归档

    风控系统把每笔 3-D Secure 结果中的 callerAuthenticationId、respondingWalletId、authenticationMethodTypes 与 authenticationDate 存入 PAT 卡争议档案。

常见问题

Pluxee Brasil 暴露哪些电子卡字段？

每张虚拟卡返回 vcnId、providerId、name、bin、last4Digits、expiryDate、maxNumberOfPayments、maxValidityDate、status（Active、Suspended 或 Deleted）以及带同样 PAN 尾号的嵌套 card。列表调用以 uniqueCardId 为键。

如何冻结或删除虚拟卡？

状态写入发送 action TOKEN_ACTIVATED、TOKEN_SUSPENDED 或 TOKEN_DELETED，并附 reason、comments 与可选 customerServiceUser（id、name、organization）。响应为 newVcnStatus。

PIN 展示如何工作？

PIN 调用携带 cardId、walletCertificate 证明与 type CARD_DETAILS_AND_STATIC_CRYPTOGRAM，返回 payLoad。钱包码重置是另一条调用，键为 wallet_id 与 ciamID。

电子卡旁边还有哪些代币化流程？

数字卡注册提交 nameOnCard、deviceWalletId、uniqueConsumerId 与 lifetime，返回 enrollmentData。应用内代币开通返回 auth 与 cipheredCardData；Google Pay MDES 开通提交 PanSource 并返回 opc。3-D Secure 结果把 result、reason 与 respondingWalletId 回传给发卡机构的认证端点。

与 Pluxee Brasil 相似的应用

  • Alelo — Alelo 是巴西另一家大型 PAT 发卡机构，提供餐补、食品、文化与交通卡及自有余额/账单应用，与 Pluxee 争夺同一批雇主券预算。
  • VR Benefícios — VR Benefícios 发行在巴西广泛受理的餐券与食品券，并提供查询余额、账单与商户检索的用户端应用。
  • Ticket (Edenred Brasil) — Ticket 是 Edenred 在巴西的餐补与食品券品牌，同属 PAT 直接竞品，应用覆盖卡余额、PIN 与受理商户。
  • Caju — Caju 是较新的巴西福利钱包，把餐补、食品、健康与居家津贴放在一张预付卡上，并按品类记账余额。
  • Flash Benefícios — Flash Benefícios 是面向巴西雇主的弹性福利卡，应用内按品类显示余额，而不是 Pluxee 式多张专用卡。
  • iFood Benefícios — iFood Benefícios 把 PAT 餐补放到可在 iFood 消费的余额上，在已受理 iFood 的餐厅与 Pluxee Refeição 重叠。

更多支付类应用

相关主题

  • Pluxee Brasil API
  • Pluxee 电子卡 vcnId
  • Vale Refeição last4Digits
  • 巴西 PAT 餐券
  • Pluxee 钱包 PIN
  • Pluxee Google Pay MDES
  • Pluxee 3-D Secure

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

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

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

获取报价