Petrobras Premmia 数据 API：积分、Vale-Premmia 与加油结账

Vibra Energia SA · 支付

Petrobras Premmia 是巴西 Petrobras 品牌加油站网络的官方会员积分与站内支付应用，由 Vibra Energia SA 发行——这家公司是巴西最大的燃油分销商，前身即 Petrobras Distribuidora，至今仍在加油岛上运营 Petrobras、BR Mania 便利店与 Lubrax+ 润滑油等品牌。会员用 CPF 加短信一次性验证码登录，随后可在应用内用 Pix、已保存的银行卡或现金为燃油付款（现金方式由站员确认油枪），在 Petrobras 加油站以及 BR Mania / Lubrax+ 的消费中赚取 Premmia 积分，保有 Vale-Premmia 燃油抵扣余额，激活按升计的优惠券，指定一座常用加油站以获得额外积分，还可选择订阅 Clube Premmia 以领取会员专属优惠券。首页地图可查找附近的 Petrobras 加油站，积分商城可把积分兑换为燃油代金券、合作伙伴里程（Azul、LATAM、Smiles）和商店奖励，礼品卡则可为 Saldo Premmia 充值。这是一款仅限巴西的消费者应用，面向本来就在 Petrobras 品牌站加油的车主，与 Shell Box、Ipiranga 的 Km de Vantagens 等竞争对手的加油站会员计划并存。

accumulatedPoints 与 accumulatedFuelVoucher 同处 userBalance 对象，并与应用内支付上限（maximumAmountByCreditCard、maximumTotalAmount）放在一起，因此一次加油、一笔 Vale-Premmia 抵扣和一次积分赚取，都落在同一本会员账本上。首页抬头则在头像旁重复给出实时的 pointBalance 与 savings 合计——这正是车主打开加油站地图之前看到的内容。

加油站结账走 Yuno 会话：createCheckoutSession 返回 checkoutSessionId 与 merchantOrderId，随后 checkAsyncPayment 给出 status，以及 toPay 中 paymentValue、pointsAmount 与 voucherAmount 的拆分。优惠券以 couponV3 记录送达，带有 couponCode、discountPerLiter 与 isClubPremmia；加油站则解析为 gasStationV2 记录，携带 cnpj、油品以及 codeInPlate 自动化字段。车队对账、优惠券情报与积分挽留机器人都会消费这本账本——openData Studio 把它变成可调用的开放数据。

应用截图

API 端点一览

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

