Uni GoldX 数据 API：接口与字段

Uni Cards · 银行 4.5 ★

Uni: GoldX & UPI Credit Card 是 Uni Cards 的安卓客户端；Uni Cards 是印度金融科技公司，与 Yes Bank 和 Bank of Baroda 合作发行 GoldX 信用卡。应用覆盖卡片的完整生命周期：资格检查与数字 KYC、激活卡片、选择信用额度，以及一张 RuPay 虚拟伴侣卡——可加入 Google Pay、PhonePe 或 Paytm，在主 Visa 或 Mastercard 之外扫码支付 UPI。奖励是它的差异点：消费赚取 Uni Coins，按 100 枚兑 1 卢比的比率计价，积分可即时兑换为存放在 GoldX Vault 中、由 Augmont 支持的 24K 数字黄金，既可套现，也可铸成实体金币。应用还提供月度账单、账单还款、单笔消费的 EMI 与 Pay Later 转换、卡片锁定、PIN 重置以及按渠道设置的交易限额，另有 Uni Store 可订机票和购买商户代金券。它是只服务印度的个人信用卡应用，竞争对手是 HDFC、ICICI 与 Axis 的卡片应用，在 Google Play 上约有 194,000 条评价，评分 4.5。

GoldX Vault 余额将积分余额 uniCoins 及其卢比兑换比率 coinToRupeeRate，与黄金持仓的 goldGrams、goldValue 和 goldRatePerGram 分开表示。消费记录把 merchantName 与逐笔赚取的 uniCoinsEarned 配在一起；兑换结果则记录 coinsDebited、goldGramsCredited、uniCoinsAfter 和 goldGramsAfter，共同支持奖励与黄金余额对账。账单载荷对应账期——statementDate、totalAmountDue、minimumDue、dueDate，以及按 categoryCode 划分的消费行——额度汇总则给出 creditLine、availableLimit 与 unbilledAmount，便于比较可用额度、已出账及未出账消费。

交易记录补充 txnId、mcc、postedDate 与 txnStatus。EMI 或 Pay Later 转换结果包含 emiAmount、tenureMonths、interestRate、monthlyInstalment、processingFee 与 firstDueDate。账单还款载荷通过 instrumentType 和 vpa 标识借记卡或 UPI 支付工具，结果记录在 paymentRef、paymentStatus、totalAmountDueAfter 与 creditLimitRestored 中。卡片控制状态落在 cardLocked、onlineLimit 与 perTxnLimit。个人理财聚合器可据此构建消费对账视图，会计团队可比较积分收入、黄金兑换与余额，客服团队可查看卡片控制状态，借贷分析团队则可将分期条款与还款结果对照。openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

请求/响应示例为依据应用界面重构的示意示例，并非实时抓包。

验证手机 OTP 会话

POST /v1/uni-card/session/otp-verify openbanking

完成打开登录会话的短信 OTP 步骤，返回客户 ID、令牌对，以及首页据以分支的 KYC 与卡片状态。

认证方式：无需令牌。已登记的手机号加短信 OTP 换取 accessToken 与 refreshToken；之后的调用会附带设备绑定与应用完整性请求头。

mobileNumber
otp
deviceId
appVersion
customerId
accessToken
refreshToken
tokenExpiry
isNewUser
kycStatus
cardStatus

POST /v1/uni-card/session/otp-verify HTTP/1.1
Content-Type: application/json
X-Device-Id: android-7f2c9a

{
  "mobileNumber": "9876543210",
  "otp": "471029",
  "deviceId": "android-7f2c9a",
  "appVersion": "2.24.1"
}

{
  "status": "SUCCESS",
  "data": {
    "customerId": "UNI-884213",
    "accessToken": "eyJhbGciOiJSUzI1NiJ9...",
    "refreshToken": "rt_5f81c2",
    "tokenExpiry": "2026-10-25T19:40:00+05:30",
    "isNewUser": false,
    "kycStatus": "VERIFIED",
    "cardStatus": "ACTIVE"
  }
}

