Waylet 数据 API：Solred 卡、油枪与充电

Repsol · 支付

Waylet. Pagos con el móvil 是西班牙能源公司 Repsol 的官方 Android 应用，用来在加油站用手机付款：油枪加油、绑定 Solred 企业卡与 Repsol Más 积分卡、PayPal、停车、Klin 洗车、RMVE 电动车充电，以及 Waylet Luz 家庭用电。登录后首页地图展示附近 Repsol 与合作网点、已保存卡片、返现与挑战，以及进行中的油枪或充电会话。面向西班牙司机与车队，用来在 Repsol 网点跳过收银台并累积 Más 奖励，对标的是其他西班牙加油与出行钱包，而不是综合性银行 App。

油枪小票把 total 金额与泵端选定的 cashback 标记、所选卡片的 pan 与 brand，以及指向单个网点的 commerceId 写在一起，Solred 企业卡还带 licensePlate 对应车辆。卡包行在 fullPan 与 holder 旁给出 allowBalanceRequest 与 cashbackCompatible；网点与附近地点卡片带 customerCashback 与 distance，旁边是按牌号的油品 price 行；进行中的 RMVE 会话报告 chargeBox、connector 与占位计费的 occupationBlockPrice；已入账奖励以 amount 行进入账本并用 paymentId 关联，待入账的汇总为 totalComingAmount；家庭节省按 month 与 year 聚合进 savings；登录资料保存 vatCode、gigyaId 与结构化 address，外加支付 PIN 标记。

车队后台按 pan 与 professional 标记把油枪 total 与 commerceId 对上 Solred 发票，把公车费用记到正确成本中心；出行图层标出油品 price 与充电桩的 chargeType、bookingEnabled，让司机下高速前选好油枪或 CCS 车位；理财工具把已入账 amount 与待入账 totalComingAmount 记到银行流水旁边；电动车看板盯 chargeBox 与 occupationBlockPrice，判断厢式车何时腾出车位。openData Studio 把这份出行账本变成可调用的开放数据。

应用截图

API 端点一览

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

列出支付卡

GET /v1/wallet/instruments openbanking

返回已登录钱包：银行卡、Solred、PayPal 与出行卡，含 pan、brand、allowBalanceRequest 与 cashbackCompatible，对应卡片页。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
alias
brand
created
expiryMonth
expiryYear
favorite
fullPan
holder
pan
type
active
activationUrl
cardIconUrl
valid
professional
licensePlate
customerId
cardId
allowBalanceRequest
cashbackCompatible
paypal
travel
solredMasLink

GET /v1/wallet/instruments HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

[
  {
    "id": "ins_8f2a1c",
    "alias": "Solred Más",
    "brand": "SOLRED_MAS",
    "created": "2024-03-12T10:22:00.000Z",
    "expiryMonth": "12",
    "expiryYear": "27",
    "favorite": true,
    "fullPan": "547112******4412",
    "holder": "ANA LOPEZ",
    "pan": "4412",
    "type": "SOLRED",
    "active": true,
    "activationUrl": null,
    "cardIconUrl": "https://cdn.example.com/cards/solred-mas.png",
    "valid": true,
    "professional": false,
    "licensePlate": "1234ABC",
    "customerId": "cus-19ae",
    "cardId": "solred-4412",
    "allowBalanceRequest": true,
    "cashbackCompatible": true,
    "paypal": null,
    "travel": null,
    "solredMasLink": null
  }
]

卡片详情

GET /v1/wallet/instruments/{instrument_id} openbanking

按 id 读取一张已存卡片，用于卡片详情：pan、brand、professional 以及 Solred Más 关联信息。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
alias
brand
expiryMonth
expiryYear
favorite
fullPan
holder
pan
active
valid
professional
licensePlate
allowBalanceRequest
cashbackCompatible
internationalPaymentsActive
cardBenefitsUrl
cardManagementUrl

GET /v1/wallet/instruments/ins_8f2a1c HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "id": "ins_8f2a1c",
  "alias": "Solred Más",
  "brand": "SOLRED_MAS",
  "expiryMonth": "12",
  "expiryYear": "27",
  "favorite": true,
  "fullPan": "547112******4412",
  "holder": "ANA LOPEZ",
  "pan": "4412",
  "active": true,
  "valid": true,
  "professional": false,
  "licensePlate": "1234ABC",
  "allowBalanceRequest": true,
  "cashbackCompatible": true,
  "internationalPaymentsActive": false,
  "cardBenefitsUrl": "https://www.example.com/benefits/solred-mas",
  "cardManagementUrl": null
}