用 CPF 登录（createSession）
POST /v1/members/sign-in osint
用 CPF 凭证发起会员登录，返回 success 以及下一步是否需要短信一次性验证码。
认证方式：无需登录的 CPF + 短信一次性验证码流程；验证码校验通过后签发会话令牌，作为后续调用的 Authorization Bearer。
- cpf
- password
- success
- otpRequired
```
POST /v1/members/sign-in HTTP/1.1
Content-Type: application/json
x-app-version: 7.15.0

{
  "cpf": "12345678901",
  "password": "••••"
}
```
```
{
  "success": true,
  "otpRequired": true
}
```
发送短信验证码（sendOtpCode）
POST /v1/members/otp/send osint
在 CPF 登录后发送短信（或邮箱）一次性验证码，返回脱敏邮箱/手机号及验证码有效期。
认证方式：无需登录的 CPF + 短信一次性验证码流程；验证码校验通过后签发会话令牌，作为后续调用的 Authorization Bearer。
- channel
- cpf
- maskedEmail
- maskedPhone
- message
- success
- expiresInSeconds
```
POST /v1/members/otp/send HTTP/1.1
Content-Type: application/json
x-app-version: 7.15.0

{
  "channel": "SMS",
  "cpf": "12345678901"
}
```
```
{
  "maskedEmail": "a***@example.com",
  "maskedPhone": "** ****-4321",
  "message": "Codigo enviado",
  "success": true,
  "expiresInSeconds": 120
}
```
校验短信验证码（verifyOtpCode）
POST /v1/members/otp/verify osint
确认短信一次性验证码，返回会话令牌与 valid 标志；该令牌随后作为 Authorization Bearer 认证后续调用。
认证方式：无需登录的 CPF + 短信一次性验证码流程；验证码校验通过后签发会话令牌，作为后续调用的 Authorization Bearer。
- channel
- cpf
- code
- sessionToken
- valid
```
POST /v1/members/otp/verify HTTP/1.1
Content-Type: application/json
x-app-version: 7.15.0

{
  "channel": "SMS",
  "cpf": "12345678901",
  "code": "847291"
}
```
```
{
  "sessionToken": "<session-token>",
  "valid": true
}
```
注册会员（registerMember）
POST /v1/members/register osint
用 CPF、姓名、邮箱与手机号创建会员账户，返回会话令牌、CRM 联系人 ID 与欢迎页文案。
认证方式：无需登录的 CPF + 短信一次性验证码流程；验证码校验通过后签发会话令牌，作为后续调用的 Authorization Bearer。
- cpf
- email
- firstName
- lastName
- phoneNumber
- sessionToken
- contactId
- successScreen
- title
- description
- button
```
POST /v1/members/register HTTP/1.1
Content-Type: application/json
x-app-version: 7.15.0

{
  "cpf": "12345678901",
  "email": "[email protected]",
  "firstName": "Ana",
  "lastName": "Silva",
  "phoneNumber": "11987654321"
}
```
```
{
  "sessionToken": "<session-token>",
  "contactId": "ct-003-premmia",
  "successScreen": {
    "title": "Conta criada",
    "description": "Bem-vinda ao Premmia",
    "button": "Comecar"
  }
}
```

会员资料（getProfile）

POST /v1/members/profile osint

返回已登录会员资料：姓名、脱敏与明文 CPF、邮箱电话、dateOfBirth、driverType、verifiedProfessionalDriver、CRM contactId、俱乐部订阅标志与 favoriteGasStation。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

firstName
lastName
cpf
rawCpf
maskedEmail
email
phone
maskedPhone
dateOfBirth
driverType
verifiedProfessionalDriver
contactId
isSubscriber
subscriptionPhase
favoriteGasStation
address

POST /v1/members/profile HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}

{
  "id": "usr-ana",
  "firstName": "Ana",
  "lastName": "Silva",
  "cpf": "***.456.789-**",
  "rawCpf": "12345678901",
  "maskedEmail": "a***@example.com",
  "email": "[email protected]",
  "phone": "11987654321",
  "maskedPhone": "** ****-4321",
  "dateOfBirth": "1992-04-18",
  "driverType": "PASSENGER",
  "verifiedProfessionalDriver": false,
  "contactId": "ct-003-premmia",
  "isSubscriber": true,
  "subscriptionPhase": "ACTIVE",
  "favoriteGasStation": {
    "id": "st-9821",
    "name": "Posto Petrobras Paulista",
    "cnpj": "33.000.167/0001-01"
  },
  "address": {
    "state": "SP",
    "city": "Sao Paulo",
    "street": "Rua Augusta 100",
    "zipCode": "01304-000"
  }
}

