Pluxee Fintech 卡余额与流水 API

Pluxee International · 支付 4.5 ★

Pluxee Fintech 是 Pluxee International（2024 年由 Sodexo 福利与奖励业务更名）面向墨西哥持卡人的消费端应用，覆盖雇主发放的福利卡以及 Pluxee México FinTech 这家电子支付基金机构（IFPE）发行的两张卡。用户用邮箱加密码登录，或走 Pluxee Connect 单点登录；首页轮播列出已登记的每一张产品：Flexible One 与 Flexible Bonus（电子礼品钱包，productCode PP）、Corporativa / Business Pass 差旅卡（productCode BP），以及商店页仍点名的 Tienda、Restaurante、Movilidad、Regalo 餐补/礼品券——这四类已逐步交给配套的 Pluxee México 应用。卡片滑块按日期显示墨西哥比索余额，流水可按商户或金额筛选；产品详情提供改 PIN、电商动态 CVV、冻结/解冻、加卡、经 Incode/Mati 的 RFC/CURP 实名，以及按墨西哥州与区过滤的受理商户地图。IFPE 法律文本由受 CNBV、墨西哥央行与财政部监管的 Pluxee México FinTech, S.A. de C.V. 出具，点名 Premium Pass One、Premium Pass Bonus、Business Pass Daily 与 Business Pass Premiere。仅服务墨西哥，Google Play 评分 4.55（249,744 条），安装量逾一百万，与 Edenred Ticket、Sí Vale 以及较新的 Pluxee México 消费端应用并列同一批雇主福利钱包。

以 PAN product 为键、带 createdAt 的墨西哥比索 balance 行，紧挨着把 Amount / Merchant / Date 规范成 amount、merchant、date 的流水；身份侧保留墨西哥 rfc（由 nid 映射）与 curp。钱包成员是 type 加 productCode PP 或 BP，以及 estatus 1=Activa；附近商户以 title、address、distance 和 productList 返回。

薪酬对账、差旅报销与城市指南会消费这些字段——夜间余额对圈存文件、把 Business Pass 消费挂到员工 RFC、在改革大道附近钉商户。openData Studio 把同样的字段做成可调用的开放数据。

应用截图

API 端点一览

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

持卡人登录鉴权

POST /v1/benefit-cards/sign-in opendata

用持卡人邮箱与密码换取 Bearer accessToken，应用在会话期间保存它，并附加到之后的每一次调用。

认证方式：无需令牌。邮箱加密码（countryId 指定墨西哥市场）换取 accessToken；之后的调用携带 Authorization: Bearer <accessToken>。

email
nid
username
password
documentType
countryId
strategy
deviceInfo
accessToken
data.created_at

POST /v1/benefit-cards/sign-in HTTP/1.1
Content-Type: application/json

{
  "email": "[email protected]",
  "nid": null,
  "username": null,
  "password": "********",
  "documentType": null,
  "countryId": 9,
  "strategy": "remote",
  "deviceInfo": {
    "platform": "android",
    "appVersion": "2.32.54"
  }
}

{
  "accessToken": "<accessToken>",
  "data": {
    "email": "[email protected]",
    "created_at": "2024-03-12T11:04:00Z",
    "countryId": 9
  }
}

刷新会话令牌
POST /v1/benefit-cards/sign-in/refresh opendata
轮换会话：返回的 accessToken 替换已保存的令牌，使持卡人保持登录。
认证方式：当前会话的 Bearer accessToken，请求体另附 countryId。
- countryId
- token
- accessToken
- expiresIn
```
POST /v1/benefit-cards/sign-in/refresh HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "token": "<accessToken>"
}
```
```
{
  "accessToken": "<refreshedAccessToken>",
  "expiresIn": 3600
}
```

列出钱包产品

POST /v1/wallet-products/list openfinance

返回已登记的全部实体卡与电子钱包：product 中的 PAN、type（Flexible One、Corporativa、Tienda…）、productCode PP/BP、estatus 1=Activa，供首页轮播与产品详情页使用。

认证方式：携带登录调用返回的 Bearer accessToken。请求体含 countryId；钱包变体还会附上登录邮箱。

countryId
email
product
type
productCode
estatus
hidden
isPIN
isCVVD
isOnOff
isTheftLoss

POST /v1/wallet-products/list HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "email": "[email protected]"
}

{
  "data": [
    {
      "product": "516292******4419",
      "type": "Flexible One",
      "productCode": "PP",
      "estatus": 1,
      "hidden": false,
      "isPIN": true,
      "isCVVD": true,
      "isOnOff": true,
      "isTheftLoss": true
    },
    {
      "product": "516292******8821",
      "type": "Corporativa",
      "productCode": "BP",
      "estatus": 1,
      "hidden": false,
      "isPIN": true,
      "isCVVD": false,
      "isOnOff": true,
      "isTheftLoss": true
    }
  ]
}

