SuperApp VR 的 PAT 卡、余额与打卡接口

VR Benefícios · 支付 4.8 ★

SuperApp VR 是 VR Benefícios 面向巴西职工的超级应用，覆盖 PAT 餐券与食品券（Refeição、Alimentação、Auxílio Home Office、Auto、Premiações），以及 marketplace cashback、Uber 券、FGTS 周年取款预支和 Crédito do Trabalhador 薪资贷。用户凭 CPF 登录后，首页展示 Meus Saldos、extrato、带二维码结账的虚拟卡、PIX 密钥和受理商户地图；独立 Pontomais 客户端停用后，打卡、工资单（holerite）、排班与休假也并入同一应用。VR Benefícios（CNPJ 02.535.864/0001-33）担任 Banco VR 的银行业务通讯员。Play 评分 4.82（约 29.7 万条评价），下载量 10M+，与 Alelo、Pluxee Brasil、Ticket（Edenred）、Caju 和 Flash Benefícios 争夺同一批 PAT 钱包。

Refeição 与 Alimentação 卡面带着 numeroCartao，旁边是 tipoProduto、statusCartao 以及钱袋合计 availableBalance / saldoFuturo。多余额扣款顺序落在 prioridade；PIX 提现密钥在 chavePix；虚拟卡 PAN 以 dadosCriptografados 出现，并用 chavePublica 解包。

受理商户行带有 cnpj、nomeFantasia 以及地图 latitude / longitude。Pontomais 打卡按 employeeId 同步，同一会话还能取 holerite。薪资对账、覆盖地图和考勤机器人会消费这些字段；openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

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

签发职工 access token
POST /v1/auth/tokens osint
用职工 CPF 与密码换取后续 SuperApp 调用所需的 accessToken / refreshToken。
认证方式：登录前无需令牌。职工 CPF 与密码经密码授权并附带网关 client_id 头换取；返回的 Bearer accessToken 与 refreshToken 用于之后的每次调用。
- accessToken
- refreshToken
- tokenType
- expiresIn
- issuer
- grant_type
- username
- client_id
```
POST /v1/auth/tokens HTTP/1.1
client_id: <client-id>
Content-Type: application/x-www-form-urlencoded

grant_type=password&username=12345678909&password=<password>&issuer=vrpat
```
```
{
  "accessToken": "<jwt-access-token>",
  "refreshToken": "rt_9f21c7",
  "tokenType": "Bearer",
  "expiresIn": 3600,
  "issuer": "vrpat"
}
```

按 CPF 拉取职工入职档案

GET /v1/onboarding/workers/lookup osint

按 CPF 查找入职用户行（email、telefone、celular），供职工完成首次访问。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

cpf
email
emailUsuario
telefone
celular
nome
status

GET /v1/onboarding/workers/lookup?cpf=12345678909 HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "cpf": "12345678909",
  "email": "[email protected]",
  "emailUsuario": "[email protected]",
  "telefone": "11987654321",
  "celular": "11987654321",
  "nome": "Ana Souza",
  "status": "ATIVO"
}

查找职工档案

GET /v1/workers/me/profile osint

返回首页所用的登录职工 userProfile：CPF、email、telefone、productType 以及已登记的 chavePix。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

profileId
cpf
email
telefone
chavePix
productType
userProfile
holderName

GET /v1/workers/me/profile HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "profileId": "prf_4412",
  "cpf": "12345678909",
  "email": "[email protected]",
  "telefone": "11987654321",
  "chavePix": "12345678909",
  "productType": "REFEICAO",
  "userProfile": {
    "nome": "Ana Souza",
    "holderName": "ANA SOUZA"
  }
}

列出实体福利卡

GET /v1/cards/physical openfinance

列出受益人名下每张 PAT 实体卡：numeroCartao 尾号、tipoProduto（Refeição、Alimentação、Home Office、Auto、Premiações）、statusCartao 以及钱袋合计 availableBalance / saldoFuturo。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

idCartao
cardId
numeroCartao
lastDigits
lastFour
tipoProduto
codigoProduto
statusCartao
isVirtual
portador
holderName
availableBalance
saldoFuturo