读取用户余额（getBalance）
POST /v1/loyalty/balance openfinance
读取会员 accumulatedPoints 与 Vale-Premmia accumulatedFuelVoucher，以及应用内支付上限（maximumAmountByCreditCard、maximumTotalAmount 与 Pix 偏好提示）。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- accumulatedFuelVoucher
- accumulatedPoints
- paymentConfig
- maximumAmountByCreditCard
- warnToPayPreferencedByPix
- maximumTotalAmount
```
POST /v1/loyalty/balance HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}
```
```
{
  "accumulatedFuelVoucher": 87.5,
  "accumulatedPoints": 12480,
  "paymentConfig": {
    "maximumAmountByCreditCard": 300.0,
    "warnToPayPreferencedByPix": true,
    "maximumTotalAmount": 500.0
  }
}
```
首页抬头（getHomeHeader）
POST /v1/home/summary openfinance
加载首页抬头：显示名、头像 initials/图片、pointBalance 与 savings 合计，展示在加油站地图上方。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- displayName
- avatar
- imageUrl
- color
- initials
- pointBalance
- savings
```
POST /v1/home/summary HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}
```
```
{
  "displayName": "Ana Silva",
  "avatar": {
    "imageUrl": "https://cdn.example/avatar.png",
    "color": "#00A859",
    "initials": "AS"
  },
  "pointBalance": 12480,
  "savings": 192.4
}
```

优惠券钱包（getCouponWallet）

POST /v1/coupons/wallet opendata

返回优惠券钱包，分为可用、不可用与俱乐部专享三类，每张优惠券带 couponCode、discountPerLiter、俱乐部标志、有效期与分站规则。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

available
unavailable
clubCoupons
quantityAvailable
couponCode
discountType
discountPercent
discountPerLiter
isClubCoupon
maxDiscountValue
expirationDate
partnerName
rules

POST /v1/coupons/wallet HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}

{
  "available": {
    "title": "Disponiveis",
    "list": [{
      "id": "cpn-441",
      "title": "R$ 0,10/L gasolina",
      "couponCode": "GASOL10",
      "discountType": "PER_LITER",
      "discountPercent": 0,
      "isClubCoupon": false,
      "status": "AVAILABLE",
      "expirationDate": "2026-11-30",
      "maxDiscountValue": 20.0,
      "partnerName": "Petrobras",
      "rules": [{
        "discountPerLiter": 0.10,
        "minValue": 30.0,
        "maxDiscountValue": 20.0
      }]
    }]
  },
  "unavailable": {"title": "Indisponiveis", "list": []},
  "clubCoupons": {
    "id": "club-1",
    "title": "Clube Premmia",
    "isClubCoupon": true,
    "list": []
  },
  "quantityAvailable": 3
}

附近/在站油站（locateStation）

POST /v1/stations/locate opendata

判断会员是否身在油站（currentStation）并给出 closestStation，含 CNPJ、油品、特许店、地理围栏标志与加油岛自动化字段（paymentFlow、codeInPlate）。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

currentStation
closestStation
id
name
cnpj
latitude
longitude
zipCode
state
city
neighborhood
street
tipStatus
distance
closeToGasStation
paymentFlow
codeInPlate
reviews
fuels
franchises

POST /v1/stations/locate HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "latitude": -23.5614,
  "longitude": -46.6558
}

{
  "currentStation": {
    "id": "st-9821",
    "name": "Posto Petrobras Paulista",
    "cnpj": "33.000.167/0001-01",
    "favorite": true,
    "phone": "1132590000",
    "latitude": -23.5615,
    "longitude": -46.6559,
    "zipCode": "01310-100",
    "state": "SP",
    "city": "Sao Paulo",
    "neighborhood": "Bela Vista",
    "street": "Av. Paulista 1000",
    "tipStatus": "ENABLED",
    "distance": 12.4,
    "closeToGasStation": true,
    "automation": {"paymentFlow": "PUMP_CODE", "codeInPlate": false},
    "reviews": {"quantity": 1842, "score": 4.6},
    "fuels": [{"id": "gas", "name": "Gasolina", "code": "GASOLINA"}],
    "paymentMethods": [{"name": "PIX"}],
    "franchises": [{"code": "BRMANIA", "type": "CONVENIENCE", "name": "BR Mania"}]
  },
  "closestStation": {
    "id": "st-9821",
    "name": "Posto Petrobras Paulista",
    "cnpj": "33.000.167/0001-01",
    "distance": 12.4
  }
}

搜索油站（searchStations）