卡片余额

POST /v1/wallets/balance-lookup openbanking

按 PAN 读取墨西哥比索余额。首页卡片滑块打印「Saldo al {createdAt}」与「MXN {balance}」，同一行数据也合并到产品详情。

认证方式： Bearer accessToken。请求体键为 products[]（PAN 字符串）、email 与 countryId。

products
email
countryId
updates
nid
product
balance
createdAt

POST /v1/wallets/balance-lookup HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "products": [
    "516292******4419",
    "516292******8821"
  ],
  "email": "[email protected]",
  "countryId": 9,
  "updates": true
}

[
  {
    "product": "516292******4419",
    "balance": 1842.5,
    "createdAt": "2026-10-21T15:04:00Z"
  },
  {
    "product": "516292******8821",
    "balance": 9200.0,
    "createdAt": "2026-10-21T15:04:00Z"
  }
]

卡片流水

GET /v1/wallets/{walletRef}/transactions openbanking

按一张 PAN 分页返回流水。服务端同时给出 Pascal 风格的 Amount/Date/Merchant/Type/Status 与流水列表使用的 amount/date/merchant/type/status（墨西哥比索，绿字入账 / 红字出账）。

认证方式： Bearer accessToken。查询参数需要 email 与 countryId。

cardNumber
email
countryId
movements
Amount
amount
Date
date
Reference
reference
Merchant
merchant
Type
type
Status
status

GET /v1/wallets/516292******4419/transactions?email=ana.garcia%40empresa.mx&countryId=9 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "movements": [
    {
      "Amount": -186.5,
      "Date": "2026-10-18",
      "Reference": "TXN-4419-8812",
      "Merchant": "Starbucks Reforma",
      "Type": "PURCHASE",
      "Status": "APPROVED"
    },
    {
      "amount": 2500.0,
      "date": "2026-10-01",
      "reference": "LOAD-OCT",
      "merchant": "Pluxee load",
      "type": "CREDIT",
      "status": "APPROVED"
    }
  ]
}

按商户汇总流水

GET /v1/wallets/{walletRef}/transactions/by-merchant opendata

同一套流水按商户汇总，供流水筛选页的 comercio 视图使用。

认证方式： Bearer accessToken。查询参数与交易列表相同：email 加 countryId。

cardNumber
email
countryId
movements
merchant
amount
date
reference
type
status

GET /v1/wallets/516292******4419/transactions/by-merchant?email=ana.garcia%40empresa.mx&countryId=9 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "movements": [
    {
      "merchant": "Starbucks Reforma",
      "amount": -559.5,
      "date": "2026-10-18",
      "reference": "AGG-STARBUCKS",
      "type": "PURCHASE",
      "status": "APPROVED"
    }
  ]
}

持卡人资料

POST /v1/holders/profile osint

加载登录持卡人，供资料与 KYC 页使用。墨西哥的 nid 以 rfc（13 位）呈现，开户时还会采集 CURP。

认证方式： Bearer accessToken。请求体需要 email 与 countryId。

email
countryId
rfc
curp
cellphone
mobile
name

POST /v1/holders/profile HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "email": "[email protected]",
  "countryId": 9
}

{
  "email": "[email protected]",
  "rfc": "GARA850101XXX",
  "curp": "GARA850101MDFRRN09",
  "cellphone": "5512345678",
  "mobile": "5512345678",
  "name": "Ana García",
  "countryId": 9
}

校验 RFC 是否已注册
POST /v1/holders/lookup osint
在证件注册第一步查询该 RFC 是否已在档，第二步再出示打码后的手机号。
认证方式：注册阶段无需令牌。请求体为 nid（带均码的 RFC）加 countryId。
- nid
- countryId
- exists
- email
- mobile
- obfuscatedMobile
```
POST /v1/holders/lookup HTTP/1.1
Content-Type: application/json

{
  "nid": "GARA850101XXX",
  "countryId": 9
}
```
```
{
  "exists": true,
  "email": "[email protected]",
  "mobile": "5512345678",
  "obfuscatedMobile": "******5678"
}
```

受理商户

GET /v1/acceptance/locations opendata

返回持卡人附近的受理商户：title、address、phone、公里距离与受理产品类型，供按州与区过滤的 Lista/Mapa 商户页使用。

认证方式： Bearer accessToken。查询参数含 countryId，以及来自 GPS 的 lat/lon 或搜索框的 title。

countryId
lat
lon
title
address
phone
distance
productList

GET /v1/acceptance/locations?countryId=9&lat=19.435312&lon=-99.134402 HTTP/1.1
Authorization: Bearer <accessToken>

