Kaspi.kz 金卡、支付与收银数据 API

Kaspi.kz · 银行 4.5 ★

Kaspi.kz суперприложение 是 JSC Kaspi Bank 面向哈萨克斯坦的消费超级应用，由 Kaspi.kz 在 Google Play 上架。一个 Android 客户端把 Kaspi Gold（含儿童 Gold）、Kaspi Pay 二维码、Kaspi Shop、Kaspi Red、Kaspi Travel、Kaspi Депозит 与 Kaspi Business 收银收进同一首页：用户扫 Kaspi 二维码付款、向手机号或 IBAN 转坚戈、逛商城、预订休闲出行、管理金卡与家庭账户；商户则在应用内 mPOS 收款、发远程付款链接并办理退货。它是该国主要的消费金融入口，与 Halyk、Forte、Freedom Bank 争夺同一批坚戈钱包，Google Play 评分 4.46（约 85.1 万条评价）。

共享客户记录上的 productType、cardNumber 与 currency（KZT）同时喂给收银与 IBAN 通道；已保存的收款方以 subscriptionId 挂着 iban、transferAmount 与 feeAmount。收银回执落在 extTranId、buyerIinBin 与 receiptUrl 上；退货往返返回 qrToken、qrReturnId 与 expireDate。

司库对账定期坚戈 IBAN 付款，收单把二维码收款对到财政回执，家庭财务盯着儿童 Gold 的 clientStatus。openData Studio 把这些记录变成可调用的开放数据。

应用截图

API 端点一览

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

拉取应用配置表

POST /v1/client/config/resolve opendata

加载远程客户端配置文档，把各 miniapp 的具名入口（转账发起、二维码生成、银行账户）映射到客户端其余模块使用的实际 URL。

认证方式：登录后的 Auth2.0 会话可选；匿名客户端仍会提交 platform、build、installId 与 locale，以便解析各 miniapp 的具名 URL。

platform
build
userIdHash
installId
locale
userType
components
appSettingsVersion

POST /v1/client/config/resolve HTTP/1.1
Content-Type: application/json

{
  "platform": "android",
  "build": 2160869,
  "userIdHash": "u-8f21",
  "installId": "inst-c91a",
  "locale": "ru",
  "userType": "client",
  "components": ["transfersMiniapp", "mposMiniapp", "mainMiniapp"],
  "appSettingsVersion": 7
}

{
  "platform": "android",
  "build": 2160869,
  "userIdHash": "u-8f21",
  "installId": "inst-c91a",
  "locale": "ru",
  "userType": "client",
  "appSettingsVersion": 7,
  "components": ["transfersMiniapp", "mposMiniapp", "mainMiniapp"]
}

创建 IBAN 转账订阅

POST /v1/transfers/iban/standing-orders openbanking

从 Kaspi Gold 的 sourceAccount（productId、type、currency）保存可重复执行的 IBAN 付款到 targetAccount.iban，含 transferAmount、feeAmount、knpId 与 note，供转账 miniapp 使用。

认证方式： PIN 或密码登录后的 Auth2.0 会话。

sourceAccount
productId
type
currency
targetAccount
iban
transferAmount
feeAmount
requisiteInputMethod
knpId
note
requestParams
dduDocumentNumber
subscriptionId

POST /v1/transfers/iban/standing-orders HTTP/1.1
Content-Type: application/json

{
  "sourceAccount": {
    "productId": "gold-4412",
    "type": "Kaspi Gold",
    "currency": "KZT"
  },
  "targetAccount": {
    "type": "IBAN",
    "currency": "KZT",
    "iban": "KZ88999C000000000000"
  },
  "transferAmount": 15000.0,
  "feeAmount": 0.0,
  "requisiteInputMethod": "manual-iban",
  "knpId": 342,
  "note": "rent",
  "requestParams": {},
  "dduDocumentNumber": null
}

{
  "subscriptionId": "sub-77821",
  "sourceAccount": {
    "productId": "gold-4412",
    "type": "Kaspi Gold",
    "currency": "KZT"
  },
  "targetAccount": {
    "type": "IBAN",
    "currency": "KZT",
    "iban": "KZ88999C000000000000"
  },
  "transferAmount": 15000.0,
  "feeAmount": 0.0,
  "knpId": 342,
  "note": "rent"
}