KYC 与开户状态
GET /v1/uni-card/onboarding/kyc-status openbanking
报告客户处于开户的哪一步：Aadhaar 与 PAN 校验、视频 KYC、地址与证件相机凭证，以及解锁发卡的已批准信用额度。
认证方式：携带 OTP 会话返回的 Bearer accessToken；证件与人脸步骤经合作的身份验证 SDK 完成，并回传其引用。
- customerId
- aadhaarVerified
- panVerified
- vkycStatus
- addressStatus
- doccamUploaded
- eligibilityStatus
- approvedCreditLimit
- pendingStep
```
GET /v1/uni-card/onboarding/kyc-status HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "status": "SUCCESS",
  "data": {
    "customerId": "UNI-884213",
    "aadhaarVerified": true,
    "panVerified": true,
    "vkycStatus": "COMPLETED",
    "addressStatus": "VERIFIED",
    "doccamUploaded": true,
    "eligibilityStatus": "APPROVED",
    "approvedCreditLimit": 150000,
    "pendingStep": null
  }
}
```

信用额度汇总

GET /v1/uni-card/credit-line/summary openfinance

为首页信用额度卡片和卡片汇总提供数据：核准额度、可用余量、已出账与未出账消费以及下一个到期日。

认证方式：携带 OTP 会话返回的 Bearer accessToken。

creditLine
availableLimit
usedLimit
unbilledAmount
billedAmount
totalAmountDue
minimumDue
dueDate
statementDate
currency

GET /v1/uni-card/credit-line/summary HTTP/1.1
Authorization: Bearer <accessToken>

{
  "status": "SUCCESS",
  "data": {
    "creditLine": 150000,
    "availableLimit": 112480.5,
    "usedLimit": 37519.5,
    "unbilledAmount": 4210.0,
    "billedAmount": 33309.5,
    "totalAmountDue": 33309.5,
    "minimumDue": 1665.48,
    "dueDate": "2026-11-05",
    "statementDate": "2026-10-18",
    "currency": "INR"
  }
}

查看卡片详情

POST /v1/uni-card/card/details openbanking

支撑查看并复制卡片详情的面板，返回掩码卡号、有效期、卡片版本，以及 UPI 背后的 RuPay 伴侣虚拟卡。

认证方式： Bearer accessToken 加一次升级验证 OTP 或设备认证；展示结果短时有效，并按卡逐次记录。

cardId
cardNumber
cardHolderName
expiryMonth
expiryYear
cvv
cardType
cardVariant
network
rupayVpa

POST /v1/uni-card/card/details HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "cardId": "card_goldx_01",
  "revealField": "FULL",
  "otp": "884120"
}

{
  "status": "SUCCESS",
  "data": {
    "cardId": "card_goldx_01",
    "cardNumber": "4581 22XX XXXX 9043",
    "cardHolderName": "PRIYA SHARMA",
    "expiryMonth": "09",
    "expiryYear": "2029",
    "cvv": "***",
    "cardType": "MASTERCARD",
    "cardVariant": "GOLDX",
    "network": "DUAL",
    "rupayVpa": "priya.884213@uni"
  }
}

卡片控制与限额

POST /v1/uni-card/controls/limits openbanking

读取并写入卡片控制面板：锁定状态、渠道开关，以及线上、单笔和 ATM 使用的卢比限额。

认证方式：携带 OTP 会话返回的 Bearer accessToken；敏感开关会再次要求 MPIN 或生物识别。

cardId
cardLocked
onlineEnabled
contactlessEnabled
internationalEnabled
onlineLimit
perTxnLimit
atmLimit
updatedAt

POST /v1/uni-card/controls/limits HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "cardId": "card_goldx_01",
  "cardLocked": true,
  "onlineEnabled": true,
  "contactlessEnabled": false,
  "internationalEnabled": true,
  "onlineLimit": 50000,
  "perTxnLimit": 25000,
  "atmLimit": 10000
}

{
  "status": "SUCCESS",
  "data": {
    "cardId": "card_goldx_01",
    "cardLocked": true,
    "onlineEnabled": true,
    "contactlessEnabled": false,
    "internationalEnabled": true,
    "onlineLimit": 50000,
    "perTxnLimit": 25000,
    "atmLimit": 10000,
    "updatedAt": "2026-10-25T12:04:11+05:30"
  }
}

交易记录

GET /v1/uni-card/transactions openfinance

分页返回首页列表与汇总交易视图背后的交易流，含商户、MCC、渠道、状态以及每笔消费赚到的积分。

认证方式：携带 OTP 会话返回的 Bearer accessToken。

page
pageSize
total
txnId
merchantName
mcc
amount
currency
postedDate
txnStatus
channel
isEmi
uniCoinsEarned

