Wiipo API 数据：Flex 子钱包、工资单与考勤

Senior Sistemas · 支付

Wiipo 是 Senior Sistemas 面向巴西企业员工推出的 SuperApp，适用于发放 Cartão Flex 福利卡并使用 Senior HCM 的企业。员工用 CPF 与密码登录后，可通过底部标签页进入 Flex（含餐饮、Alimentação 食品消费子钱包和 Swap 虚拟卡卡面）、首页、工资单（holerite）及 Social 社交区；Social 集中了 Moods 组织氛围调查、同事反馈和 Namu 学习课程，菜单还提供 férias 休假收据、结合 GPS 与人脸识别的 ponto 考勤打卡、司机行程状态，以及 Creditas 和 Banco Pan 的 consignado 工资代扣贷款试算。Senior Sistemas 总部位于巴西圣卡塔琳娜州布卢梅瑙，以“Wiipo by Senior”品牌提供此应用；5.3.17 版同时包含 React Native 界面与内嵌的 Flutter Marcação de Ponto 打卡采集器。在巴西市场，Wiipo 的 PAT 类福利钱包与 Alelo、Ticket（Edenred）、Flash Benefícios 和 VR 同属一类，而在人力资源自助服务方面，它与 Waapi 服务于同一雇主的 HCM 体系。

Cartão Flex 记录以 canViewValues 表示卡片金额是否可见，Alimentação 与 Livre 子钱包则通过 pocketName、pocketKey 和 pocketBalance 标识类别与余额。子钱包转账保留 sourcePocketId、destinationPocketId、amount 和 fee，并提供划转后的 sourceBalanceAfter 与 destinationBalanceAfter。工资单记录将所属月份 competence 与 lastSalary、netPay、inssBase 和 irpfBase 对应起来；hasVacationReceipt 标识关联休假收据，reportUrl 则指向所选月份的工资单 PDF。

考勤凭证包含 employeeCpf、companyCnpj、identification、timeZone 和 outsideFence，并以 faceMatched 记录人脸匹配结果。每日工时汇总另有 hoursWorkedToday、breaks、saldo 和 oddClockingEvent。休假收据提供 vacationDays、scheduledStartDate 与 returnToWorkDate；Creditas 或 Banco Pan 的贷款试算则汇集 requestedAmount、installmentsNumber、installmentAmount 和 payrollDeduction。

福利平台可比较 Alimentação 与 Livre 余额并追踪子钱包划转，用于核查 PAT 餐饮福利分配。薪资自动化程序可将工资单实发金额及 PDF 引用与外部账簿中的银行入账记录匹配；考勤集成可据此重建 cartão-ponto 考勤卡并标记围栏外打卡。信贷团队可结合该员工的薪资信息比较拟议分期方案。openData Studio 将这些数据对象转化为支持上述集成的可调用开放数据。

应用截图

API 端点一览

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

CPF 员工登录会话
POST /v1/wiipo/auth/session osint
员工通过 CPF 与密码登录后，创建供 Flex、工资单（holerite）和考勤（ponto）界面使用的会话。
认证方式：此请求无需预先认证。请求体包含 cpf、password，以及可选的 tenantDomain。后续请求将 accessToken 放入 Authorization: Bearer 请求头，refreshToken 用于轮换会话。
- cpf
- password
- tenantDomain
- scope
- accessToken
- refreshToken
- tokenType
- expiresIn
- fullName
- waapiUsername
- locale
```
POST /v1/wiipo/auth/session HTTP/1.1
Content-Type: application/json
Accept-Language: pt-BR

{
  "cpf": "12345678901",
  "password": "******",
  "tenantDomain": "acme.hcm",
  "scope": "mobile"
}
```
```
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.wiipo",
  "refreshToken": "rt_wiipo_9f21",
  "tokenType": "Bearer",
  "expiresIn": 3600,
  "fullName": "Ana Silva",
  "cpf": "12345678901",
  "tenantDomain": "acme.hcm",
  "waapiUsername": "[email protected]",
  "locale": "pt-BR"
}
```
Cartão Flex 卡片概览
GET /v1/wiipo/flex/card openfinance
加载已登录员工的 Cartão Flex 卡面、卡号尾号、是否允许显示金额，以及用于查看 CVV 的 Swap 安全卡片查看器。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- cardId
- product
- status
- canViewValues
- lastFour
- holderName
- brand
- swapViewerUrl
- needsPasswordReset
```
GET /v1/wiipo/flex/card HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "cardId": "flex_44102",
  "product": "WIIPO_FLEX",
  "status": "ACTIVE",
  "canViewValues": true,
  "lastFour": "8821",
  "holderName": "ANA SILVA",
  "brand": "Mastercard",
  "swapViewerUrl": "https://api.swapcards.com.br/beta_v3/secure-card-viewer",
  "needsPasswordReset": false
}
```