POST /v1/stations/search opendata

分页返回油站目录，含 CNPJ、经纬度、油品与便利店/润滑油特许店，供首页地图搜索。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

page
total
lastPage
stations
id
name
cnpj
favorite
latitude
longitude
city
state
distance
closeToGasStation
fuels
franchises

POST /v1/stations/search HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "latitude": -23.5614,
  "longitude": -46.6558,
  "page": 1
}

{
  "page": 1,
  "total": 184,
  "lastPage": 19,
  "stations": [{
    "id": "st-9821",
    "name": "Posto Petrobras Paulista",
    "cnpj": "33.000.167/0001-01",
    "favorite": true,
    "latitude": -23.5615,
    "longitude": -46.6559,
    "city": "Sao Paulo",
    "state": "SP",
    "distance": 12.4,
    "closeToGasStation": true,
    "fuels": [{"id": "gas", "name": "Gasolina", "code": "GASOLINA"}],
    "franchises": [{"code": "BRMANIA", "type": "CONVENIENCE", "name": "BR Mania"}]
  }]
}

列出支付方式（listPaymentMethods）

POST /v1/payments/methods openbanking

列出该油站可用的应用内支付方式：Pix、已登记信用卡（brand、last4、bin、cardholderName、有效期）与现金，对应加油结账弹层。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

methods
pix
creditCard
cash
brand
last4
bin
cardholderName
expirationMonth
expirationYear
enabled
isNewMethod

POST /v1/payments/methods HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "stationId": "st-9821"
}

{
  "methods": {
    "pix": {
      "id": "pix-1",
      "type": "PIX",
      "title": "Pix",
      "subtitle": "Pagar com Pix",
      "isNewMethod": false,
      "enabled": true
    },
    "creditCard": {
      "id": "cc-88",
      "type": "CREDIT_CARD",
      "title": "Visa final 4242",
      "subtitle": "Credito",
      "isNewMethod": false,
      "enabled": true,
      "brand": "VISA",
      "last4": "4242",
      "bin": "424242",
      "cardholderName": "ANA SILVA",
      "expirationMonth": 12,
      "expirationYear": 2028
    },
    "cash": {
      "id": "cash-1",
      "type": "CASH",
      "title": "Dinheiro"
    }
  }
}

创建结账会话（createCheckout）

POST /v1/payments/checkout openfinance

为加油支付打开由支付服务商中介的结账会话，返回 checkoutSessionId、customerId、amount 与交给支付 SDK 的 merchantOrderId。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

checkoutSessionId
customerId
country
createdAt
amount
merchantOrderId
paymentDescription

POST /v1/payments/checkout HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "stationId": "st-9821",
  "amount": 180.5,
  "paymentMethodId": "pix-1",
  "pumpCode": "07"
}

{
  "checkoutSessionId": "chk_7f3a91",
  "customerId": "cus_ana_silva",
  "country": "BR",
  "createdAt": "2026-10-09T18:22:11Z",
  "amount": 180.5,
  "merchantOrderId": "ord-9821-07",
  "paymentDescription": "Abastecimento Posto Paulista bico 07"
}

确认加油支付（confirmPayment）

POST /v1/payments/confirm openfinance

确认站内加油：返回 paymentId/transactionId、Pix 复制粘贴 pixCode 与 pixQrCode、油枪 supplyId 以及收银员校验位 paymentValidationDigits。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

paymentId
transactionId
voucherCode
paymentTimeLimit
paymentValidationDigits
synchronizationType
pixCode
pixQrCode
supplyId
firstPayment
orderId

POST /v1/payments/confirm HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "stationId": "st-9821",
  "amount": 180.5,
  "paymentMethodId": "pix-1",
  "pumpCode": "07"
}