卡片钱包余额
GET /v1/wallet/instruments/{instrument_id}/funds openbanking
在卡片 allowBalanceRequest 为 true 时请求 Solred/loop 卡余额查询；卡片界面用该标记决定是否发起。
认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。
- id
- alias
- brand
- pan
- allowBalanceRequest
- cashbackCompatible
- professional
```
GET /v1/wallet/instruments/ins_8f2a1c/funds HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>
```
```
{
  "id": "ins_8f2a1c",
  "alias": "Solred Más",
  "brand": "SOLRED_MAS",
  "pan": "4412",
  "allowBalanceRequest": true,
  "cashbackCompatible": true,
  "professional": false
}
```

发起油枪支付

POST /v1/pump-checkouts openbanking

在油站打开一笔油枪支付请求：source、paymentCardId 与 commerceId，返回 status 与所选卡片，直到司机确认。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
qr
alert
paymentRequest
source
paymentCardId
loyaltyMethodId
cashback
coupons
professional
commerceId
total
paymentCard
loyaltyMethod
status
message
errorInfo
benefit

POST /v1/pump-checkouts HTTP/1.1
Content-Type: application/json
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "source": "ONPUMP",
  "paymentCardId": "ins_8f2a1c",
  "loyaltyMethodId": null,
  "cashback": 1,
  "coupons": [],
  "professional": false,
  "commerceId": "st_2841",
  "total": null
}

{
  "id": "chk_44c1",
  "qr": null,
  "alert": null,
  "paymentRequest": {
    "source": "ONPUMP",
    "paymentCardId": "ins_8f2a1c",
    "loyaltyMethodId": null,
    "cashback": 1,
    "professional": false,
    "commerceId": "st_2841",
    "total": "52.40"
  },
  "paymentCard": {
    "id": "ins_8f2a1c",
    "alias": "Solred Más",
    "brand": "SOLRED_MAS",
    "pan": "4412"
  },
  "loyaltyMethod": null,
  "status": "PENDING",
  "message": null,
  "errorInfo": null,
  "benefit": null
}

按 id 读取支付请求

GET /v1/checkouts/{checkout_id} openbanking

轮询一笔支付请求（油枪、二维码、停车、Klin 或 RMVE）的 status、所选卡与嵌套金额，供确认或取消。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
qr
alert
paymentRequest
source
paymentCardId
cashback
commerceId
total
rmve
carwash
paymentCard
status
message
errorInfo

GET /v1/checkouts/chk_44c1 HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "id": "chk_44c1",
  "qr": null,
  "alert": null,
  "paymentRequest": {
    "source": "ONPUMP",
    "paymentCardId": "ins_8f2a1c",
    "cashback": 1,
    "commerceId": "st_2841",
    "total": "52.40",
    "rmve": null,
    "carwash": null
  },
  "paymentCard": {
    "id": "ins_8f2a1c",
    "alias": "Solred Más",
    "brand": "SOLRED_MAS",
    "pan": "4412"
  },
  "status": "CONFIRMED",
  "message": null,
  "errorInfo": null
}

客户资料

GET /v1/account/holder osint

读取已登录用户资料——name、vatCode、phone、address 与 gigyaId——对应设置与税务页。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
email
illionId
name
surname
vatCode
vatCodeType
phone
birthDate
gender
hasPin
address
street
city
state
zip
country
countryCode
fiscal
referrerCode
professional
gigyaId
companyVatCode

GET /v1/account/holder HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "id": "cus-19ae",
  "email": "[email protected]",
  "illionId": "ill-8821",
  "name": "Ana",
  "surname": "Lopez",
  "vatCode": "12345678Z",
  "vatCodeType": "NIF",
  "phone": "+34600111222",
  "birthDate": "1990-04-18",
  "gender": "FEMALE",
  "hasPin": true,
  "address": {
    "street": "Calle de Alcala 42",
    "city": "Madrid",
    "state": "Madrid",
    "zip": "28014",
    "country": "Spain",
    "countryCode": "ES"
  },
  "fiscal": null,
  "referrerCode": "ANA-4K2",
  "professional": false,
  "gigyaId": "gigya-19ae",
  "companyVatCode": null
}

节省总额报告
GET /v1/account/holder/savings-report openfinance
返回节省合计——按 month/year 的 savings 以及 savingsDistribution 与 paymentDistribution——对应节省摘要页。
认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。
- savings
- month
- year
- savingsDistribution
- paymentDistribution
```
GET /v1/account/holder/savings-report HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>
```
```
{
  "savings": 18450,
  "month": 10,
  "year": 2026,
  "savingsDistribution": {},
  "paymentDistribution": {}
}
```

返现流水

GET /v1/rewards/ledger openfinance

列出返现流水行——amount、paymentId、source 与 commerce——对应返现账本。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
paymentId
source
type
description
date
amount
commerce
title
text
caption

GET /v1/rewards/ledger HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