GET /v1/cards/physical HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "cartoes": [
    {
      "idCartao": "crd_88100214",
      "cardId": "crd_88100214",
      "numeroCartao": "650485******4419",
      "lastDigits": "4419",
      "lastFour": "4419",
      "tipoProduto": "REFEICAO",
      "codigoProduto": "VRPAT",
      "statusCartao": "ATIVO",
      "isVirtual": false,
      "portador": "ANA SOUZA",
      "holderName": "ANA SOUZA",
      "availableBalance": 842.50,
      "saldoFuturo": 200.00
    }
  ]
}

开卡公钥
GET /v1/cards/enrollment/public-key openbanking
返回实体卡 encarteiramento 时用来封装 PAN/CVV 的 RSA chavePublica。
认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。
- chavePublica
- encarteiramento
- codigoProduto
```
GET /v1/cards/enrollment/public-key HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json
```
```
{
  "chavePublica": "<rsa-public-key-pem>",
  "encarteiramento": "ENC-20261020-4419",
  "codigoProduto": "VRPAT"
}
```

虚拟卡详情

GET /v1/cards/virtual/details openbanking

在卡片 positivado 之后展开屏幕上的虚拟卡：lastDigits、cvv、validade 与 dadosCriptografados。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

idCartao
numeroCartao
lastDigits
cvv
validade
isVirtual
virtualCard
statusCartao
dadosCriptografados
chavePublica
positivado

GET /v1/cards/virtual/details HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "idCartao": "crd_v_9021",
  "numeroCartao": "650485******7781",
  "lastDigits": "7781",
  "cvv": "<wrapped-cvv>",
  "validade": "12/28",
  "isVirtual": true,
  "virtualCard": true,
  "statusCartao": "ATIVO",
  "dadosCriptografados": "<encrypted-card-payload>",
  "chavePublica": "<rsa-public-key-pem>",
  "positivado": true
}

冻结虚拟卡

POST /v1/cards/virtual/block openfinance

挂失或用户冻结后锁住虚拟 PAT 卡，将 statusCartao 置为 BLOQUEADO。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

idCartao
numeroCartao
lastDigits
statusCartao
isVirtual

POST /v1/cards/virtual/block HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Content-Type: application/json

{
  "idCartao": "crd_v_9021",
  "numeroCartao": "650485******7781",
  "lastDigits": "7781"
}

{
  "idCartao": "crd_v_9021",
  "statusCartao": "BLOQUEADO",
  "isVirtual": true,
  "lastDigits": "7781"
}

受理商户名录

GET /v1/merchants/accepted opendata

列出职工附近受理 VR 的 estabelecimentos：cnpj、razaoSocial、nomeFantasia 以及地图 latitude / longitude。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

cnpj
razaoSocial
nomeFantasia
latitude
longitude
tipoProduto
bandeira

GET /v1/merchants/accepted?latitude=-23.5505&longitude=-46.6333 HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "estabelecimentos": [
    {
      "cnpj": "00.000.000/0001-91",
      "razaoSocial": "PADARIA CENTRO LTDA",
      "nomeFantasia": "Padaria Centro",
      "latitude": -23.5505,
      "longitude": -46.6333,
      "tipoProduto": "REFEICAO",
      "bandeira": "Elo"
    }
  ]
}

多余额支出优先级

GET /v1/beneficiaries/{idBeneficiario}/purse-order openfinance

读取职工的 contas-prioridades：多卡共享一次 POS 时先扣哪只 PAT 钱袋（configuracao_prioridade_multisaldo）。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

idBeneficiario
idCartao
tipoProduto
prioridade
availableBalance
saldoFuturo
multisaldo

GET /v1/beneficiaries/ben_7731/purse-order HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "idBeneficiario": "ben_7731",
  "contas": [
    {
      "idCartao": "crd_88100214",
      "tipoProduto": "REFEICAO",
      "prioridade": 1,
      "availableBalance": 842.50,
      "saldoFuturo": 200.00,
      "multisaldo": true
    },
    {
      "idCartao": "crd_88100215",
      "tipoProduto": "ALIMENTACAO",
      "prioridade": 2,
      "availableBalance": 310.00,
      "saldoFuturo": 0,
      "multisaldo": true
    }
  ]
}

