Pluxee India SuperCard 数据 API
Pluxee India: prev Sodexo-Zeta 是 Pluxee India Pvt Ltd 推出的员工福利钱包,也是 Zeta SuperCard 应用的后继产品。员工使用手机号登录,即可管理雇主发放的餐饮、礼品、通信、奖励、现金及费用报销等福利子钱包。应用整合了 SuperCard 余额查询、RuPay 卡片详情、PIN 码与 CVV 查看、卡片冻结与解冻、BharatQR 支付、可信商户处的感应支付,以及 Optima 多福利合约。餐卡持有人可在认可的食堂和杂货门店消费,也能在同一登录会话中隐藏闲置支付工具、查看关联 RBL 的账户详情。该应用面向印度市场,在 Google Play 获得 3.75 分,累计收到 222,366 条评分,与 Edenred Ticket Restaurant India 一同服务于雇主餐卡市场。
餐饮福利子钱包余额与 SuperCard 账本分录共同构成相互关联的福利记录:cardProgramID、productType、ledgerId 和 cardState 用于区分各个子钱包,amount 与 currency 则表示其剩余金额。实体卡记录补充了 maskedPan、isPhysical、crn 和 contractId。账单条目包含 amountInPaise、recordType、previousBalance、newBalance 和 transactionID,交易对手详情位于 otherLegInfo 中。
薪资与费用管理团队可根据这些余额变化,核对福利充值与食堂收据。卡片运营工具可将 tokenId、tokenStatus 和 merchantName 与卡片记录关联;福利管理员则可把 zetaUserID、crn、secondaryCRN 和 contractList 与 kycDone、corpID 等个人资料核验字段对应起来。支付对账还可利用 transactionState、banker.status 和 paymentReceipt 确认扣款结果。在获得底层记录访问授权的前提下,openData Studio 将这些福利数据转化为可调用的开放数据,用于薪资对账、卡片同步和合约接入。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
创建 Proteus 会话
POST
/v1/access/sessionsosint在单点登录后建立福利领取人的会话,并返回 authToken 和 validTill,供后续所有钱包、账本和 SuperCard 调用使用。
认证方式: 在手机号单点登录后进行会话初始化,此步骤无需已有会话认证。请求体携带 authData、clientSessionId 和 uaInfo;响应提供 authToken 与 validTill,供后续需认证的调用使用。
- authData
- authToken
- clientSessionId
- requestId
- version
- uaInfo
- gatewayInfo
- id
- validTill
POST /v1/access/sessions HTTP/1.1 Content-Type: application/json { "authData": "otp-verified-mobile", "authToken": "", "clientSessionId": "android-auth-1718600000000", "requestId": "android-auth-1718600000000", "version": 1, "uaInfo": { "osName": "Android", "appVersion": "9.5.5" }, "gatewayInfo": {} }{ "id": "sess_7f2a9c11", "authToken": "<session-token>", "validTill": 1718686400000 }获取用户资料
GET
/v1/beneficiaries/profileosint返回已登录福利领取人的资料,包括 userId、姓名、已验证的 +91 手机号、corpID 和 kycDone,用于账户信息栏展示及 KYC 状态检查。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌,通过 userJID / userId 限定福利领取人。
- userId
- firstName
- lastName
- dob
- gender
- emailList
- phoneNumber
- isVerified
- profilePicURL
- isPassphraseSet
- kycDone
- corpID
- shopId
- addresses
- bankAccounts
GET /v1/beneficiaries/profile HTTP/1.1 Authorization: Bearer <session-token> X-User-JID: user_88100214{ "userId": "user_88100214", "name": { "firstName": "Anita", "lastName": "Sharma" }, "dob": "1992-04-18", "gender": "F", "emailList": [{"email": "<email>"}], "phoneNumbers": [{"phoneNumber": "<verified-mobile>", "isVerified": true}], "profilePicURL": "<profile-image-url>", "isPassphraseSet": true, "kycDone": true, "attrs": {"corpID": "corp_pluxee_1102"}, "shopId": "", "addresses": [], "bankAccounts": [], "businessIDs": [], "trustedContacts": [], "userDocs": [] }获取 SuperCard 钱包
POST
/v1/benefits/wallet-viewopenfinance加载指定 IFI 范围内的 SuperCard 钱包:餐饮、礼品、现金等 cardPrograms 包含 amount 和 ledgerId,superCardList 中的实体卡则包含 maskedPan、crn 和 productType(值为 MEAL)。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。请求体通过 userID 指定用户,并通过 cardCriteria 提供包含 includeZeroBalance 和 states 的卡片筛选条件。
- id
- primaryIFI
- availableIFIs
- cardProgramID
- cardID
- superCardID
- name
- productType
- programType
- ledgerId
- amount
- currency
- ifi
- cardState
- maskedPan
- isPhysical
- crn
- contractId
- includeZeroBalance
POST /v1/benefits/wallet-view HTTP/1.1 Authorization: Bearer <session-token> Content-Type: application/json { "appID": "in.zeta.android", "userID": "user_88100214", "includeAllCards": true, "cardCriteria": { "*": { "includeZeroBalance": true, "states": ["ENABLED", "DISABLED"] } } }{ "wallet": { "id": 44018221, "primaryIFI": 151613, "availableIFIs": {"151613": "RBL"}, "cardPrograms": [ { "cardProgramID": "cp_meal_01", "cardID": "card_7f2a", "superCardID": "sc_9f21", "name": "Meal", "productType": "MEAL", "programType": "BENEFIT", "ledgerId": "ldg_88100214", "amount": 125000, "points": 0, "currency": "INR", "ifi": 151613, "isShareable": false, "cardState": "ENABLED", "lastUpdateTime": "2026-10-22T08:11:00Z", "value": {"currency": "INR", "amount": "125000"}, "attrs": {} } ], "superCardList": [ { "cardID": "sc_9f21", "maskedPan": "5085-****-****-4419", "isPhysical": true, "isAddOn": false, "state": "ENABLED", "productType": "MEAL", "ifi": 151613, "crn": "crn_4401", "contractId": "ct_optima_12", "cguid": "cguid_77a" } ], "cards": [], "addOnCards": {}, "tags": [] } }列出支付工具
POST
/v1/benefits/instrument-listopenfinance返回所有可见的支付工具(SuperCard 或 SuperTag),包含 uniquingId、productType、state 和 crn,用于首页轮播视图及隐藏、显示控制。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。请求体标识福利领取人及应用上下文。
- paymentInstruments
- type
- uniquingId
- ifi
- productType
- state
- templateID
- crn
- associatedItems
- bottomSheetTitle
POST /v1/benefits/instrument-list HTTP/1.1 Authorization: Bearer <session-token> Content-Type: application/json { "appID": "in.zeta.android", "userId": "user_88100214", "uaInfo": {"osName": "Android", "appVersion": "9.5.5"} }{ "paymentInstruments": [ { "type": "SuperCard", "uniquingId": "sc_9f21", "ifi": 151613, "productType": "MEAL", "state": "ENABLED", "templateID": "tpl_supercard", "crn": "crn_4401", "associatedItems": [], "attrs": {"bottomSheetTitle": "Meal SuperCard"} } ] }获取账本交易
POST
/v1/benefits/ledger-historyopenbanking分页获取单个餐饮账本的 CREDIT / DEBIT 分录,包括 amountInPaise、previousBalance / newBalance、remarks 及交易对手名称,用于钱包账单。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。请求体指定 ledgerID 并提供分页游标。
- ledgerID
- postingID
- transactionID
- previousBalance
- newBalance
- timestamp
- amountInPaise
- recordType
- remarks
- otherLegInfo
- name
- imageURL
- profilePicURL
- before
- after
- count
- order
POST /v1/benefits/ledger-history HTTP/1.1 Authorization: Bearer <session-token> Content-Type: application/json { "ledgerID": "ldg_88100214", "before": "", "after": "", "count": 20, "order": "DESC" }{ "transactions": [ { "ledgerID": "ldg_88100214", "postingID": "pst_9f21aa", "transactionID": "txn_77a4419", "previousBalance": 128500, "newBalance": 125000, "timestamp": 1729661460000, "amountInPaise": 3500, "recordType": "DEBIT", "remarks": "Canteen swipe", "otherLegInfo": { "merchant": { "name": "Cafe Coffee Day", "imageURL": "", "profilePicURL": "" } }, "attributes": {} } ] }获取 SuperCard PAN 数据
POST
/v1/cards/secure-detailsopenfinance返回加密的 SuperCard 卡号(PAN)、CVV 和有效期数据(cardData 与 iv),供卡片展开详情页展示 RuPay 实体卡信息。
认证方式: 发送包含 userID、timestamp 和 clientPubKey 的已签名请求,同时在 Authorization 请求头中携带 Bearer 会话令牌。
- userID
- timestamp
- clientPubKey
- serverPubKey
- cardData
- iv
- cvv
- expiry
- validFrom
POST /v1/cards/secure-details HTTP/1.1 Authorization: Bearer <session-token> Content-Type: application/json { "userID": 88100214, "timestamp": 1729661460000, "clientPubKey": "<client-public-key>" }{ "serverPubKey": "<server-public-key>", "data": [ { "cardData": "<encrypted-card-data>", "iv": "<initialization-vector>" } ] }获取卡片令牌
GET
/v1/cards/merchant-tokensopenfinance列出单张 SuperCard 上的 RuPay 餐饮令牌,包括 tokenId、ENABLED / DISABLED / DELETED 状态和 merchantName,用于餐饮令牌管理。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。查询参数 cardId 标识对应的 SuperCard。
- tokens
- tokenId
- tokenStatus
- modifiedAt
- merchantName
GET /v1/cards/merchant-tokens?cardId=sc_9f21 HTTP/1.1 Authorization: Bearer <session-token>{ "tokens": [ { "tokenInfoView": { "tokenId": "tkn_rupay_4419", "tokenStatus": "ENABLED", "modifiedAt": "2026-09-12T11:04:00Z", "merchantInformation": { "merchantName": "Cafe Coffee Day" } } } ] }获取支付信息
POST
/v1/payments/status-viewopenbanking读取一笔处理中或已完成扣款的 SuperCard 支付,包含 state、banker.status 和回执,用于支付状态页及 BharatQR 结果页。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。请求体携带 userId 和 paymentInfoRequest。
- id
- state
- bConnectTxnId
- payee
- stateTransitions
- banker.status
- banker.failureReason
- authorizationReceipt
- paymentReceipt
POST /v1/payments/status-view HTTP/1.1 Authorization: Bearer <session-token> Content-Type: application/json { "userId": "user_88100214", "paymentInfoRequest": { "id": 99211004 } }{ "id": 99211004, "state": "CAPTURED", "bConnectTxnId": "bconn_77a", "payee": {"name": "Cafe Coffee Day"}, "stateTransitions": {"AUTHORIZED": 1729661400000, "CAPTURED": 1729661460000}, "attributes": { "banker.status": "SUCCESS", "banker.failureReason": "" }, "authorizationReceipt": {}, "paymentReceipt": {} }执行授权扣款
POST
/v1/payments/authorized-captureopenbanking对 BharatQR 或自动售货场景的 SuperCard 支付执行扣款,并返回 transactionState,供支付确认页使用。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。请求体携带 authorization 对象和 merchantInfo。
- requestId
- authorizationType
- authorization
- captureInfo
- merchantInfo
- attrs
- transactionState
POST /v1/payments/authorized-capture HTTP/1.1 Authorization: Bearer <session-token> Content-Type: application/json { "requestId": "req_bqr_4419", "authorizationType": "BharatQR", "authorization": {}, "captureInfo": {}, "merchantInfo": {}, "attrs": {"channel": "BQR"} }{ "transactionState": "CAPTURED" }获取 Optima 合作伙伴 CRN
GET
/v1/benefits/contract-linksopenfinance读取已登录用户的 Optima 多福利合约,包括主、次 CRN、contractList 和 zetaUserID,用于将餐饮和礼品子钱包关联至 SuperCard。
认证方式: 在 Authorization 请求头中携带 Bearer 会话令牌。请求指定需要读取 Optima 福利合约的福利领取人。
- crn
- secondaryCRN
- contractList
- zetaUserID
GET /v1/benefits/contract-links HTTP/1.1 Authorization: Bearer <session-token> X-User-Id: user_88100214{ "crn": "crn_4401", "secondaryCRN": "crn_4401b", "contractList": "ct_optima_12,ct_gift_08", "zetaUserID": 88100214 }
数据类别
- 余额
- 交易
- 卡片
- 令牌
- 身份信息
- 身份核验(KYC)
- 商户
数据使用场景与案例
餐饮福利子钱包与薪资对账
人力资源或薪资机器人提取 productType 为 MEAL 的 cardPrograms,读取 amount、currency 和 cardState,将以派士计的剩余金额与雇主充值额核对,让财务团队在下一周期前掌握尚未使用的餐饮福利余额。
食堂消费明细账
费用管理团队针对各个 ledgerId 分页获取 getTransactions,将 amountInPaise、recordType 和 otherLegInfo.name 与食堂收据关联,并以 previousBalance、newBalance 持续核对餐饮福利子钱包的余额变化。
RuPay 令牌与 SuperCard 同步
卡片运营集成先列出 paymentInstruments,读取其中的 type(值为 SuperCard)、uniquingId 和 crn,再通过 getTokensForCardId 获取 tokenId、tokenStatus 和 merchantName,让已停用令牌和被冻结的实体卡与钱包卡片轮播视图保持同步。
Optima 合约接入
福利管理工具读取 Optima 合作伙伴调用返回的 zetaUserID、crn、secondaryCRN 和 contractList,再核对个人资料中的 kycDone 与 corpID,之后关联新的餐饮或礼品福利子钱包。
常见问题
这个 Pluxee India API 示例涵盖哪些餐卡数据?
示例钱包包含福利子钱包的 cardProgramID、productType、amount、currency、ledgerId 和 cardState,以及 SuperCard 的 maskedPan、crn 和 isPhysical。账单记录还包含 amountInPaise、recordType、previousBalance、newBalance,以及 otherLegInfo 中的交易对手详情。
如何验证福利钱包的访问身份?
手机号单点登录(SSO)后,会话初始化会提供 authToken 和 validTill。后续请求在 Authorization 请求头中携带 Bearer 会话令牌。加密卡片详情流程还需发送包含 userID、timestamp 和 clientPubKey 的已签名请求。此处路径和示例仅用于说明,并非 Pluxee 官方公开 API 文档;个人资料、钱包和卡片记录均须经授权后访问。
示例接口能展示交易明细与支付结果吗?
可以。账本历史使用 before 和 after 游标分页,包含 postingID、transactionID、amountInPaise、remarks 及余额变化。独立的支付状态视图还提供 state、banker.status、banker.failureReason 和回执。经授权的支付扣款返回 transactionState。
Optima 合约和 RuPay 令牌如何关联餐卡?
Optima 记录将 zetaUserID 与 crn、secondaryCRN 和 contractList 关联;卡片记录也包含 crn 和 contractId。令牌记录包含 tokenId、tokenStatus、modifiedAt 和 merchantName,可在接入福利合约的同时支持卡片与令牌同步。
与 Pluxee India: prev Sodexo-Zeta 相似的应用
- Zaggle — Zaggle 是印度的企业支出与员工福利平台,发行 Visa 和 RuPay 预付卡用于弹性福利,餐补等津贴可打入 Zaggle Save 卡,在线上或商户网点使用。
- Happay FlexiBenefits — Happay FlexiBenefits 是印度的员工税优福利卡,按食品、燃油、通讯、奖励和报销分钱包,并随雇主发薪周期充值。
- Advantage Club — Advantage Club 的 Advantage Meal Card 是面向日常开支和生活方式需求的税优餐卡与弹性福利,员工在 AdvantageClub.ai 应用中使用。
- Empuls — Xoxoday 旗下的 Empuls 提供用于节税和弹性消费的 Multi Benefits Card,并配有生活方式支出账户以及食品、燃油和出行等品牌折扣。
- Pluxee Brasil — Pluxee Brasil 是 Pluxee 在巴西的持卡人应用,覆盖餐补、食品及其他福利卡,可查询余额、账单和受理商户网络。
- Edenred Ticket Restaurant — Edenred(前 Accor Services)发行 Ticket Restaurant 员工餐券,并在 46 个国家运营,印度业务由原 Accentiv(现 Edenred India)承接。
相关主题
- Pluxee 印度 API
- Sodexo Zeta SuperCard
- 印度餐券余额
- RuPay 餐卡账本
- Optima CRN 合约
- Pluxee 印度数据 API
- 印度员工餐饮福利
- 福利 API 示例
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业