GET /v1/uni-card/transactions?from=2026-09-01&to=2026-10-25&page=1&pageSize=50 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "status": "SUCCESS",
  "data": {
    "page": 1,
    "pageSize": 50,
    "total": 143,
    "transactions": [
      {
        "txnId": "TXN8891243",
        "merchantName": "SWIGGY",
        "mcc": "5812",
        "amount": 842.0,
        "currency": "INR",
        "postedDate": "2026-10-22",
        "txnStatus": "POSTED",
        "channel": "ONLINE",
        "isEmi": false,
        "uniCoinsEarned": 842
      }
    ]
  }
}

月度账单

GET /v1/uni-card/statements/{statementId} openfinance

以汇总加分类行的形式返回一个账期：期初余额、还款、新增消费、应还金额，以及账单页绘图用的消费占比。

认证方式：携带 OTP 会话返回的 Bearer accessToken。

statementId
statementDate
dueDate
totalAmountDue
minimumDue
previousBalance
paymentsReceived
newPurchases
categories
categoryCode
label
amount
lineItems

GET /v1/uni-card/statements/STMT-2026-10 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "status": "SUCCESS",
  "data": {
    "statementId": "STMT-2026-10",
    "statementDate": "2026-10-18",
    "dueDate": "2026-11-05",
    "totalAmountDue": 33309.5,
    "minimumDue": 1665.48,
    "previousBalance": 28410.0,
    "paymentsReceived": 12000.0,
    "newPurchases": 16899.5,
    "categories": [
      {
        "categoryCode": "DINING",
        "label": "Food & Dining",
        "amount": 4210.0
      }
    ],
    "lineItems": 64
  }
}

信用卡账单还款

POST /v1/uni-card/repayment openbanking

用借记卡或 UPI VPA 发起账单还款，支持最低还款额、全额与自定义金额，并返回支付参考号与恢复的额度。

认证方式： Bearer accessToken 加支付工具会话；银行卡与 UPI 工具在扣款前先做令牌化。

amount
instrumentType
vpa
repaymentType
paymentRef
paymentStatus
totalAmountDueAfter
creditLimitRestored
lateFeeWaived

POST /v1/uni-card/repayment HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "amount": 1665.48,
  "instrumentType": "UPI",
  "vpa": "priya@okhdfcbank",
  "repaymentType": "MINIMUM_DUE"
}

{
  "status": "SUCCESS",
  "data": {
    "paymentRef": "PAY-7719032",
    "amount": 1665.48,
    "instrumentType": "UPI",
    "vpa": "priya@okhdfcbank",
    "paymentStatus": "PROCESSING",
    "totalAmountDueAfter": 31644.02,
    "creditLimitRestored": 112480.5,
    "lateFeeWaived": true
  }
}

将消费转为 EMI 或 Pay Later

POST /v1/uni-card/transactions/{txnId}/convert openfinance

把一笔已入账消费转成按期数的 EMI 或 Pay Later 计划，返回月供、利率、手续费，以及还款计划所依附的贷款 ID。

认证方式：携带 OTP 会话返回的 Bearer accessToken。

txnId
conversionType
convertedAmount
emiAmount
tenureMonths
interestRate
monthlyInstalment
processingFee
firstDueDate
loanId

POST /v1/uni-card/transactions/TXN8891243/convert HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "conversionType": "EMI",
  "tenureMonths": 6,
  "planId": "PLAN_6M_LOW"
}

{
  "status": "SUCCESS",
  "data": {
    "txnId": "TXN8891243",
    "conversionType": "EMI",
    "convertedAmount": 842.0,
    "emiAmount": 147.9,
    "tenureMonths": 6,
    "interestRate": 15.99,
    "monthlyInstalment": 147.9,
    "processingFee": 99.0,
    "firstDueDate": "2026-11-05",
    "loanId": "EMI-449021"
  }
}

Uni Coins 与 GoldX 金库
GET /v1/uni-card/rewards/vault openfinance
返回奖励台账与 GoldX 金库：按 100 枚兑 1 卢比计价的积分余额、托管方持有的黄金克数及其实时卢比价值。
认证方式：携带 OTP 会话返回的 Bearer accessToken。
- uniCoins
- coinToRupeeRate
- goldGrams
- goldValue
- goldPurity
- custodian
- lifetimeCoinsEarned
- pendingCoins
- goldRatePerGram
```
GET /v1/uni-card/rewards/vault HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "status": "SUCCESS",
  "data": {
    "uniCoins": 128400,
    "coinToRupeeRate": 0.01,
    "goldGrams": 0.6421,
    "goldValue": 7480.3,
    "goldPurity": "24K",
    "custodian": "AUGMONT",
    "lifetimeCoinsEarned": 902140,
    "pendingCoins": 1840,
    "goldRatePerGram": 11649.0
  }
}
```