{
  "paymentId": "pay-4412",
  "transactionId": "txn-9821-07",
  "voucherCode": "VV-88291",
  "paymentTimeLimit": 300,
  "paymentValidationDigits": "47",
  "synchronizationType": "PIX",
  "pixCode": "<pix-copia-e-cola-code>",
  "pixQrCode": "<pix-qr-code-image>",
  "supplyId": "sup-07-9821",
  "firstPayment": false,
  "successScreen": {
    "title": "Pagamento iniciado",
    "orderId": "ord-9821-07",
    "description": "Abastecimento bico 07"
  }
}

轮询加油支付（getPaymentStatus）
POST /v1/payments/status openfinance
轮询进行中的加油支付（Pix、银行卡或现金），返回 status、可选 voucherCode 以及 paymentValue、pointsAmount、voucherAmount、firstPayment 的拆分。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- status
- voucherCode
- split
- paymentValue
- pointsAmount
- voucherAmount
- firstPayment
```
POST /v1/payments/status HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "checkoutSessionId": "chk_7f3a91"
}
```
```
{
  "status": "CONFIRMED",
  "voucherCode": "VV-88291",
  "split": {
    "paymentValue": 160.5,
    "pointsAmount": 20.0,
    "voucherAmount": 0.0,
    "firstPayment": false
  }
}
```
取消异步支付（cancelPayment）
POST /v1/payments/cancel openfinance
取消进行中的加油支付，返回 success 以及取消页展示的 title/message。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- success
- title
- message
```
POST /v1/payments/cancel HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "checkoutSessionId": "chk_7f3a91"
}
```
```
{
  "success": true,
  "title": "Pagamento cancelado",
  "message": "O abastecimento foi cancelado."
}
```
剩余油站额度（getSpendLimits）
POST /v1/payments/limits openfinance
返回会员在该油站今日剩余的应用内加油次数（remainingDailyCount）与本月剩余 BRL 上限（remainingMonthlyAmount）。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- stationId
- remainingDailyCount
- remainingMonthlyAmount
```
POST /v1/payments/limits HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "stationId": "st-9821"
}
```
```
{
  "remainingDailyCount": 4,
  "remainingMonthlyAmount": 1250.0
}
```

支付流水（getPaymentHistory）

POST /v1/payments/history openfinance

按年/月分页返回会员应用内加油与便利店账本，含逐笔 purchasedFuelVolume、transactionValue、couponDiscountLabel 与获得积分。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

year
months
payments
items
points
price
quantity
couponDiscountLabel
paymentType
totalAmountWithDiscount
transactionDiscount
stationName
transactionType
transactionValue
purchasedFuelVolume

POST /v1/payments/history HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "year": 2026
}

{
  "year": 2026,
  "months": [{
    "month": 10,
    "payments": [{
      "date": "2026-10-09",
      "items": [{
        "id": "it-1",
        "name": "Gasolina comum",
        "points": 180,
        "price": 180.5,
        "quantity": 32.8,
        "type": "FUEL",
        "couponDiscountLabel": "R$ 0,10/L"
      }],
      "paymentType": "PIX",
      "totalAmountWithDiscount": 177.22,
      "transactionDiscount": 3.28,
      "stationName": "Posto Petrobras Paulista",
      "transactionType": "SUPPLY",
      "transactionValue": 180.5,
      "purchasedFuelVolume": 32.8
    }]
  }]
}

代金券与油品额度（listVouchers）

POST /v1/loyalty/vouchers openfinance

返回燃油抵扣账本：accumulatedPoints、accumulatedFuelVoucher 以及代金券分桶（available、overdue、pending），带 voucherCode、expirationDate 与 luckyNumbers。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

accumulatedPoints
accumulatedFuelVoucher
vouchers
available
overdue
pending
partnerName
description
voucherCode
productId
expirationDate
created
luckyNumbers

POST /v1/loyalty/vouchers HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}