[
  {
    "id": "cbx-9012",
    "paymentId": "pay-77ab",
    "source": "ONPUMP",
    "type": "CASHBACK",
    "description": "Repsol Alcala",
    "date": "2026-10-12T08:14:00.000Z",
    "amount": 124,
    "commerce": {
      "name": "Repsol Alcala"
    },
    "title": "Cashback",
    "text": "+1,24 €",
    "caption": "Posted"
  }
]

待入账返现

GET /v1/rewards/ledger/pending openfinance

返回仍在清算的返现——totalComingAmount 及每条 coming 日期——对应即将到账返现。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

totalComingAmount
totalComingMessage
items
title
text
caption
date
coming
amount

GET /v1/rewards/ledger/pending HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "totalComingAmount": "3,80 €",
  "totalComingMessage": "Se abonara en 7 dias",
  "items": [
    {
      "title": "Repsol Alcala",
      "text": "+1,24 €",
      "caption": "Coming",
      "date": "2026-10-12T08:14:00.000Z",
      "coming": "2026-10-19T00:00:00.000Z",
      "amount": 124
    }
  ]
}

网点详情

GET /v1/sites/{site_id} opendata

读取一个网点（油站、充电桩、洗车或停车）的 address、customerCashback 以及嵌套的电动车充电信息。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
name
type
category
customerCashback
description
openingHours
isFavourite
distance
address
street
city
zip
countryCode
rmve
accessType
chargeType
bookingEnabled
maintenance
operatorType
parking
o2o

GET /v1/sites/st_2841 HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "id": "st_2841",
  "name": "Repsol Alcala",
  "type": "GAS_STATION",
  "category": "STATION",
  "customerCashback": 2.0,
  "description": "Estacion de servicio",
  "openingHours": "24h",
  "isFavourite": true,
  "distance": 340,
  "address": {
    "street": "Calle de Alcala 412",
    "city": "Madrid",
    "zip": "28027",
    "country": "Spain",
    "countryCode": "ES"
  },
  "rmve": {
    "accessType": "PUBLIC",
    "chargeType": "DC",
    "bookingEnabled": true,
    "maintenance": false,
    "operatorType": "REPSOL"
  },
  "parking": null,
  "o2o": null
}

油站油价

GET /v1/fuel-grades/prices opendata

返回油品行——title、name 与 price——油站卡片上的汽油与柴油标价。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

title
imageUrl
name
price

GET /v1/fuel-grades/prices HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

[
  {
    "title": "Sin Plomo 95",
    "imageUrl": "https://cdn.example.com/fuels/sp95.png",
    "name": "SP95",
    "price": "1,459"
  },
  {
    "title": "Gasoleo A",
    "imageUrl": "https://cdn.example.com/fuels/goa.png",
    "name": "GOA",
    "price": "1,389"
  }
]

附近兴趣点

GET /v1/places/around opendata

列出用户附近的地点卡片——name、distance、customerCashback 与 address——填充首页地图。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。此列表另有未登录的公开版本。

id
name
category
customerCashback
distance
isFavourite
address
street
city
zip
countryCode
location

GET /v1/places/around?lat=40.4362&lng=-3.6581&radius=5000 HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

[
  {
    "id": "st_2841",
    "name": "Repsol Alcala",
    "category": "STATION",
    "customerCashback": 2.0,
    "distance": 340,
    "isFavourite": true,
    "address": {
      "street": "Calle de Alcala 412",
      "city": "Madrid",
      "zip": "28027",
      "countryCode": "ES"
    },
    "location": {
      "latitude": 40.4362,
      "longitude": -3.6581
    }
  }
]

忠诚度挑战

GET /v1/rewards/campaigns opendata

返回挑战活动——conditionUnits 对 achievedUnits、日期与 status——对应忠诚度挑战列表。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
title
description
units
conditionUnits
achievedUnits
startDate
endDate
endDateLabel
status

GET /v1/rewards/campaigns HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

[
  {
    "id": "ch-oct-fill",
    "title": "Tres repostajes",
    "description": "Reposta 3 veces este mes",
    "units": "L",
    "conditionUnits": 3.0,
    "achievedUnits": 1.0,
    "startDate": "2026-10-01",
    "endDate": "2026-10-31",
    "endDateLabel": "Hasta el 31 oct",
    "status": "ACTIVE"
  }
]

电动车充电会话

GET /v1/ev-sessions/{session_id} opendata

读取进行中的电动车充电会话——chargeBox、connector、status 与 occupationBlockPrice——对应充电页。

认证方式：会话令牌以 Bearer 方式携带；每次调用还附带应用版本、平台与设备上下文头，以及 Accept-Language。

id
paymentId
commerceId
chargeBox
connector
status
cashbackPercentage
created
occupationBlockPrice
occupationBlockTime
occupationConcessionTime
curve

GET /v1/ev-sessions/evs_55d0 HTTP/1.1
Accept-Language: es-ES
X-App-Version: 26.10.0
X-Platform: android
Authorization: Bearer <session-token>