删除转账订阅
POST /v1/transfers/standing-orders/remove openbanking
按 subscriptionId 从转账 miniapp 列表中删除此前保存的 IBAN 或手机号转账订阅。
认证方式： PIN 或密码登录后的 Auth2.0 会话。
- subscriptionId
- status
```
POST /v1/transfers/standing-orders/remove HTTP/1.1
Content-Type: application/json

{
  "subscriptionId": "sub-77821"
}
```
```
{
  "subscriptionId": "sub-77821",
  "status": "DELETED"
}
```
加载儿童 Gold 产品
GET /v1/family/cards/junior openbanking
打开家庭 Gold 流程使用的儿童 Gold 产品行：currency（KZT）、productType（Kaspi Gold）、掩码 cardNumber、clientName 与 clientStatus。
认证方式： PIN 或密码登录后的 Auth2.0 会话；儿童 Gold 依赖已关联的家庭产品。
- currency
- clientName
- productType
- cardNumber
- clientStatus
- clientStatusDesc
- agreementText
- processId
- favouritePaymentId
- transferId
```
GET /v1/family/cards/junior HTTP/1.1
Accept: application/json
```
```
{
  "currency": "KZT",
  "clientName": "Алихан",
  "productType": "Kaspi Gold",
  "cardNumber": "4405 43** **** 2218",
  "clientStatus": "ACTIVE",
  "clientStatusDesc": "active",
  "agreementText": "",
  "processId": 900441,
  "favouritePaymentId": null,
  "transferId": 551002
}
```

预览收银回执

GET /v1/merchant/receipts/lookup openfinance

按 extTranId 呈现收银回执，含 mPOS 操作与 KKM 开票模型中的 orderNumber、amount、buyerIinBin、rfoCode、totalPrice 与 receiptUrl。

认证方式： Auth2.0 会话，或二维码收款后发给收银端的 extTranId。

extTranId
id
orderNumber
orderRegDate
operationType
amount
isDebit
clientName
status
statusDesc
receiptUrl
rfoCode
totalPrice
receivedAmt
buyerIinBin
saleId
saleDeviceType

GET /v1/merchant/receipts/lookup?extTranId=ext-441902 HTTP/1.1
Accept: application/json

{
  "extTranId": "ext-441902",
  "id": 441902,
  "orderNumber": "KKM-100284",
  "orderRegDate": "2026-10-16T14:22:01+05:00",
  "operationType": 1,
  "amount": "15000.00",
  "isDebit": true,
  "clientName": "Алия",
  "status": "SUCCESS",
  "statusDesc": "paid",
  "receiptUrl": "https://receipts.example.com/r/ext-441902",
  "rfoCode": "620100",
  "totalPrice": "15000.00",
  "receivedAmt": "15000.00",
  "buyerIinBin": "850101300123",
  "saleId": "sale-778",
  "saleDeviceType": "mPOS"
}

mPOS 二维码退货
POST /v1/merchant/qr-sales/refund openfinance
对一笔 mPOS 收款发起 Kaspi 二维码退货，返回客户用金卡确认的 qrToken、qrReturnId、expireDate 与 sourceType（UNIFIEDQRACCOUNT）。
认证方式： mPOS miniapp 内的 Auth2.0 商户会话。
- qrToken
- status
- qrReturnId
- expireDate
- paymentBehaviorOptions
- sourceType
- qrOperationId
- amount
```
POST /v1/merchant/qr-sales/refund HTTP/1.1
Content-Type: application/json

{
  "qrOperationId": 441902,
  "amount": "15000.00"
}
```
```
{
  "qrToken": "ret-2c18",
  "status": "WAIT_CUSTOMER",
  "qrReturnId": 99012,
  "expireDate": "2026-10-16T14:32:01+05:00",
  "sourceType": "UNIFIEDQRACCOUNT"
}
```
公共电子单据柜
GET /v1/documents/government/cabinet opendata
打开超级应用内用于政府证明与对账单的公共服务电子单据柜。
认证方式： Auth2.0 会话；公共服务 miniapp 在登录后打开该单据柜。
- locale
- userType
- clientName
```
GET /v1/documents/government/cabinet HTTP/1.1
Accept: application/json
```
```
{
  "locale": "ru",
  "userType": "client",
  "clientName": "Алия"
}
```
Travel 休闲目录
GET /v1/catalog/experiences opendata
加载超级应用 Travel 磁贴打开的 Kaspi Travel 休闲目录（体验与票务）。
认证方式： Auth2.0 会话可选；匿名浏览仍可加载休闲目录。
- locale
```
GET /v1/catalog/experiences HTTP/1.1
Accept: application/json
```
```
{
  "locale": "ru"
}
```

