Wiipo icon

Wiipo API data: Flex pockets, holerite and ponto

Senior Sistemas · Payments

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

  • Wiipo screenshot 1
  • Wiipo screenshot 2
  • Wiipo screenshot 3
  • Wiipo screenshot 4
  • Wiipo screenshot 5
  • Wiipo screenshot 6
  • Wiipo screenshot 7
  • Wiipo screenshot 8

API surface

Request/response examples are illustrative, reconstructed from the app's interface — not a live capture.

  • CPF worker session

    POST /v1/wiipo/auth/session osint

    Mints 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/card openfinance

    Loads 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/pockets openfinance

    Lists 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/transfer openbanking

    Moves 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/payslips opendata

    Pages 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}/file opendata

    Returns 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-events opendata

    Registers 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/hours opendata

    Returns 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/receipts opendata

    Lists 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/simulations opendata

    Quotes 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/profile osint

    Reads 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/moods opendata

    Stores 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

Get a quote