将积分兑换为黄金或返现

POST /v1/uni-card/rewards/convert openfinance

把 Uni Coins 兑成金库中的 24K 数字黄金或返现入账，记录按当日金价入账的克数与兑换后的余额。

认证方式：携带 OTP 会话返回的 Bearer accessToken。

coins
conversionType
redeemMode
conversionId
coinsDebited
goldGramsCredited
goldRatePerGram
uniCoinsAfter
goldGramsAfter
settlementStatus

POST /v1/uni-card/rewards/convert HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "coins": 50000,
  "conversionType": "GOLD",
  "redeemMode": "VAULT"
}

{
  "status": "SUCCESS",
  "data": {
    "conversionId": "CVT-33907",
    "coinsDebited": 50000,
    "conversionType": "GOLD",
    "goldGramsCredited": 0.0429,
    "goldRatePerGram": 11649.0,
    "uniCoinsAfter": 78400,
    "goldGramsAfter": 0.685,
    "settlementStatus": "SUCCESS"
  }
}

UPI 扫码支付

POST /v1/uni-card/upi/scan-pay openbanking

从 RuPay 信用卡伴侣卡通过 UPI 向商户 VPA 付款，返回 UPI 参考号、赚到的积分以及扣款后剩余的信用额度。

认证方式： Bearer accessToken 加在设备密钥库中输入的 UPI PIN；由 RuPay 伴侣卡出资扣款。

vpa
amount
currency
note
instrument
upiTxnId
txnStatus
uniCoinsEarned
availableLimitAfter
merchantName

POST /v1/uni-card/upi/scan-pay HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "vpa": "merchant@okaxis",
  "amount": 350.0,
  "currency": "INR",
  "note": "Groceries",
  "instrument": "RUPAY_CC"
}

{
  "status": "SUCCESS",
  "data": {
    "upiTxnId": "UPI4471920",
    "vpa": "merchant@okaxis",
    "amount": 350.0,
    "instrument": "RUPAY_CC",
    "txnStatus": "SUCCESS",
    "uniCoinsEarned": 350,
    "availableLimitAfter": 112130.5,
    "merchantName": "SHARMA STORES"
  }
}

数据类别

卡片与信用额度状态
卡片控制与限额
交易记录
月度账单与消费分类
账单还款记录
EMI 与 Pay Later 转换
Uni Coins 奖励
24K 数字黄金金库
UPI VPA 支付
KYC 与开户状态

数据使用场景与案例

卡片组合消费对账
个人理财聚合器从交易流中分页拉取 txnId、merchantName、mcc、postedDate 与 txnStatus，把它们与账单里的 categoryCode 分类行关联，再用额度汇总中的 totalAmountDue、minimumDue 与 dueDate 对已出账与未出账消费做对账。
奖励兑黄金台账
会计任务按每笔消费追踪 uniCoinsEarned，对照金库的 uniCoins 与 goldGrams，用 goldRatePerGram 为兑换估价，并标出 goldGramsCredited 与 coinsDebited 在 100 枚兑 1 卢比的比率下对不上的兑换。
卡片运营控制台
客服控制台读取 cardLocked、onlineEnabled、internationalEnabled、perTxnLimit 与 atmLimit，让坐席在补发或解锁卡片前确认各渠道状态，并读取 cardType、cardVariant 与 network 识别用于 UPI 的 RuPay 伴侣卡。
EMI 与还款分析
借贷分析管道从转换响应中收集 emiAmount、tenureMonths、interestRate、processingFee 与 monthlyInstalment，再匹配还款中的 paymentRef 与 paymentStatus 行，算出每期账单实际结清了多少。

常见问题

Uni GoldX 应用暴露哪些数据？

额度汇总（creditLine、availableLimit、usedLimit、unbilledAmount、totalAmountDue、minimumDue、dueDate）、分页的交易流（txnId、merchantName、mcc、postedDate、txnStatus、uniCoinsEarned）、带消费 categoryCode 分类行的月度账单、EMI 转换结果（emiAmount、tenureMonths、interestRate、monthlyInstalment）以及奖励金库（uniCoins、goldGrams、goldValue、goldRatePerGram）。

