Wiipo API data: Flex pockets, holerite and ponto
Wiipo is Senior Sistemas' employee SuperApp for workers at Brazilian companies that issue Cartão Flex benefits and run Senior HCM. After a CPF-and-password sign-in, the bottom tabs open Flex (meal and food / Alimentação pockets plus a Swap virtual-card face), Home, a payslip (holerite) shelf, Social (climate-survey Moods, coworker feedback and Namu learning courses) and a menu that reaches férias receipts, GPS-and-face ponto punches, a driver's-journey status screen, and payroll-loan simulators for Creditas and Banco Pan consignado. Senior Sistemas, based in Blumenau, Santa Catarina, brands the client as Wiipo by Senior; version 5.3.17 ships React Native screens next to an embedded Flutter Marcação de Ponto collector. In Brazil it sits with Alelo, Ticket (Edenred), Flash Benefícios and VR on PAT-style wallets, and with Waapi on the same employer's HCM self-service.
Cartão Flex records separate card visibility in canViewValues from the Alimentação and Livre pocket balances identified by pocketName, pocketKey and pocketBalance. Pocket transfers retain sourcePocketId, destinationPocketId, amount and fee, alongside sourceBalanceAfter and destinationBalanceAfter. Holerite entries pair competence with lastSalary, netPay, inssBase and irpfBase; hasVacationReceipt marks associated vacation receipts, while reportUrl references the selected payroll PDF.
Ponto receipts carry employeeCpf, companyCnpj, identification, timeZone and outsideFence, with faceMatched recording the facial-match result. Daily totals add hoursWorkedToday, breaks, saldo and oddClockingEvent. Vacation receipts contain vacationDays, scheduledStartDate and returnToWorkDate, while Creditas or Banco Pan loan simulations bring together requestedAmount, installmentsNumber, installmentAmount and payrollDeduction.
Benefits platforms can compare Alimentação and Livre balances and trace pocket transfers when checking PAT meal allocations. Payroll bots can match holerite net pay and PDF references to bank credits from a separate ledger; attendance integrations can rebuild the cartão-ponto and flag off-geofence punches. Credit desks can compare proposed installments with the same worker’s payroll information. openData Studio turns these data objects into callable open data for those integrations.
Screenshots
API surface
Request/response examples are illustrative, reconstructed from the app's interface — not a live capture.
CPF worker session
POST
/v1/wiipo/auth/sessionosintMints the worker session used by Flex, holerite and ponto screens after the CPF + senha sign-in.
Auth: Unauthenticated. Body is cpf plus password and optional tenantDomain. Later calls send Authorization: Bearer from accessToken; refreshToken rotates the session.
- 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 snapshot
GET
/v1/wiipo/flex/cardopenfinanceLoads the signed-in worker's Cartão Flex face, PAN tail and whether values may be shown, plus the Swap secure-card viewer used for CVV.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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 benefit pockets
GET
/v1/wiipo/flex/pocketsopenfinanceLists Cartão Flex purses (Alimentação and free-spend) with BRL balances shown on the Flex home.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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 pocket transfer
POST
/v1/wiipo/flex/pockets/transferopenbankingMoves BRL between Flex pockets when the worker has enough free-pocket balance to cover amount plus fee.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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 }Holerite competence list
GET
/v1/wiipo/payslipsopendataPages holerite competences with last salary, INSS/IRPF bases and an optional vacation-receipt flag for the payslip tab.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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 } ] }Holerite PDF file
GET
/v1/wiipo/payslips/{competenceId}/fileopendataReturns the signed URL used by 'baixar/visualizar o holerite' for a selected competence.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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" }Ponto clocking punch
POST
/v1/wiipo/ponto/clocking-eventsopendataRegisters a GPS-and-face ponto punch and returns the comprovante fields (CPF, CNPJ, identification, fence flag) shown on the receipt card.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session. The embedded Marcação de Ponto collector also talks to Senior platform.senior.com.br bridge REST after the same worker session.
- 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" }Ponto hours and saldo
GET
/v1/wiipo/ponto/hoursopendataReturns today's hours totalizer, break time, hour-bank saldo and whether the day's punches are odd — the Hours tab next to Marcações.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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 }Férias receipt summary
GET
/v1/wiipo/vacation/receiptsopendataLists Recibo de Férias rows (days, start, retorno ao trabalho) shown on the vacation empty/error states and payslip-with-vacations toggle.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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" } ] }Payroll-loan simulation
POST
/v1/wiipo/payroll-loans/simulationsopendataQuotes a consignado / payroll-deducted loan with Creditas or Banco Pan using installment count and the worker CPF.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session. Partner consents (CNPJ / SCR) are collected before quote.
- 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 }Worker profile
GET
/v1/wiipo/profileosintReads the Meu perfil card used by payroll onboarding (marital status, address type, personal rather than corporate email).
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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" }Climate-survey mood
POST
/v1/wiipo/climate-survey/moodsopendataStores today's climate-survey (Moods) feeling from the Social tab; a second submit the same day is rejected.
Auth: Bearer accessToken from POST /v1/wiipo/auth/session.
- 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" }
Data categories
- authentication
- flex card
- benefit pockets
- pocket transfers
- payslips / holerite
- clock punches
- hour bank
- vacation receipts
- payroll loans
- employee profile
- climate survey
Where teams use this data
PAT Flex pocket reconciliation
A benefits platform pulls pocketName, pocketKey and pocketBalance for Alimentação versus Livre purses and flags canTransferOut moves that would mix PAT meal spend with free-pocket cash.
Holerite-to-ledger close
Payroll bots read lastSalary, netPay, inssBase and irpfBase per competence and match the holerite PDF reportUrl to the worker's bank credit before closing the month.
eSocial-ready ponto ledger
Time-and-attendance software ingests punches with employeeCpf, companyCnpj, identification, timeZone and outsideFence so Brazilian employers can rebuild the cartão-ponto and flag off-geofence marks.
Consignado installment check
A credit desk quotes Creditas or Banco Pan using installmentsNumber and requestedAmount, then stores payrollDeduction against the same CPF on the worker profile.
Frequently asked questions
What Flex card and pocket fields does Wiipo provide?
Card records include status, lastFour, canViewValues and swapViewerUrl for the Swap secure-card viewer. Pocket records list pocketName, pocketKey, pocketBalance, currency and canTransferOut for Alimentação and Livre balances. Transfers include sourcePocketId, destinationPocketId, amount, fee and both post-transfer balances; the free-pocket balance must cover the amount plus fee.
Which holerite and vacation fields are available?
Holerite entries identify the payroll month with competenceId and competence and include lastSalary, netPay, inssBase and irpfBase in BRL. The withVacations option includes vacation receipts, while hasVacationReceipt and fileAvailable indicate receipt and file availability. The PDF record provides reportUrl and expiresAt. Vacation receipts add vacationDays, scheduledStartDate and returnToWorkDate.
Which ponto fields support an attendance ledger?
Punch receipts include employeeCpf, companyCnpj, identification, date, time, timeZone, outsideFence, faceMatched and syncStatus. Punch submissions also include livenessPassed. Daily summaries provide hoursWorkedToday, breaks, saldo, lastClockingEvent, oddClockingEvent and espelhoAvailable, supporting a cartão-ponto ledger and checks for off-geofence punches or an odd number of clocking events.
How is access to Wiipo employee data authenticated?
Session creation uses cpf and password, with an optional tenantDomain. Subsequent Flex, holerite and ponto requests carry accessToken as a Bearer token; refreshToken renews the session. The Marcação de Ponto collector syncs clocking records through the Senior X bridge using the worker session. Payroll-loan quotes additionally require partner CNPJ/SCR consent.
Apps similar to Wiipo
- Meu Alelo — Meu Alelo is Alelo's worker app for Brazilian meal, food and other benefit cards, used to check balances and statements and to pay at accepting merchants.
- Flash | Benefícios e Despesas — Flash | Benefícios e Despesas is Flash's Brazilian multi-benefit and corporate-spending card, combining PAT meal and food wallets with expense management on a Visa card.
- Ticket — Ticket is Edenred's Brazilian worker app for PAT vale-alimentação and vale-refeição, used to check balance, statements and the accredited merchant network.
- SuperApp VR — SuperApp VR is VR Benefícios' worker app for PAT meal and food balances, virtual-card and QR payments, and one-tap time clock (ponto).
- Pluxee Brasil — Pluxee Brasil, formerly Sodexo Benefícios e Incentivos, is the cardholder app for Pluxee PAT vale-alimentação and vale-refeição plus other corporate benefit cards.
- iFood Benefícios — iFood Benefícios puts alimentação, refeição, mobility, culture, home-office, education and reward wallets on one Elo card and tracks those balances in the worker app.
- Waapi - HCM Senior — Waapi is Senior Sistemas' employee app for companies on Senior HCM, used to open payslips (holerite), view the professional profile and employment contract, and handle other self-service tasks.
- Caju — Caju is a Brazilian multi-benefit Visa card and app that centralizes CLT and PAT benefit balances together with expense and people-management tools.
Topics
- Wiipo API
- Wiipo Flex API
- Cartão Flex benefits
- holerite payroll data
- ponto Senior attendance
- PAT benefit pockets
- Creditas payroll loans
- Banco Pan consignado
- Marcação de Ponto
Need this app's data API integrated?
We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.
- NDA + SOW on every engagement
- Delivery in 3–7 days
- Payment only after acceptance
- Work scoped to authorized use