{
  "id": "evs_55d0",
  "paymentId": "pay-77ab",
  "commerceId": "st_2841",
  "chargeBox": "RP-ALCALA-02",
  "connector": "CCS2-1",
  "status": "CHARGING",
  "cashbackPercentage": "2",
  "created": "2026-10-12T09:01:00.000Z",
  "occupationBlockPrice": 20,
  "occupationBlockTime": 10,
  "occupationConcessionTime": 15,
  "curve": []
}

数据类别

卡片
支付
返现
油价
电动车充电
忠诚度
资料
节省

数据使用场景与案例

Solred 车队油枪对账
车队后台拉取卡片 pan 与 professional 标记，再用油枪 PaymentRequest 的 commerceId 与金额对齐 Solred 发票，把公车费用记到正确成本中心。
油价与充电枪地图
出行图层用附近网点的 Fuel price 以及 ElectricStation 的 chargeType / bookingEnabled 标点，让司机下高速前选好油枪或 CCS 车位。
理财账本中的返现
记账应用写入已入账的 TransactionSimpleMovement.amount 以及仍在清算的 totalComingAmount，让 Repsol Más 奖励和银行流水排在一起。
RMVE 充电会话监控
电动车看板跟踪进行中充电的 chargeBox、connector 与 occupationBlockPrice，调度就能知道厢式车何时腾出车位。

常见问题

Waylet 会存哪些支付工具？

卡包列表返回银行、Solred、PayPal 与出行卡，每张都有 pan、brand、professional 与 cashbackCompatible 标记；余额查询只对 allowBalanceRequest 为 true 的卡片发起。

不发起支付也能读油价吗？

可以。油品 title、name 与 price 作为网点目录返回，附近兴趣点在打开油枪请求前就带有 customerCashback。

接口覆盖电动车充电吗？

RMVE 充电会话给出 chargeBox、connector、status 与占位计费的 occupationBlockPrice；支付请求上 rmve 与 carwash 块和油枪金额写在同一条记录里。

客户如何标识？

资料含 email、西班牙 vatCode、gigyaId、illionId 以及带 countryCode 的地址，还有支付 PIN 标记。

与 Waylet. Pagos con el móvil 相似的应用

Moeve — Moeve（原 Cepsa）是 Moeve gow 俱乐部应用，可在西班牙 Moeve 油站加油、购物和洗车以及公共充电时累积可抵扣余额。
miBP — miBP 是 bp Energía España 的忠诚俱乐部应用，用来把 miBP 卡放进手机，在西班牙 BP 油站加油累积 miBP Savings 与积分，并查看余额。
Mundo Galp — Mundo Galp 是 Galp 在西班牙的忠诚应用，可在 Galp 油站加油、店内消费和洗车时累积积分，并兑换油费折扣、Galp 产品和合作礼品卡。
Ballenoil Easy Fuel — Ballenoil Easy Fuel 可在西班牙 Ballenoil 油站用手机加油付款，查看附近网点与油价、接收促销，并把加油记到公司车队。
Plenergy — Plenergy 是西班牙 Plenergy 连锁油站的应用，用来查找附近网点、查看实时油价并下载发票。
Mi Energía DISA — Mi Energía DISA 是 Grupo DISA 面向西班牙的应用，覆盖 DISA 与 Shell 油站以及电力、瓶装气和天然气，可在这些油站使用应用内燃油折扣。
Electromaps — Electromaps 是 Wallbox 旗下的公共充电应用，用来查找充电桩，并用手机或 Electropass RFID 卡启动充电。
ElParking — ElParking 是西班牙司机应用，用来查找、比价并预付停车场车位或路边停车，对应 Waylet 的停车缴费场景。

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

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

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

获取报价

Waylet 数据 API：Solred 卡、油枪与充电

应用截图

API 端点一览

列出支付卡

卡片详情

卡片钱包余额

发起油枪支付

按 id 读取支付请求

客户资料

节省总额报告

返现流水

待入账返现

网点详情

油站油价

附近兴趣点

忠诚度挑战

电动车充电会话

数据类别

数据使用场景与案例

Solred 车队油枪对账

油价与充电枪地图

理财账本中的返现

RMVE 充电会话监控

常见问题

与 Waylet. Pagos con el móvil 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Waylet 数据 API：Solred 卡、油枪与充电

应用截图

API 端点一览

列出支付卡

卡片详情

卡片钱包余额

发起油枪支付

按 id 读取支付请求

客户资料

节省总额报告

返现流水

待入账返现

网点详情

油站油价

附近兴趣点

忠诚度挑战

电动车充电会话

数据类别

数据使用场景与案例

Solred 车队油枪对账

油价与充电枪地图

理财账本中的返现

RMVE 充电会话监控

常见问题

相关应用

与 Waylet. Pagos con el móvil 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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