[
  {
    "title": "Starbucks Reforma",
    "address": "Av. Paseo de la Reforma 222, Juárez, CDMX",
    "phone": "5551400000",
    "distance": 0.4,
    "lat": 19.4332,
    "lon": -99.1605,
    "productList": [
      "Flexible One",
      "Tienda",
      "Restaurante"
    ]
  }
]

展示卡片 CVV

POST /v1/cards/static-code openfinance

返回已登记卡（product.isCVVD）的静态 CVV，供 CVV 页在线支付时展示。

认证方式： Bearer accessToken。请求体含 countryId 以及 product 中的 PAN。

countryId
product
email
cvv
status

POST /v1/cards/static-code HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "product": "516292******4419",
  "email": "[email protected]"
}

{
  "cvv": "123",
  "product": "516292******4419",
  "status": "ACTIVE"
}

生成动态 CVV
POST /v1/cards/dynamic-code openfinance
签发用于电商的短时 CVV（商店文案：「Generar CVV dinámico para compras en línea」）；动态 CVV 表单负责采集请求。
认证方式： Bearer accessToken。请求体含 countryId 与 PAN。
- countryId
- product
- email
- cvv
- expiresAt
```
POST /v1/cards/dynamic-code HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "product": "516292******4419",
  "email": "[email protected]"
}
```
```
{
  "cvv": "847",
  "expiresAt": "2026-10-21T15:10:00Z",
  "product": "516292******4419"
}
```
修改卡片 PIN
POST /v1/cards/pin-update openfinance
在 PIN 申请与确认流程中，为支持 PIN 的卡（product.isPIN）设置新 PIN。
认证方式： Bearer accessToken。已登录邮箱会自动附加；请求体还含 countryId 与新 PIN。
- email
- countryId
- product
- pin
- status
```
POST /v1/cards/pin-update HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "email": "[email protected]",
  "countryId": 9,
  "product": "516292******4419",
  "pin": "1478"
}
```
```
{
  "status": "OK",
  "product": "516292******4419"
}
```
冻结卡片
POST /v1/cards/lock openfinance
在遗失或被盗后冻结实体卡（product.isTheftLoss / isOnOff）。产品详情随后把 estatus != 1 显示为 Inactiva。
认证方式： Bearer accessToken。请求体含 countryId、PAN 以及来自冻结原因列表的原因代码。
- countryId
- product
- email
- reasonId
- reason
- estatus
- status
```
POST /v1/cards/lock HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "product": "516292******4419",
  "email": "[email protected]",
  "reasonId": 2,
  "reason": "theft"
}
```
```
{
  "product": "516292******4419",
  "estatus": 2,
  "status": "BLOCKED"
}
```

在线支付扣款

POST /v1/checkout/charges openbanking

在 PIN 校验之后从 Flexible/Corporativa 余额扣款到受理商户；配套调用还包括支付处理、PIN 校验、授权令牌签发与交易通知。

认证方式： Bearer accessToken。客户端对暂时性失败最多重试 5 次。

countryId
product
email
amount
currency
merchantCode
pin
status
authorizationCode
reference

POST /v1/checkout/charges HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "product": "516292******4419",
  "email": "[email protected]",
  "amount": 186.5,
  "currency": "MXN",
  "merchantCode": "SX-88219",
  "pin": "1478"
}

{
  "status": "APPROVED",
  "authorizationCode": "884120",
  "amount": 186.5,
  "currency": "MXN",
  "reference": "PAY-4419-1102"
}

CIAM 用户产品
POST /v1/identity/linked-wallets openfinance
列出绑定到 Pluxee Connect（CIAM）身份的产品，登录时请求标准 OpenID 范围（openid、email、profile、phone）加 consumer 范围。
认证方式：登录调用返回的 Bearer accessToken，或 Pluxee Connect 单点登录令牌。请求体含 countryId。
- countryId
- email
- products
- product
- type
- productCode
- estatus
```
POST /v1/identity/linked-wallets HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "countryId": 9,
  "email": "[email protected]"
}
```
```
{
  "products": [
    {
      "product": "516292******4419",
      "type": "Flexible One",
      "productCode": "PP",
      "estatus": 1
    }
  ]
}
```

数据类别

余额
交易
卡片
身份
商户
支付

数据使用场景与案例

雇主福利余额对账
薪酬与 HRIS 机器人每晚按 products[] 中的 PAN 与 email 拉取卡片余额查询，再用 MXN 的 balance 与 createdAt 去对 Flexible One、Flexible Bonus、Corporativa 钱包的圈存文件。
Corporativa 差旅报销匹配
差旅报销工具分页读取按卡交易列表（amount、merchant、date、reference、type、status）及其 comercio 商户汇总，把 Business Pass 消费挂到员工 RFC。
受理网络定位
城市指南用墨西哥城 lat/lon（19.435312, -99.134402）调用受理地点搜索，渲染 title、address、phone、distance 与 productList，方便 Tienda、Restaurante 或 Flexible 持卡人查找附近 comercio asociado。
IFPE KYC 刷新
合规栈读取持卡人资料（rfc、curp、cellphone、email）并在 nid 上调用注册查询，使 Pluxee México FinTech IFPE 开户与 Incode/Mati 采集的 CURP 保持一致。

