HP PAY 数据 API
HP PAY 是 Hindustan Petroleum Corporation Ltd.(印度国营石油营销商,旗下 HP 加油站与 HP Gas 液化气品牌)的官方消费者应用。驾车人用预付燃油钱包在 HP 网点扫码或 Instafuel 预置码结账,走 UPI 付款,查找附近油站,并查询 ICICI / IDFC 的 FASTag 余额。HP Gas 家庭可预订家用钢瓶换气、用 OTP 或生物识别完成 Aadhaar e-KYC、登记 Navya 5 公斤与 10 公斤气瓶、提交 Suvidha 与安全检查申请,并缴纳管道天然气账单。积分侧是 Happy coins、润滑油 coins 与 Zillion / payback 点数,首页还有 ChargeGrid 充电入口。应用仅面向印度,Google Play 评分 3.97(88,144 条)、安装量超一千万,是 HPCL 对应 IndianOil ONE 与 Bharat Petroleum 的 HelloBPCL / Bharatgas 的官方渠道。
Instafuel 预置码与 wallet_balance、active_Paycode_Balance、point_balance、payback_Points 写在同一条 HPCL 客户账上,主键是 customer_id 与 user_mobile。钱包存折再把加油站加油与液化气换气拆开:燃油侧是 transactionId、amount、balance、merchantName、product、volume、odometerReading;UPI 侧是 upiPayeeVpa / upiTxnId / upiTxnStatus;同一账本付钢瓶时带 lpgRefillOrderNo / lpgCosumerNo。日限额与月限额以 dailyRechargeLimit、dailySaleLimit、monthlyRechargeLimit、perTransactionSaleLimit 返回。
HP Gas 消费者档案以 UniqueConsumerId 为键,含 consumerNumber、consumerName、CylinderType、ConsumerType、isValidForRefill、isValidForPayment、refillPaymentAmount、onlinePaymentDiscountAmount 以及所属 OrderDealerCode / OrderDealerName。换气历史列出 refillOrderNum、refillOrderStatus、refillDelivDate、cashMemoNo、refillSubsidizedStatus。管道气账单挂在 bp_number 上,含 bill_no、amount、bill_due_date、crn;FASTag 查询按 vehicleNumber 返回 HexTagId、Balance、CustomerName、IsSuccess;附近油站给出 SAPCode、Merchant_Name、Merchant_Latitude、Distance_in_Meter 与展示 Price。
车队后台可用商户 SAP 编码与里程读数对账加油流水;HP Gas 分销商可轮询换气标志与现金备忘录状态而无需重录家庭端;PNG 账务按到期日账龄;FASTag 运营在过路前核对标签十六进制 ID 与余额。openData Studio 把这些 HPCL 钱包、液化气、PNG、FASTag 与网点记录做成可调用的开放数据。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
发送登录 OTP
POST
/v1/hppay/session/otpopendata向注册手机号发送登录 OTP,用于创建或找回 MPIN。路径保留服务端拼写 genrate_otp_hppay。
认证方式: HP PAY 登录的公开入口。仍附加 Checksum、API_Key 与 Secret_Key;尚无 Bearer。响应中的 otp 由 MPIN 设置或 OTP 校验消费。
- Useragent
- Userip
- user_Mobile
- deviceToken
- Userid
- otp
- status
- reason
- method_Name
- status_Code
- success
POST /v1/hppay/session/otp HTTP/1.1 Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "Useragent": "Android", "Userip": "0.0.0.0", "user_Mobile": "9876543210", "deviceToken": "fcm-device-token", "Userid": "9876543210" }{ "data": [ { "otp": 4821, "status": 1, "reason": "OTP sent" } ], "message": "Success", "method_Name": "genrate_otp_hppay", "status_Code": 200, "success": true }校验 MPIN 并开启会话
POST
/v1/hppay/session/mpinopendata用 4 位 MPIN 兑换会话令牌,以及首页抬头使用的 KYC 标志与 Instafuel 预置码余额。
认证方式: MPIN 加注册手机号。Checksum / API_Key / Secret_Key 请求头。响应中的 token 在后续调用中以 Authorization: Bearer 发送。
- mpin
- user_Mobile
- token
- first_name
- last_name
- user_mobile
- kyC_Status
- kyC_Status_Code
- customerType
- is_Mpin_blocked
- is_device_free
- hpPay_Transaction_Id
- active_Paycode_Balance
- pincode
POST /v1/hppay/session/mpin HTTP/1.1 Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "useragent": "Android", "userip": "0.0.0.0", "mpin": "******", "user_Mobile": "9876543210", "userid": "9876543210" }{ "data": [ { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session", "first_name": "Ravi", "last_name": "Kumar", "user_mobile": 9876543210, "kyC_Status": "Verified", "kyC_Status_Code": "1", "customerType": "Retail", "is_Mpin_blocked": false, "is_device_free": true, "hpPay_Transaction_Id": "HP-TXN-88421", "active_Paycode_Balance": 150.0, "pincode": "400001", "status": 1 } ], "message": "Success", "method_Name": "validate_mpin_hppay", "status_Code": 200, "success": true }读取燃油钱包余额
POST
/v1/hppay/wallet/balanceopenbanking读取首页余额条展示的 HP 预付燃油钱包、Instafuel 预置码余额与积分 / payback 点数。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- user_mobile_or_userid
- customer_id
- wallet_balance
- active_Paycode_Balance
- point_balance
- payback_Points
- user_mobile
- user_name
- method_Name
- status_Code
- success
POST /v1/hppay/wallet/balance HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "user_mobile_or_userid": 9876543210, "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": [ { "customer_id": 1846501, "point_balance": 120.0, "payback_Points": "45", "user_mobile": 9876543210, "user_name": "Ravi Kumar", "wallet_balance": 2500.5, "active_Paycode_Balance": 150.0 } ], "message": "Success", "method_Name": "get_user_wallet_balance_new", "status_Code": 200, "success": true, "model_State": null }钱包交易流水
POST
/v1/hppay/wallet/ledgeropenbanking分页返回燃油钱包存折:带升数与里程的加油站加油、UPI 通道,以及同一账本支付的 LPG 换气订单。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- from_Date
- to_Date
- trans_Type
- transactionId
- amount
- balance
- merchantName
- merchantId
- product
- volume
- odometerReading
- upiPayeeVpa
- upiPayerVa
- upiTxnId
- upiTxnStatus
- lpgRefillOrderNo
- lpgCosumerNo
- paymentMode
- transactionStatus
POST /v1/hppay/wallet/ledger HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "from_Date": "2026-09-01", "to_Date": "2026-10-05", "mobile_No": "9876543210", "trans_Type": "ALL", "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": [ { "transactionId": "HP-TXN-88421", "amount": 1850.0, "balance": 650.5, "currency": "INR", "transactionStatus": "SUCCESS", "transactionType": "FUEL", "paymentMode": "WALLET", "merchantId": "SAP-12845", "merchantName": "HP Sector 18 Noida", "product": "MS", "price": "94.72", "volume": "19.53", "odometerReading": "45210", "upiPayeeVpa": "hpcl@icici", "upiPayerVa": "ravi@okicici", "upiTxnId": "UPI123456789", "upiTxnStatus": "SUCCESS", "lpgRefillOrderNo": "", "lpgCosumerNo": "", "customerId": 1846501, "mobileNumber": 9876543210 } ], "message": "Success", "method_Name": "get_wallet_transaction_history_new", "status_Code": 200, "success": true }查看钱包限额
POST
/v1/hppay/wallet/capsopenbanking返回按日、按月与单笔的充值 / 消费上限,用于约束钱包充值与加油站扣款。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- user_mobile
- dailyRechargeLimit
- dailySaleLimit
- monthlyRechargeLimit
- monthlySaleLimit
- perTransactionRechargeLimit
- perTransactionSaleLimit
- method_Name
- status_Code
- success
POST /v1/hppay/wallet/caps HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "user_mobile": "9876543210", "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": [ { "dailyRechargeLimit": 10000.0, "dailySaleLimit": 10000.0, "monthlyRechargeLimit": 100000.0, "monthlySaleLimit": 100000.0, "perTransactionRechargeLimit": 5000.0, "perTransactionSaleLimit": 5000.0 } ], "message": "Success", "method_Name": "view_limits", "status_Code": 200, "success": true, "model_State": null }HP Gas 用户档案
POST
/v1/hppay/lpg/householdopendata加载 HP Gas 家庭档案:唯一消费者编号、气瓶类型、可否换气/付款标志、应付金额与所属分销商。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- mobile_No
- UniqueConsumerId
- consumerNumber
- consumerName
- consumerAddress
- consumerPhone1
- PinCode
- CylinderType
- ConsumerType
- isValidForRefill
- isValidForPayment
- refillPaymentAmount
- onlinePaymentDiscountAmount
- OrderNo
- OrderDealerCode
- OrderDealerName
- SVQuantity
POST /v1/hppay/lpg/household HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "mobile_No": "9876543210", "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": { "UniqueConsumerId": "1234567890123456", "consumerNumber": 2081846501, "consumerName": "Ravi Kumar", "consumerAddress": "Sector 18, Noida", "consumerPhone1": "9876543210", "PinCode": "201301", "CylinderType": "14.2kg", "ConsumerType": "Domestic", "isValidForRefill": true, "isValidForPayment": true, "refillPaymentAmount": 903.0, "onlinePaymentDiscountAmount": 5.0, "OrderNo": "2-002184659844", "OrderDealerCode": "0000154004", "OrderDealerName": "K-2 International", "SVQuantity": 1, "isRefillPortabilityEnabled": false, "QueryRefNo": "QR-88421" }, "message": "Success", "method_Name": "get_consumer_data", "status_Code": 200, "success": true, "model_State": null }LPG 换气预订历史
POST
/v1/hppay/lpg/bookingsopenfinance列出 HP Gas 换气预订,含订单号、送达日期、补贴标志与现金备忘录编号。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- mobile_No
- refillOrderNum
- refillOrderDate
- refillDelivDate
- refillOrderStatus
- refillRefNum
- refillSubsidizedStatus
- cashMemoNo
- cashMemoTinyURL
- assuredDeliveryStatus
- errorCode
- errorMessage
POST /v1/hppay/lpg/bookings HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "mobile_No": 9876543210, "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": { "RefillHistoryData": [ { "refillOrderNum": "2-002184659844", "refillOrderDate": "2026-09-28", "refillDelivDate": "2026-09-30", "refillOrderStatus": "Delivered", "refillRefNum": "RF-88421", "refillSubsidizedStatus": "Y", "cashMemoNo": "CM-77821", "cashMemoTinyURL": "https://hpcl.example/cm/77821", "assuredDeliveryStatus": "OnTime" } ], "errorCode": "0", "errorMessage": "Success" }, "message": "Success", "method_Name": "get_refill_booking_history", "status_Code": 200, "success": true }附近 HP 加油站
POST
/v1/hppay/pumps/nearbyopendata按手机位置查找附近 HP 零售站点,返回 SAP 编码、展示油价、评分与距离。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- latitude
- longitude
- SAPCode
- Merchant_Name
- Merchant_Address
- Merchant_Latitude
- Merchant_Longtitude
- Distance_in_Meter
- Price
- Rating
- TotalReviews
- Mobile_No
- API_Status
- API_Message
POST /v1/hppay/pumps/nearby HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "latitude": "28.5355", "longitude": "77.3910", "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": { "Response": [ { "SAPCode": 12845, "Merchant_Name": "HP Sector 18 Noida", "Merchant_Address": "Sector 18, Noida", "Merchant_Detail": "Petrol Diesel", "Merchant_Latitude": "28.5701", "Merchant_Longtitude": "77.3210", "Distance_in_Meter": 3210.0, "Price": "94.72", "Rating": "4.2", "TotalReviews": 318.0, "Mobile_No": "0120-4000000" } ], "API_Status": "SUCCESS", "API_Message": "OK" }, "message": "Success", "method_Name": "getnearbypumpDistributorPincode", "status_Code": 200, "success": true }查询 FASTag 余额
POST
/v1/hppay/fastag/balanceopenbanking按车牌查询 FASTag 钱包,返回标签十六进制 ID、客户姓名与当前余额(同一流程覆盖 ICICI / IDFC 标签)。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- vehicleNumber
- Balance
- HexTagId
- CustomerName
- IsSuccess
- ErrorCode
- Messages
POST /v1/hppay/fastag/balance HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "vehicleNumber": "MH12AB1234", "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": { "Balance": 842.5, "ErrorCode": "0", "IsSuccess": true, "Messages": ["Success"], "CustomerName": "Ravi Kumar", "HexTagId": "34161FA8201B80" }, "message": "Success", "method_Name": "fetch_fastag_balance", "status_Code": 200, "success": true }PNG 客户查询
POST
/v1/hppay/png/accountopendata解析已登录用户的 HP 管道天然气账户:业务伙伴号、应付金额与到期日。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- bpnumber
- customerName
- address
- customerPhoneNo1
- registeredEmailID
- amountToPay
- dueDate
- isValidForPayment
- sapCodeHppayMapping
- apiStatus
- apiMessage
- errorCode
POST /v1/hppay/png/account HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "response": { "bpnumber": "1000123456", "customerName": "Ravi Kumar", "address": "Andheri East, Mumbai", "customerPhoneNo1": "9876543210", "registeredEmailID": "[email protected]", "amountToPay": 1240.0, "dueDate": "2026-10-18", "isValidForPayment": true, "sapCodeHppayMapping": "PNG-SAP-441" }, "apiStatus": true, "apiMessage": "Success", "errorCode": 0 }PNG 待缴账单
POST
/v1/hppay/png/invoicesopenfinance按业务伙伴号拉取未结的 HP 管道天然气账单:账单号、金额、到期日以及结账用的拉取参考号。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- bp_number
- crn
- amount
- bill_no
- bill_due_date
- bill_generated_date
- bill_fetch_ref
- first_name
- last_name
- address
- reference_no
- currency
- transaction_status
POST /v1/hppay/png/invoices HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "bp_number": "1000123456", "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "apI_Status": true, "apI_Message": "Success", "response": { "bp_number": "1000123456", "crn": "CRN-77821", "amount": 1240.0, "bill_no": "PNG-2026-09-441", "bill_due_date": "2026-10-18", "bill_generated_date": "2026-09-18", "bill_fetch_ref": "BFR-88421", "first_name": "Ravi", "last_name": "Kumar", "address": "Andheri East, Mumbai", "reference_no": "REF-44120", "currency": "INR", "transaction_status": "PENDING" } }已登录用户资料
POST
/v1/hppay/profileosint返回已登录 HP PAY 资料:姓名、手机、地址、关联车辆 / FASTag、payback 卡以及 e-KYC / 人脸标志。
认证方式: MPIN 登录下发的 Authorization: Bearer。JSON 请求体以 Checksum 头签名,并附带 API_Key 与 Secret_Key。
- customer_Id
- first_name
- last_name
- user_mobile
- user_email
- dob
- address
- pincode
- city
- district
- state
- vehicle_no
- fasttag_no
- payback_cardno
- kyC_Status
- EKYCDone
- IsFaceID
- IsBioMetricID
- active_Paycode_Balance
POST /v1/hppay/profile HTTP/1.1 Authorization: Bearer <token> Content-Type: application/json Checksum: <body-checksum> API_Key: <api-key> Secret_Key: <secret-key> { "useragent": "Android", "userid": "9876543210", "userip": "0.0.0.0" }{ "data": { "customer_Id": "1846501", "first_name": "Ravi", "last_name": "Kumar", "user_mobile": 9876543210, "user_email": "[email protected]", "dob": "1990-03-12", "gender": "M", "address": "Sector 18, Noida", "pincode": "201301", "city": "Noida", "district": "Gautam Buddha Nagar", "state": "Uttar Pradesh", "vehicle_no": "MH12AB1234", "fasttag_no": "34161FA8201B80", "payback_cardno": "PB-998877", "kyC_Status": "Verified", "kyC_Status_Code": "1", "EKYCDone": "Y", "IsFaceID": true, "IsBioMetricID": false, "customerType": "Retail", "active_Paycode_Balance": 150.0 }, "message": "Success", "method_Name": "get_profile", "status_Code": 200, "success": true }
数据类别
- 钱包余额
- 燃油交易
- 消费限额
- LPG 用户
- LPG 换气订单
- FASTag 余额
- PNG 账单
- 加油站
- KYC 资料
数据使用场景与案例
车队燃油钱包对账
车队后台每晚拉取 wallet_balance 与 active_Paycode_Balance,再把存折行(transactionId、merchantName、volume、odometerReading、与 SAP 关联的 merchantId)对到车辆日志,标记从未上报里程的加油。
HP Gas 换气作业源
HP Gas 分销商台席盯 UniqueConsumerId、isValidForRefill、refillPaymentAmount 以及 refillOrderStatus / cashMemoNo,即可派送未结钢瓶预订,无需重录家庭端。
FASTag 出行前余额检查
物流看板在过路走廊发车前按 vehicleNumber 查 HexTagId 与 Balance,并在 IsSuccess 为假或标签钱包低于卢比起付线时告警。
PNG 欠费账龄
账务台按 bp_number、bill_no、amount、bill_due_date 做管道气欠费账龄,并用 isValidForPayment / transaction_status 跳过已进入结账的账户。
常见问题
HP PAY 返回哪些钱包字段?
钱包余额调用按 customer_id 返回 wallet_balance、active_Paycode_Balance、point_balance 与 payback_Points。存折分页含 transactionId、volume、odometerReading、UPI 编号与 lpgRefillOrderNo。限额提供 dailyRechargeLimit 与 perTransactionSaleLimit。
应用如何鉴权用户?
登录先向 user_Mobile 发 OTP,再用 MPIN 兑换会话令牌。后续调用携带 Authorization: Bearer,以及对 JSON 请求体计算的 Checksum 头和静态 API_Key / Secret_Key。
HP PAY 是否暴露 HP Gas 液化气数据?
家庭档案返回 UniqueConsumerId、consumerNumber、CylinderType、isValidForRefill、refillPaymentAmount 与所属 OrderDealerCode。换气历史列出 refillOrderNum、refillOrderStatus、cashMemoNo 与 refillSubsidizedStatus。
同一会话能否读取 FASTag 或 PNG 账单?
FASTag 查询接受 vehicleNumber,返回 HexTagId、Balance 与 CustomerName。管道气账户与待缴账单提供 bp_number / bpnumber、bill_no、amount 与 bill_due_date。
与 HP PAY 相似的应用
- IndianOil ONE — 印度石油的消费者应用,覆盖 Indane 液化气换气、加油站 XTRAREWARDS 积分与 Aadhaar eKYC,是 HPCL 在国营石油公司中的直接对标。
- HelloBPCL — Bharat Petroleum 的消费者应用,用于 Bharatgas 钢瓶预订、液化气 eKYC 与 Smartdrive 燃油钱包。
- Paytm — 支付超级应用,其 BBPS 缴费板块可在同一处为 HP Gas、Indane 与 Bharatgas 预订并支付换气。
- PhonePe — UPI 应用,在 BBPS 缴费板块中提供三家国营石油公司的液化气钢瓶预订与付款。
- UMANG — 印度政府的一站式政务服务应用,内置 HP Gas、Indane 与 Bharatgas 的液化气换气预订。
相关主题
- HP PAY API
- HP Gas 液化气
- HPCL 钱包
- Instafuel 预置码
- FASTag HexTagId
- PNG bp_number
- UniqueConsumerId
- HP 加油站 SAPCode
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业