Flex 福利子钱包

GET /v1/wiipo/flex/pockets openfinance

列出 Cartão Flex 的 Alimentação 餐食子钱包和自由消费子钱包，以及 Flex 首页显示的巴西雷亚尔（BRL）余额。

认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。

cardId
pockets
pocketId
pocketName
pocketKey
pocketBalance
currency
canTransferOut

GET /v1/wiipo/flex/pockets HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "cardId": "flex_44102",
  "pockets": [
    {
      "pocketId": "pkt_alimentacao",
      "pocketName": "Alimentação",
      "pocketKey": "ALIMENTACAO",
      "pocketBalance": 842.50,
      "currency": "BRL",
      "canTransferOut": true
    },
    {
      "pocketId": "pkt_livre",
      "pocketName": "Livre",
      "pocketKey": "FREE",
      "pocketBalance": 120.00,
      "currency": "BRL",
      "canTransferOut": true
    }
  ]
}

Flex 子钱包间转账

POST /v1/wiipo/flex/pockets/transfer openbanking

当自由子钱包余额足以支付转账金额及手续费时，在 Flex 子钱包之间划转巴西雷亚尔。

认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。

sourcePocketId
destinationPocketId
amount
currency
transferId
fee
status
sourceBalanceAfter
destinationBalanceAfter

POST /v1/wiipo/flex/pockets/transfer HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "sourcePocketId": "pkt_livre",
  "destinationPocketId": "pkt_alimentacao",
  "amount": 50.00,
  "currency": "BRL"
}

{
  "transferId": "trx_flex_19c2",
  "sourcePocketId": "pkt_livre",
  "destinationPocketId": "pkt_alimentacao",
  "amount": 50.00,
  "fee": 0.00,
  "status": "SETTLED",
  "sourceBalanceAfter": 70.00,
  "destinationBalanceAfter": 892.50
}

工资单所属月份列表
GET /v1/wiipo/payslips opendata
为工资单标签页分页列出各所属月份的 holerite，包含最近工资、INSS 与 IRPF 计税基数，并可附带是否有休假收据的标记。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- withVacations
- competenceId
- competence
- lastSalary
- netPay
- inssBase
- irpfBase
- currency
- hasVacationReceipt
- fileAvailable
```
GET /v1/wiipo/payslips?withVacations=true HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "items": [
    {
      "competenceId": "2026-09",
      "competence": "09/2026",
      "lastSalary": 4820.15,
      "netPay": 4820.15,
      "inssBase": 5100.00,
      "irpfBase": 4200.00,
      "currency": "BRL",
      "hasVacationReceipt": false,
      "fileAvailable": true
    }
  ]
}
```
工资单 PDF 文件
GET /v1/wiipo/payslips/{competenceId}/file opendata
返回所选工资所属月份的签名链接，供“baixar/visualizar o holerite”（下载或预览工资单）功能使用。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- competenceId
- fileType
- fileName
- reportUrl
- expiresAt
```
GET /v1/wiipo/payslips/2026-09/file HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/pdf
```
```
{
  "competenceId": "2026-09",
  "fileType": "PDF",
  "fileName": "holerite-2026-09.pdf",
  "reportUrl": "https://wiipo.senior.com.br/holerite/index.html?competence=2026-09",
  "expiresAt": "2026-10-23T18:00:00Z"
}
```