数据类别

余额
转账
交易流水
商户收款
回执

数据使用场景与案例

IBAN 订阅资金调度
企业司库机器人保存每笔 IBAN 付款（iban、transferAmount、feeAmount、knpId），并在员工从金卡增删定期坚戈转账时对比 subscriptionId 行。
商户二维码清算
收单运营把 qrOperationId 收款与收银回执（extTranId、buyerIinBin、totalPrice）对齐，并标出 qrReturnId 与 expireDate 从未变为确认态的退货。
收银回执台账
店铺看板按 orderNumber、amount 与 isDebit 列出收银 Operation 行，再把每张 receiptUrl/extTranId 对齐，店主无需从收银导出 CSV 即可把二维码实收对到财政小票。
家庭 Gold 监护
家庭财务产品盯着儿童 Gold 行（productType、cardNumber、clientStatus、transferId），在儿童产品被解绑或出现新 transferId 时提醒家长。

常见问题

Kaspi.kz 客户端暴露哪些金融对象？

金卡客户记录（productType、cardNumber、currency）、可重复执行的 IBAN 订阅（iban、transferAmount、feeAmount、knpId）、收银回执（extTranId、buyerIinBin、receiptUrl、amount）以及 mPOS 二维码退货（qrToken、qrReturnId、expireDate）。

这些调用如何鉴权？

PIN 或密码登录后，应用持有一个 Auth2.0 会话，后续金卡、转账与 mPOS 调用都会带上。各 miniapp 的具名 URL 本身在启动时从远程配置文档解析。

这是 Kaspi 的公开开发者 API 吗？

不是。Kaspi 没有为消费者超级应用提供公开开发者 API。本页的端点是对 Android 应用登录后所用数据面的示意性、仅含路径的建模，而非受支持的公开 SDK。

与 Kaspi.kz суперприложение 相似的应用

Halyk SuperApp — Halyk SuperApp 是人民银行（Halyk Bank）面向哈萨克斯坦的消费端应用，覆盖手机号与二维码转账、数字卡、账单缴费、存款以及 Halyk Market 分期购物。
Freedom SuperApp — Freedom SuperApp 是 Freedom Bank Kazakhstan 的消费端应用，把转账付款与保险保单、外汇兑换、资产管理以及机票购买放在同一客户端。
ForteMobile — ForteMobile 是 ForteBank 在哈萨克斯坦的零售应用，用于银行卡、转账以及 ForteMarket 商城购物（分期或信贷），并衔接该行贷款与存款。
bcc.kz — bcc.kz 是银行中心信贷（Bank CenterCredit）的消费端应用，提供按手机号与卡对卡转账、贷记/借记卡、应用内现金贷以及外汇兑换。
Home.kz — Home.kz 是哈萨克斯坦 Home Credit Bank 的消费端应用，用于在线现金贷与分期贷、借记/信用卡，以及向其他哈萨克银行免手续费的手机号转账。
Eurasian Bank — Eurasian Bank 的 Android 与 iOS 应用是该行在哈萨克斯坦的消费入口，用于账户产品、二维码付款以及应用内 TOM/SPOT 外汇兑换。

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

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

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

获取报价

Kaspi.kz 金卡、支付与收银数据 API

应用截图

API 端点一览

拉取应用配置表

创建 IBAN 转账订阅

删除转账订阅

加载儿童 Gold 产品

预览收银回执

mPOS 二维码退货

公共电子单据柜

Travel 休闲目录

数据类别

数据使用场景与案例

IBAN 订阅资金调度

商户二维码清算

收银回执台账

家庭 Gold 监护

常见问题

与 Kaspi.kz суперприложение 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

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

Kaspi.kz 金卡、支付与收银数据 API

应用截图

API 端点一览

拉取应用配置表

创建 IBAN 转账订阅

删除转账订阅

加载儿童 Gold 产品

预览收银回执

mPOS 二维码退货

公共电子单据柜

Travel 休闲目录

数据类别

数据使用场景与案例

IBAN 订阅资金调度

商户二维码清算

收银回执台账

家庭 Gold 监护

常见问题

相关应用

与 Kaspi.kz суперприложение 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

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