{
  "accumulatedPoints": 12480,
  "accumulatedFuelVoucher": 87.5,
  "vouchers": {
    "available": [{
      "partnerName": "Premmia",
      "description": "Vale-Premmia combustivel",
      "voucherCode": "VV-88291",
      "productId": "fuel-voucher",
      "expirationDate": "2026-12-31",
      "created": "2026-09-01",
      "luckyNumbers": ["184729"]
    }],
    "overdue": [],
    "pending": []
  }
}

积分与抵扣对账单（getPointsStatement）

POST /v1/loyalty/statement openfinance

按日分组返回积分与燃油抵扣对账单：条目类型（赚取/核销）、monetaryValue、points、miles、expirationDate、daysUntilExpiration 与 resellerType。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

asOf
groups
entries
type
monetaryValue
points
description
expirationDate
category
miles
daysUntilExpiration
resellerType

POST /v1/loyalty/statement HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "period": "LAST_90_DAYS"
}

{
  "asOf": "2026-10-09",
  "groups": [{
    "date": "2026-10-09",
    "entries": [{
      "id": "pt-991",
      "type": "EARN",
      "monetaryValue": 0,
      "points": 180,
      "description": "Abastecimento Posto Paulista",
      "expirationDate": "2027-10-09",
      "category": "FUEL",
      "miles": 0,
      "daysUntilExpiration": 365,
      "resellerType": "STATION"
    }]
  }]
}

兑换礼品卡（redeemGiftCard）
POST /v1/loyalty/gift-cards/redeem openfinance
把礼品卡兑入储值/燃油代金券余额，返回 status、transactionCode 与 description。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- giftCardId
- status
- transactionCode
- description
```
POST /v1/loyalty/gift-cards/redeem HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "giftCardId": "gc-55A1"
}
```
```
{
  "status": "CREDITED",
  "transactionCode": "txn-gift-9012",
  "description": "Saldo Premmia creditado"
}
```

积分商城搜索（searchRewards）

POST /v1/rewards/search opendata

搜索积分商城，返回可兑换券与权益，含积分代价、monetaryValue、cashbackAmount 与 redeemLabel（燃油代金券、合作伙伴里程、商店奖励）。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

coupons
offers
id
type
brand
title
points
monetaryValue
cashbackAmount
redeemLabel
isCoupon
description

POST /v1/rewards/search HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "query": "vale combustivel",
  "page": 1
}

{
  "coupons": [{
    "id": "rc-10",
    "type": "COUPON",
    "brand": "Premmia",
    "title": "Vale R$ 50 combustivel",
    "imageUrl": "https://cdn.example/vale50.png",
    "points": 5000,
    "monetaryValue": 50.0,
    "description": "Resgate em postos Petrobras",
    "cashbackAmount": 0,
    "redeemLabel": "Resgatar",
    "isCoupon": true
  }],
  "offers": [{
    "id": "off-22",
    "type": "MILES",
    "brand": "Azul",
    "title": "Milhas Azul",
    "points": 8000,
    "monetaryValue": 0,
    "cashbackAmount": 0,
    "redeemLabel": "Trocar",
    "isCoupon": false
  }]
}

Clube Premmia 订阅（getSubscription）

POST /v1/subscriptions/current opendata

读取会员的付费俱乐部计划：price、isActive、startDate/endDate/nextDueDate 以及取消与恢复流程所用的 memberSubscriptionId。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

id
versionId
title
description
termsUrl
startDate
endDate
nextDueDate
price
isActive
memberSubscriptionId

POST /v1/subscriptions/current HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}

{
  "id": "club-premmia",
  "versionId": "v3",
  "title": "Clube Premmia",
  "description": "Cupons extras e mais pontos no posto preferido",
  "termsUrl": "https://example.com/club-terms",
  "startDate": "2026-01-15",
  "endDate": "2026-12-15",
  "nextDueDate": "2026-11-15",
  "price": 9.9,
  "isActive": true,
  "memberSubscriptionId": "msub-441"
}