考勤打卡登记

POST /v1/wiipo/ponto/clocking-events opendata

登记结合 GPS 与人脸识别的考勤打卡，并返回凭证卡上显示的 CPF、CNPJ、记录标识及是否位于地理围栏外等字段。

认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。内嵌的 Marcação de Ponto 打卡采集器在同一员工会话建立后，也通过 Senior 平台的桥接 REST 服务通信。

latitude
longitude
outsideFence
faceMatched
livenessPassed
capturedAt
identification
date
time
timeZone
employeeName
employeeCpf
companyName
companyCnpj
origin
syncStatus

POST /v1/wiipo/ponto/clocking-events HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "latitude": -26.9194,
  "longitude": -49.0661,
  "outsideFence": false,
  "faceMatched": true,
  "livenessPassed": true,
  "capturedAt": "2026-10-23T12:01:04-03:00"
}

{
  "identification": "PNT-20261023-120104",
  "date": "2026-10-23",
  "time": "12:01:04",
  "timeZone": "America/Sao_Paulo",
  "employeeName": "Ana Silva",
  "employeeCpf": "12345678901",
  "companyName": "Acme Ltda",
  "companyCnpj": "12345678000199",
  "outsideFence": false,
  "faceMatched": true,
  "origin": "MOBILE",
  "syncStatus": "SYNCED"
}

工时与工时银行余额
GET /v1/wiipo/ponto/hours opendata
返回当天累计工时、休息时长、工时银行余额，以及当天打卡次数是否为奇数；这些内容显示在“Marcações”（打卡记录）旁的“Horas”（工时）标签页。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- date
- hoursWorkedToday
- breaks
- saldo
- lastClockingEvent
- oddClockingEvent
- espelhoAvailable
```
GET /v1/wiipo/ponto/hours?date=2026-10-23 HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "date": "2026-10-23",
  "hoursWorkedToday": "08:12",
  "breaks": "01:00",
  "saldo": "+00:24",
  "lastClockingEvent": {
    "time": "12:01:04",
    "origin": "MOBILE"
  },
  "oddClockingEvent": false,
  "espelhoAvailable": true
}
```
休假收据概览
GET /v1/wiipo/vacation/receipts opendata
列出 Recibo de Férias 休假收据的天数、开始日期与返岗日期，对应休假空状态及错误提示界面，以及工资单中包含休假收据的开关。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- receiptId
- competence
- vacationDays
- scheduledStartDate
- returnToWorkDate
- status
- fileType
```
GET /v1/wiipo/vacation/receipts HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "items": [
    {
      "receiptId": "fer_2026_1",
      "competence": "01/2026",
      "vacationDays": 30,
      "scheduledStartDate": "2026-01-05",
      "returnToWorkDate": "2026-02-04",
      "status": "PAID",
      "fileType": "PDF"
    }
  ]
}
```

工资代扣贷款试算

POST /v1/wiipo/payroll-loans/simulations opendata

使用分期期数和员工 CPF，向 Creditas 或 Banco Pan 试算 consignado 工资代扣贷款方案。

认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。报价前需取得合作方要求的 CNPJ / SCR 相关授权。

partner
requestedAmount
installmentsNumber
cpf
simulationId
installmentAmount
payrollDeduction
status
monthlyCeiling

POST /v1/wiipo/payroll-loans/simulations HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "partner": "CREDITAS",
  "requestedAmount": 5000.00,
  "installmentsNumber": 12,
  "cpf": "12345678901"
}