同步 Pontomais 打卡

POST /v1/attendance/punches/sync opendata

在独立 Pontomais 客户端停用后，把职工打卡（entrada / saida）推入 SuperApp。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

employeeId
synced
timeCards
date
entrada
saida
latitude
longitude

POST /v1/attendance/punches/sync HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Content-Type: application/json

{
  "employeeId": "emp_10482",
  "latitude": -23.5505,
  "longitude": -46.6333
}

{
  "employeeId": "emp_10482",
  "synced": true,
  "timeCards": [
    {
      "date": "2026-10-20",
      "entrada": "08:01",
      "saida": "17:32"
    }
  ]
}

HCM 工资单
GET /v1/payroll/payslips openfinance
列出登录员工的 Pontomais HCM 工资单（holerite）：competencia 与实发 valorTransacao。
认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。
- employeeId
- holerites
- competencia
- valorLiquido
- valorTransacao
```
GET /v1/payroll/payslips HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json
```
```
{
  "employeeId": "emp_10482",
  "holerites": [
    {
      "competencia": "2026-09",
      "valorLiquido": 4120.55,
      "valorTransacao": 4120.55
    }
  ]
}
```

职工薪资贷报价

GET /v1/credit/payroll/offers openfinance

返回该 CPF 的 Crédito do Trabalhador 报价，含 valorSolicitado 与 valorTransacao。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

cpf
ofertas
produto
valorSolicitado
valorTransacao
prazoMeses

GET /v1/credit/payroll/offers HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json

{
  "cpf": "12345678909",
  "ofertas": [
    {
      "produto": "CREDITO_TRABALHADOR",
      "valorSolicitado": 1500.00,
      "valorTransacao": 1915.92,
      "prazoMeses": 12
    }
  ]
}

Apple Wallet 令牌状态
GET /v1/cards/wallet-tokens/status openfinance
读取 PAT 实体卡是否已写入 Apple Wallet，供补卡或冻结前核对。
认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。
- idCartao
- lastDigits
- status
- isVirtual
```
GET /v1/cards/wallet-tokens/status HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Accept: application/json
```
```
{
  "idCartao": "crd_88100214",
  "lastDigits": "4419",
  "status": "ACTIVE",
  "isVirtual": false
}
```

二维码卡支付

POST /v1/payments/qr openfinance

用已 positivado 的 PAT 卡支付合作商户二维码，返回 transactionId 与 valorTransacao。

认证方式：登录调用签发的 Bearer accessToken，每次请求另附网关 client_id 头。

idCartao
numeroCartao
valorTransacao
chavePix
transactionId
statusCartao
positivado

POST /v1/payments/qr HTTP/1.1
Authorization: Bearer <accessToken>
client_id: <client-id>
Content-Type: application/json

{
  "idCartao": "crd_88100214",
  "numeroCartao": "650485******4419",
  "valorTransacao": 42.90,
  "chavePix": null
}

{
  "transactionId": "txn_9c41",
  "valorTransacao": 42.90,
  "statusCartao": "ATIVO",
  "positivado": true,
  "idCartao": "crd_88100214"
}

数据类别

卡片余额
受益人档案
虚拟卡
受理商户
考勤打卡
工资单
薪资贷

数据使用场景与案例

PAT 钱袋对账
薪资台每晚拉取 numeroCartao、tipoProduto、availableBalance 与 saldoFuturo，再把多余额行上的 prioridade 对上雇主的 PAT 注资文件。
受理网络覆盖
拓展团队按办公室周边的 cnpj、nomeFantasia、latitude、longitude 检索，确认附近是否受理 VR Refeição 与 VR Alimentação。
Pontomais 考勤接入
人事机器人同步 employeeId 打卡（entrada / saida）和 holerite 的 valorTransacao，让考勤与工资在 Pontomais 并入 SuperApp VR 后仍落在同一职工记录上。
虚拟卡与 Apple Wallet 审计
设备车队工具在补卡或冻结（statusCartao BLOQUEADO）前读取 dadosCriptografados、chavePublica 与 Apple Wallet 令牌状态。