卡片会话以及敏感卡片或 UPI 操作如何鉴权？

手机号加短信 OTP 换取绑定设备的 accessToken 与 refreshToken，后续调用以 Bearer 凭证携带访问令牌。查看卡片详情需追加 OTP 或设备认证，敏感的卡片控制变更可能要求 MPIN 或生物识别。商户 UPI 付款除 Bearer 会话外还需 UPI PIN。

GoldX 奖励在接口里如何表示？

消费赚取 Uni Coins，按 100 枚兑 1 卢比的比率计价。金库接口返回 uniCoins、coinToRupeeRate、goldGrams、goldValue 与 goldRatePerGram，兑换接口返回 coinsDebited、goldGramsCredited 以及兑换后的余额，因此可以还原出黄金台账。

哪些字段支持账单、还款与 EMI 对账？

账单包含 statementId、statementDate、totalAmountDue、minimumDue、previousBalance、paymentsReceived 与分类行。提交账单还款后返回 paymentRef、paymentStatus、totalAmountDueAfter 与 creditLimitRestored；提交消费转换后返回 loanId、emiAmount、tenureMonths、interestRate、monthlyInstalment、processingFee 与 firstDueDate，可将还款结果与账单金额及分期条款对照。

与 Uni: GoldX & UPI Credit Card 相似的应用

OneCard — OneCard 是 FPL Technologies 推出的印度金属信用卡，由 BOBCARD、Federal Bank、SBM Bank 等银行合作发卡；持卡人在 OneCard 应用里设置消费限额，开关境内/境外、线上/线下和闪付，并把消费转成分期。
Slice — Slice 发行 UPI 信用卡，可在线上线下所有支持 UPI 的场景使用信用额度，同时提供每周商户即时返现 sparks 和零余额储蓄账户。
CRED — CRED 是面向会员的印度应用，用来还信用卡账单、看还款提醒和消费明细，也可用信用额度扫 UPI 码或碰一碰支付。
iMobile — iMobile 是 ICICI 银行的官方手机银行，可申请信用卡、管理借记卡、信用卡和外汇卡，并即时开通用于 UPI 的 RuPay 信用卡。
Axis Mobile — Axis Mobile（open by Axis Bank）是 Axis Bank 的官方手机银行，宣传可办理 250 多项业务，包括 UPI 扫码支付和信用卡服务。
PayZapp — PayZapp 是 HDFC 银行的应用，用于 UPI、缴费和充值，也在同一应用内申请、管理、赚积分并偿还 Pixel 数字信用卡。
RBL MyCard — RBL MyCard 是 RBL 银行信用卡的官方安卓应用，用来查看账单、偿还卡债和浏览近期交易。
SBI Card — SBI Card 是印度国家银行集团的信用卡发卡方，官网把手机应用列为还款渠道，持卡人可缴欠款、查看账单、管理 PIN、办理 Flexipay 分期并挂失。

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

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

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

获取报价

Uni GoldX 数据 API：接口与字段

应用截图

API 端点一览

验证手机 OTP 会话

KYC 与开户状态

信用额度汇总

查看卡片详情

卡片控制与限额

交易记录

月度账单

信用卡账单还款

将消费转为 EMI 或 Pay Later

Uni Coins 与 GoldX 金库

将积分兑换为黄金或返现

UPI 扫码支付

数据类别

数据使用场景与案例

卡片组合消费对账

奖励兑黄金台账

卡片运营控制台

EMI 与还款分析

常见问题

与 Uni: GoldX & UPI Credit Card 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

Ajaib: Stock, Crypto, US Stock

Albert: Budgeting and Banking

AndroMoney

相关主题

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

Uni GoldX 数据 API：接口与字段

应用截图

API 端点一览

验证手机 OTP 会话

KYC 与开户状态

信用额度汇总

查看卡片详情

卡片控制与限额

交易记录

月度账单

信用卡账单还款

将消费转为 EMI 或 Pay Later

Uni Coins 与 GoldX 金库

将积分兑换为黄金或返现

UPI 扫码支付

数据类别

数据使用场景与案例

卡片组合消费对账

奖励兑黄金台账

卡片运营控制台

EMI 与还款分析

常见问题

相关应用

与 Uni: GoldX & UPI Credit Card 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

Ajaib: Stock, Crypto, US Stock

Albert: Budgeting and Banking

AndroMoney

相关主题

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