{
  "simulationId": "sim_pan_88",
  "partner": "CREDITAS",
  "requestedAmount": 5000.00,
  "installmentsNumber": 12,
  "installmentAmount": 478.90,
  "payrollDeduction": true,
  "status": "QUOTED",
  "monthlyCeiling": 1032.25
}

员工个人资料
GET /v1/wiipo/profile osint
读取工资业务开户流程使用的“Meu perfil”（我的资料）卡片，包括婚姻状态、地址类型，以及个人而非企业电子邮箱。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- fullName
- cpf
- personalEmail
- maritalStatus
- addressType
- city
- uf
```
GET /v1/wiipo/profile HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "fullName": "Ana Silva",
  "cpf": "12345678901",
  "personalEmail": "[email protected]",
  "maritalStatus": "SINGLE",
  "addressType": "RESIDENTIAL",
  "city": "Blumenau",
  "uf": "SC"
}
```
组织氛围心情调查
POST /v1/wiipo/climate-survey/moods opendata
保存员工从 Social 标签页提交的当天 Moods 组织氛围调查心情；同一天再次提交会被拒绝。
认证方式：使用 POST /v1/wiipo/auth/session 返回的 accessToken，以 Bearer 方式认证。
- mood
- language
- notes
- accepted
- alreadyAnswered
- survey
```
POST /v1/wiipo/climate-survey/moods HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "mood": "HAPPY",
  "language": "pt-BR",
  "notes": "Sprint delivered"
}
```
```
{
  "accepted": true,
  "alreadyAnswered": false,
  "survey": "MOODS"
}
```

数据类别

身份认证
Flex 福利卡
福利子钱包
子钱包间转账
工资单（holerite）
考勤打卡
工时银行
休假收据
工资代扣贷款
员工个人资料
组织氛围调查

数据使用场景与案例

PAT Flex 子钱包对账
福利平台读取 Alimentação 与 Livre 子钱包的 pocketName、pocketKey 和 pocketBalance，并标记可能将 PAT 餐饮福利消费与自由子钱包资金混用的 canTransferOut 转出操作。
工资单与账簿月结核对
薪资自动化程序按工资所属月份读取 lastSalary、netPay、inssBase 和 irpfBase，在月结前将工资单 PDF 的 reportUrl 与员工银行入账记录对应。
面向 eSocial 的考勤台账
工时考勤软件接收带有 employeeCpf、companyCnpj、identification、timeZone 和 outsideFence 的打卡记录，帮助巴西雇主重建 cartão-ponto 考勤卡，并标记地理围栏外的打卡。
工资代扣贷款分期核验
信贷业务团队使用 installmentsNumber 和 requestedAmount 向 Creditas 或 Banco Pan 试算贷款方案，再将 payrollDeduction 记录关联到员工资料中的同一 CPF。

常见问题

Wiipo 提供哪些 Flex 福利卡和子钱包字段？

卡片记录包含 status、lastFour、canViewValues，以及用于 Swap 安全卡片查看器的 swapViewerUrl。子钱包记录通过 pocketName、pocketKey、pocketBalance、currency 和 canTransferOut 描述 Alimentação 与 Livre 余额。转账记录包含 sourcePocketId、destinationPocketId、amount、fee 及两侧划转后余额；自由子钱包的余额必须足以支付金额和手续费。

工资单与休假收据包含哪些字段？

工资单以 competenceId 和 competence 标识所属月份，并提供以 BRL 计价的 lastSalary、netPay、inssBase 和 irpfBase。withVacations 选项用于包含休假收据，hasVacationReceipt 与 fileAvailable 分别表示关联休假收据及文件是否可用。PDF 记录提供 reportUrl 与 expiresAt，休假收据另有 vacationDays、scheduledStartDate 和 returnToWorkDate。

哪些考勤字段可用于构建考勤台账？