即将过期积分（getExpiringPoints）
POST /v1/loyalty/points/expiring openfinance
返回本月、下月与两个月后即将过期的积分，供对账单界面展示。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- expiring
- currentMonth
- nextMonth
- inTwoMonths
```
POST /v1/loyalty/points/expiring HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{}
```
```
{
  "expiring": {
    "currentMonth": 420,
    "nextMonth": 1100,
    "inTwoMonths": 800
  }
}
```
付款人会话（createPayerSession）
POST /v1/payments/payer-session openbanking
打开支付服务商的客户与银行卡登记会话（customerId 与 enrollmentSession.token），供银行卡登记 SDK 在存卡前使用。
认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。
- country
- customerId
- enrollmentSession
- id
- token
```
POST /v1/payments/payer-session HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "country": "BR"
}
```
```
{
  "country": "BR",
  "customerId": "cus_ana_silva",
  "enrollmentSession": {
    "id": "pms_91ab",
    "token": "<enrollment-session-token>"
  }
}
```

登记信用卡（enrollCard）

POST /v1/payments/cards openbanking

通过服务商登记会话登记信用卡，返回标记化卡片（last4、bin、brand、cardholderName、有效期），供加油结账使用。

认证方式： Bearer 会话令牌，来自 CPF 登录与一次性验证码流程；客户端同时发送应用完整性令牌与应用版本号头。

id
type
title
subtitle
enabled
last4
bin
cardholderName
expirationMonth
expirationYear
brand

POST /v1/payments/cards HTTP/1.1
Authorization: Bearer <session-token>
Content-Type: application/json
x-app-version: 7.15.0
x-integrity-token: <integrity-token>

{
  "enrollmentToken": "<enrollment-session-token>",
  "nickname": "Visa pessoal"
}

{
  "id": "cc-89",
  "type": "CREDIT_CARD",
  "title": "Visa final 1111",
  "subtitle": "Credito",
  "enabled": true,
  "last4": "1111",
  "bin": "411111",
  "cardholderName": "ANA SILVA",
  "expirationMonth": 7,
  "expirationYear": 2029,
  "brand": "VISA"
}

数据类别

会员积分
燃油代金券
优惠券
加油站
应用内支付
支付方式
订阅
会员资料
支付记录
积分对账单

数据使用场景与案例

车队燃油支出对账
车队后台拉取 userBalance.accumulatedFuelVoucher、ToPay 的 paymentId / pixCode，以及 userPaymentsV2 中每次加油结账的 purchasedFuelVolume 与 transactionValue，再把 merchantOrderId 和 homeGasStation / gasStationsV3 返回的加油站 CNPJ 同企业卡账单逐笔匹配。
优惠券与 Clube 优惠情报
零售媒体团队读取 couponsWalletV4 中的 couponV3 记录（discountPerLiter、maxDiscountValue、isClubPremmia 与加油站规则），并结合 userCurrentSubscription.isActive，在车主加油之前看清他手上究竟持有哪些按升计的优惠。
站级支付通道监测
收单机构监测 paymentMethodsV4 的 registeredMethods（Pix、信用卡 last4/bin、现金），以及 userRemainingTransactions 的 remainingDailyCount / remainingMonthlyAmount，了解某座 Petrobras 加油站仍接受哪些应用内支付通道，以及会员还剩多少额度。
积分到期挽留触发
CRM 监听 transactionsPointsV2 的 expiringPoints.actualMonth / nextMonth 与 homeHeader.pointBalance，向 Premmia 积分或 Vale-Premmia 余额即将失效的会员发送提醒，再把他们深链到 productSearchV3 的 redeemCoupons。

常见问题

Petrobras Premmia 如何认证会员？

会员在 loginUserV4 中输入 CPF，通过 validateVerificationCodeV2 确认短信 OTP（返回 token + valid），或通过 createMember 注册（返回 token + contactId）。之后的 GraphQL 调用把该会话作为 Authorization Bearer 发送，并附带原生 AUTH_HASH 与 x-app-version。