常见问题

Pluxee Fintech 如何鉴权持卡人？

POST /v1/benefit-cards/sign-in 接受 email、password、countryId 与 strategy remote，返回 accessToken，后续调用以 Authorization: Bearer 头发送。墨西哥持卡人也可经 Pluxee Connect 单点登录，请求 openid、email、profile、phone 范围加 consumer 范围。POST /v1/benefit-cards/sign-in/refresh 负责轮换会话令牌。

首页滑块上有哪些余额与流水字段？

POST /v1/wallets/balance-lookup 以 products[]（PAN 字符串）加 email、countryId 为键，返回每张卡的 balance 与 createdAt——卡片滑块打印「Saldo al {date}」和「MXN {balance}」。GET /v1/wallets/{walletRef}/transactions 返回带 Amount、Date、Reference、Merchant、Type、Status 的 movements，并同时给出流水列表使用的 amount、date、reference、merchant、type、status。

墨西哥 KYC 采集哪些身份证件？

13 位 RFC 存在 nid 中并以 rfc 呈现。开户时还会采集 curp（墨西哥出生持卡人拆成前 10 位加余下部分），以及出生国、联邦实体、国籍、职业与政治公众人物标记，再走 Incode/Mati 身份核验。POST /v1/holders/profile 与 POST /v1/holders/lookup 在登录后或注册过程中暴露这些字段。

如何查找受理商户？

GET /v1/acceptance/locations 接受 countryId、GPS lat/lon（无 GPS 时回退到墨西哥城 19.435312, -99.134402）或 title 搜索，返回 title、address、phone、distance 与 productList。商户页分为 Lista 与 Mapa 两个选项卡，并按州与区过滤。

与 Pluxee Fintech 相似的应用

Edenred Wallet — Edenred Wallet 是 Edenred 墨西哥的持卡人应用，覆盖雇主发放的食品券、Ticket Restaurante 餐补和 Ticket Car 燃油卡，用来查余额、近 90 天流水、附近受理商户，并生成网购动态 CVV。
Up Sí Vale — Up Sí Vale 是墨西哥 Up Sí Vale 雇主福利卡的职工应用，可实时查看余额与流水（含附属卡），并领取 Sí Vale 商户促销。
Pluxee México — Pluxee México 是 Pluxee 面向 Tienda、Restaurante、Movilidad 与 Regalo 福利券的配套消费端应用，可查实时余额、附近商户、促销并生成动态 CVV；Fintech 卡需在另一款 PluxeeMx 应用中登记。
Toka — Toka 在墨西哥发行电子食品券钱包和燃油卡，持卡人通过 Toka Super App 使用雇主充值的福利，并附带出行与连通类服务。
Efectivale Móvil — Efectivale Móvil 是 Efectivale 墨西哥燃油、食品券、餐补和差旅卡的持卡人应用，用来查余额、最近流水和加油站。
Pluxee Brasil — Pluxee Brasil 是巴西持卡人应用，覆盖 Pluxee 的 PAT 餐补与食品券以及文化、礼品和燃油卡，可查余额、流水、受理商户，并自助改 PIN 或冻卡。

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

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

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

获取报价

Pluxee Fintech 卡余额与流水 API

应用截图

API 端点一览

持卡人登录鉴权

刷新会话令牌

列出钱包产品

卡片余额

卡片流水

按商户汇总流水

持卡人资料

校验 RFC 是否已注册

受理商户

展示卡片 CVV

生成动态 CVV

修改卡片 PIN

冻结卡片

在线支付扣款

CIAM 用户产品

数据类别

数据使用场景与案例

雇主福利余额对账

Corporativa 差旅报销匹配

受理网络定位

IFPE KYC 刷新

常见问题

与 Pluxee Fintech 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Pluxee Fintech 卡余额与流水 API

应用截图

API 端点一览

持卡人登录鉴权

刷新会话令牌

列出钱包产品

卡片余额

卡片流水

按商户汇总流水

持卡人资料

校验 RFC 是否已注册

受理商户

展示卡片 CVV

生成动态 CVV

修改卡片 PIN

冻结卡片

在线支付扣款

CIAM 用户产品

数据类别

数据使用场景与案例

雇主福利余额对账

Corporativa 差旅报销匹配

受理网络定位

IFPE KYC 刷新

常见问题

相关应用

与 Pluxee Fintech 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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