打卡凭证包含 employeeCpf、companyCnpj、identification、date、time、timeZone、outsideFence、faceMatched 和 syncStatus，打卡提交还包含 livenessPassed。每日汇总提供 hoursWorkedToday、breaks、saldo、lastClockingEvent、oddClockingEvent 与 espelhoAvailable，可用于构建 cartão-ponto 考勤台账，检查围栏外打卡或打卡次数为奇数的情况。

访问 Wiipo 员工数据需要怎样的身份认证？

创建会话需要 cpf 和 password，并可选填 tenantDomain。后续 Flex、工资单与考勤请求以 Bearer 方式携带 accessToken，refreshToken 用于续期会话。Marcação de Ponto 采集器使用员工会话，通过 Senior X 桥接服务同步打卡记录。工资代扣贷款报价还要求取得合作方的 CNPJ/SCR 相关授权。

与 Wiipo 相似的应用

Meu Alelo — Meu Alelo 是 Alelo 面向巴西职工的应用，用于餐补、食品及其他福利卡，可查询余额和账单，并在受理商户付款。
Flash | Benefícios e Despesas — Flash | Benefícios e Despesas 是 Flash 面向巴西企业的多福利与对公支出卡，把 PAT 餐补和食品钱包与费用报销放在一张 Visa 卡上管理。
Ticket — Ticket 是 Edenred 在巴西的职工应用，覆盖 PAT 食品券（vale-alimentação）和餐券（vale-refeição），用来查余额、账单和受理商户网络。
SuperApp VR — SuperApp VR 是 VR Benefícios 面向职工的应用，用来查看 PAT 餐补和食品余额、用虚拟卡或二维码付款，并一键打卡考勤（ponto）。
Pluxee Brasil — Pluxee Brasil（原 Sodexo Benefícios e Incentivos）是 Pluxee 的 PAT 食品券与餐券及其他企业福利卡的持卡人应用。
iFood Benefícios — iFood Benefícios 把食品、餐补、出行、文化、居家办公、教育和奖励等钱包放在一张 Elo 卡上，并在职工应用里查看各钱包余额。
Waapi - HCM Senior — Waapi 是 Senior Sistemas 为使用 Senior HCM 的企业员工提供的应用，用来查看工资单（holerite）、职业档案与劳动合同，并办理其他员工自助事项。
Caju — Caju 是巴西的多福利 Visa 卡和应用，把 CLT 与 PAT 福利余额以及费用与人事管理放在同一平台。

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

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

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

获取报价

Wiipo API 数据：Flex 子钱包、工资单与考勤

应用截图

API 端点一览

CPF 员工登录会话

Cartão Flex 卡片概览

Flex 福利子钱包

Flex 子钱包间转账

工资单所属月份列表

工资单 PDF 文件

考勤打卡登记

工时与工时银行余额

休假收据概览

工资代扣贷款试算

员工个人资料

组织氛围心情调查

数据类别

数据使用场景与案例

PAT Flex 子钱包对账

工资单与账簿月结核对

面向 eSocial 的考勤台账

工资代扣贷款分期核验

常见问题

与 Wiipo 相似的应用

更多支付类应用

BharatPe for Business

BukuWarung Apps for MSMEs

C3Pay

CashBook - Balance & Expense

相关主题

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

Wiipo API 数据：Flex 子钱包、工资单与考勤

应用截图

API 端点一览

CPF 员工登录会话

Cartão Flex 卡片概览

Flex 福利子钱包

Flex 子钱包间转账

工资单所属月份列表

工资单 PDF 文件

考勤打卡登记

工时与工时银行余额

休假收据概览

工资代扣贷款试算

员工个人资料

组织氛围心情调查

数据类别

数据使用场景与案例

PAT Flex 子钱包对账

工资单与账簿月结核对

面向 eSocial 的考勤台账

工资代扣贷款分期核验

常见问题

相关应用

与 Wiipo 相似的应用

更多支付类应用

BharatPe for Business

BukuWarung Apps for MSMEs

C3Pay

CashBook - Balance & Expense

相关主题

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