常见问题

哪些 SuperApp VR 产品会显示卡片和余额？

实体卡列表按 tipoProduto 返回 Refeição、Alimentação、Auxílio Home Office、Auto 与 Premiações，每张带 numeroCartao、lastDigits、statusCartao、availableBalance 与 saldoFuturo。

应用是否仍提供 Pontomais 打卡？

是。独立 Pontomais 客户端停用后，打卡按 employeeId 同步 entrada / saida，同一职工会话还能取 holerite 工资单。

调用方如何鉴权？

职工用 CPF 与密码走密码授权登录。后续请求把签发的 accessToken 作为 Bearer 凭证携带，并附带网关 client_id 头；refreshToken 用于续期会话。

能否列出受理 VR 的商户？

受理网络接口按坐标返回附近商户的 cnpj、razaoSocial、nomeFantasia、latitude 与 longitude，应用内地图即由此渲染。

与 SuperApp VR 相似的应用

Meu Alelo — Meu Alelo 是 Alelo 面向巴西职工的应用，覆盖 PAT 食品券与餐券以及出行等福利钱包，用来查余额、账单并办理卡片自助业务。
Pluxee Brasil — Pluxee Brasil 是 Pluxee 餐补、食品、文化、礼品、燃油和 Multibenefícios 卡的持卡人应用，一张卡最多七个钱包，并提供符合 PAT 的食品券与餐券。
Ticket — Ticket 是 Edenred 在巴西的员工福利品牌；官方应用可查询 Alimentação、Restaurante、Flex、Transporte 等 Ticket 卡的余额、账单和受理网点。
Flash Benefícios — Flash 是巴西的多福利 Visa 卡及职工应用，把 PAT 餐券、食品券与出行、健康等企业支出钱包放在一张卡上。
Caju — Caju 是巴西的福利与支出平台，把 CLT、PAT 与弹性福利余额放在一张 Visa 受理卡上，职工可在配套应用里查看各钱袋。
iFood Benefícios — iFood Benefícios 是已登记 PAT 的多余额卡，覆盖餐、食、出行、文化、健康、教育和居家办公津贴，可在 iFood 应用及合作商户消费。
Swile Brasil — Swile Brasil 是对齐 PAT 与 CLT 的多福利 Mastercard，把食品、餐补、健康、出行、居家办公、教育、燃油和奖励钱包放在一张卡上，职工可在应用里查看各余额。

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

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

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

获取报价

SuperApp VR 的 PAT 卡、余额与打卡接口

应用截图

API 端点一览

签发职工 access token

按 CPF 拉取职工入职档案

查找职工档案

列出实体福利卡

开卡公钥

虚拟卡详情

冻结虚拟卡

受理商户名录

多余额支出优先级

同步 Pontomais 打卡

HCM 工资单

职工薪资贷报价

Apple Wallet 令牌状态

二维码卡支付

数据类别

数据使用场景与案例

PAT 钱袋对账

受理网络覆盖

Pontomais 考勤接入

虚拟卡与 Apple Wallet 审计

常见问题

与 SuperApp VR 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

SuperApp VR 的 PAT 卡、余额与打卡接口

应用截图

API 端点一览

签发职工 access token

按 CPF 拉取职工入职档案

查找职工档案

列出实体福利卡

开卡公钥

虚拟卡详情

冻结虚拟卡

受理商户名录

多余额支出优先级

同步 Pontomais 打卡

HCM 工资单

职工薪资贷报价

Apple Wallet 令牌状态

二维码卡支付

数据类别

数据使用场景与案例

PAT 钱袋对账

受理网络覆盖

Pontomais 考勤接入

虚拟卡与 Apple Wallet 审计

常见问题

相关应用

与 SuperApp VR 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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