Kartalar bilan operatsiyalar
1. Card Add
POST- api/v1/card/add
Request header
Field | Optional | Description |
|---|---|---|
Content-Type | true | application/json |
X-Lang | true | Language |
Request Body
Field | Optional | Description |
|---|---|---|
pan | false | Karta raqami (Uzcard, Humo) |
expiry | false | Karta amal qilish muddati (MMyy) |
phone | false | Egasining telefon raqami |
Response Description
Field | Description |
|---|---|
id | Kartani tasdiqlash uchun vaqtinchalik token |
maskedPan | Karta raqami, maskalangan ko‘rinishda |
phone | Egasining telefon raqami, maskalangan ko‘rinishda |
Request sample
{
"pan": "860049******0000",
"expiry": "2605",
"phone": "998123456789"
}Response sample
{
"code": "SUCCESS",
"data": {
"id": "93defc66-4960-4fd1-85b7-1c312e6b93cd",
"maskedPan": "860049******0000",
"phone": "99899***1232"
},
"errorMessage": null,
"timestamp": 1751372597794
}Response sample
{
"code": "DATA_NOT_FOUND",
"data": null,
"errorMessage": "Карта не найдена",
"timestamp": 1751372597794
}2. Card Verify
POST- api/v1/card/verify
Request header
Field | Optional | Description |
|---|---|---|
Content-Type | true | application/json |
X-Lang | true | Language |
Request Body
Field | Optional | Description |
|---|---|---|
id | false | oldingi so‘rovdan olingan qiymat |
code | false | SMS kod |
Response Description
Field | Description |
|---|---|
maskedPan | Karta raqami, maskalangan ko‘rinishda |
holderName | Egasining ismi |
currency | Karta valyutasi |
isPrivate | Bu bayroq karta shaxsiy yoki korporativ ekanini bildiradi. true — shaxsiy karta, false — korporativ |
status | Karta holati. Barcha holatlarni hujjatning quyi qismida ko‘rish mumkin |
token | Karta tokeni |
accountType | Karta turi |
bankName | Emitent bank nomi |
Request sample
{
"id": "93defc66-4960-4fd1-85b7-1c312e6b93cd",
"code": "444455"
}Response sample
{
"code": "SUCCESS",
"data": {
"maskedPan": "860049******0000",
"holderName": "someone",
"currency": "UZS",
"isPrivate": true,
"status": 0,
"token": "tokenCardForDebit"
},
"errorMessage": null,
"timestamp": 1751372597794
}Response sample
{
"code": "DATA_NOT_FOUND",
"data": null,
"errorMessage": "Карта не найдена",
"timestamp": 1751372597794
}3. Card Info
POST- api/v1/card/info
Request header
Field | Optional | Description |
|---|---|---|
Content-Type | true | application/json |
X-Lang | true | Language |
Request Body
Field | Optional | Description |
|---|---|---|
token | false | Karta tokeni |
Response Description
Field | Description |
|---|---|
maskedPan | Karta raqami, maskalangan ko‘rinishda |
currency | Karta valyutasi |
isPrivate | Bu bayroq karta shaxsiy yoki korporativ ekanini bildiradi. true — shaxsiy karta, false — korporativ |
status | Karta holati. Barcha holatlarni hujjatning quyi qismida ko‘rish mumkin |
accountType | Karta turi |
bankName | Emitent bank nomi |
Request sample
{
"token": "tokenCardForDebit"
}Response sample
{
"code": "SUCCESS",
"data": {
"maskedPan": "860049******0000",
"currency": "UZS",
"isPrivate": true,
"status": "ACTIVE",
"accountType": "UZCARD",
"bankName": "Orient Finans Bank"
},
"errorMessage": null,
"timestamp": 1751372597794
}Response sample
{
"code": "DATA_NOT_FOUND",
"data": null,
"errorMessage": "Карта не найдена",
"timestamp": 1751372597794
}4. Card delete
POST- api/v1/card/delete
Request header
Field | Optional | Description |
|---|---|---|
Content-Type | true | application/json |
X-Lang | true | Language |
Request Body
Field | Optional | Description |
|---|---|---|
token | false | Karta tokeni |
Response Description
Field | Description |
|---|---|
message | Xabar |
Request sample
{
"token": "tokenCardForDebit"
}Response sample
{
"code": "SUCCESS",
"data": {
"message": "success"
},
"errorMessage": null,
"timestamp": 1751372597794
}Response sample
{
"code": "DATA_NOT_FOUND",
"data": null,
"errorMessage": "Карта не найдена",
"timestamp": 1751372597794
}5. Card balance check
POST- api/v1/card/check
Request header
Field | Optional | Description |
|---|---|---|
Content-Type | true | application/json |
X-Lang | true | Language |
Request Body
Field | Optional | Description |
|---|---|---|
token | false | Karta tokeni |
amount | false | Tekshirilayotgan summa, tiyinda |
Response Description
Field | Description |
|---|---|
type | Tegishli prosessing nomi |
bankName | Emitent bank nomi |
hasAvailableAmount | So‘ralgan summa mavjudmi yoki yo‘qmi |
Request sample
{
"token": "tokenCardForCheck",
"amount": 1223400
}Response sample
{
"code": "SUCCESS",
"data": {
"type": "UZCARD",
"bankName": "TBC Bank",
"hasAvailableAmount": true
},
"errorMessage": null,
"timestamp": 1751372597794
}Response sample
{
"code": "DATA_NOT_FOUND",
"data": null,
"errorMessage": "Карта не найдена",
"timestamp": 1751372597794
}