有哪些余额与代金券字段？

UserBalance 返回 accumulatedPoints、accumulatedFuelVoucher 与 paymentConfig 上限。Voucher 查询重复这些合计，并把 voucherListV2 分为 available、overdue 与 pending 三类条目，带有 voucherCode、expirationDate 与 luckyNumbers。homeHeader 则为首页补充 pointBalance 与 savings。

应用内加油支付如何运作？

paymentMethodsV4 列出 Pix、已保存的银行卡（brand、last4、bin、cardholderName）与现金。createCheckoutSession 打开 Yuno 会话（checkoutSessionId、merchantOrderId、amount）；checkAsyncPayment 轮询 status 与 toPay 拆分；cancelAsyncPayment 用于中止支付。userRemainingTransactions 按加油站给出 remainingDailyCount 与 remainingMonthlyAmount。

该 API 是否包含加油站位置与优惠券？

包含。homeGasStation 以 gasStationV2 返回 userInGasStation 与 closestToTheUser（cnpj、经纬度、油品、franchises、paymentFlow、codeInPlate）。couponsWalletV4 拆分为 availables、unavailables 与 premmiaClubCoupons；productSearchV3 按积分与 monetaryValue 搜索 redeemCoupons / redeemOffers。

与 Petrobras Premmia 相似的应用

Shell Box — Raízen Combustíveis 面向巴西壳牌油站的应用，可在手机上付款、累积 Shell Box Club 与 Stix 积分，并兑换合作伙伴优惠。
KMV — Ipiranga 的消费者应用，可在 Ipiranga 油站加油、用积分兑换返现或合作权益，并在应用内或凭 CPF 付款。
MyPertamina — 印尼 Pertamina 的官方忠诚度应用，可查找附近 SPBU 油站、用电子钱包支付油费，并在加油时累积积分。
IndianOil ONE — 印度石油的消费者应用，用于查找加油站、管理 Indane 液化气账户并查看 XTRAREWARDS 积分。
HP PAY — Hindustan Petroleum 的应用，支持在 HP 油站扫码或付款码结账、预付燃油钱包、查找附近网点以及预订 HP Gas 钢瓶。
АЗС Нефтьмагистраль — Нефтьмагистраль 油站连锁的官方车主应用，可地图找站、查看实时油品、泵岛付款并累积忠诚奖励。

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

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

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

获取报价

Petrobras Premmia 数据 API：积分、Vale-Premmia 与加油结账

应用截图

API 端点一览

用 CPF 登录（createSession）

发送短信验证码（sendOtpCode）

校验短信验证码（verifyOtpCode）

注册会员（registerMember）

会员资料（getProfile）

读取用户余额（getBalance）

首页抬头（getHomeHeader）

优惠券钱包（getCouponWallet）

附近/在站油站（locateStation）

搜索油站（searchStations）

列出支付方式（listPaymentMethods）

创建结账会话（createCheckout）

确认加油支付（confirmPayment）

轮询加油支付（getPaymentStatus）

取消异步支付（cancelPayment）

剩余油站额度（getSpendLimits）

支付流水（getPaymentHistory）

代金券与油品额度（listVouchers）

积分与抵扣对账单（getPointsStatement）

兑换礼品卡（redeemGiftCard）

积分商城搜索（searchRewards）

Clube Premmia 订阅（getSubscription）

即将过期积分（getExpiringPoints）

付款人会话（createPayerSession）

登记信用卡（enrollCard）

数据类别

数据使用场景与案例

车队燃油支出对账

优惠券与 Clube 优惠情报

站级支付通道监测

积分到期挽留触发

常见问题

相关应用

与 Petrobras Premmia 相似的应用

更多支付类应用

CashBook - Balance & Expense

Dhan Barse

GoPay Merchant: QRIS

HP PAY

相关主题

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