Account2Card

Account2Card kompaniya bank hisobidan foydalanuvchining bank kartasiga pul o‘tkazish uchun ishlatiladi. Bu jarayon merchantga Paylov tizimida avval yaratilgan kartaga mablag‘ yuborish imkonini beradi.

Summa formati

A2C bo‘yicha barcha summalar tiyin ko‘rinishida yuboriladi va qaytariladi. Masalan, 2500000 qiymati 25,000.00 UZS degani.

1. Tranzaksiyani Amalga Oshirish

A2C tranzaksiyasini yaratadi va tanlangan foydalanuvchi kartasiga mablag‘ yuboradi.

Endpoint

POST {BASE_URL}/merchant/a2c/performTransaction/

Headers

Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

Request Body

Field	Type	Required	Description
amountInTiyin	integer	Yes	O‘tkazma summasi tiyin ko‘rinishida
userId	string	Yes	Merchant tomonidan berilgan foydalanuvchi ID
cardId	string	Yes	Paylov tizimida yaratilgan karta ID
externalId	string	No	Merchant tomondagi tashqi tranzaksiya ID

{
  "amountInTiyin": 2500000,
  "userId": "string",
  "cardId": "string",
  "externalId": "string"
}

Success Response

{
  "transactionId": "9bd1a92b-5cce-47c8-a2df-99a20836ab9e",
  "status": "0",
  "statusText": "SUCCESS"
}

Field	Type	Description
transactionId	string	A2C tranzaksiya ID
status	string	Tranzaksiya status kodi
statusText	string	Tranzaksiya statusining matnli ko‘rinishi

Error Response

{
  "result": null,
  "error": {
    "code": "processing_error",
    "message": "processing_error",
    "data": "CARD_TYPE_NOT_SUPPORTED"
  }
}

2. Tranzaksiya Statusini Tekshirish

A2C tranzaksiyasining statusini transactionId orqali qaytaradi.

Endpoint

GET {BASE_URL}/merchant/a2c/checkTransaction/{transactionId}/

Headers

Authorization: Bearer <ACCESS_TOKEN>

Path Parameters

Field	Type	Required	Description
transactionId	string	Yes	performTransaction orqali qaytgan A2C tranzaksiya ID

Success Response

{
  "status": "0",
  "statusText": "SUCCESS",
  "amountInTiyin": 2500000
}

Field	Type	Description
status	string	Tranzaksiya status kodi
statusText	string	Tranzaksiya statusining matnli ko‘rinishi
amountInTiyin	integer	O‘tkazma summasi tiyin ko‘rinishida

3. Tranzaksiya Statusini External ID Orqali Tekshirish

A2C tranzaksiyasining statusini merchant tomondagi externalId orqali qaytaradi.

Endpoint

GET {BASE_URL}/merchant/a2c/checkTransaction/byExternalId/{externalId}/

Headers

Authorization: Bearer <ACCESS_TOKEN>

Path Parameters

Field	Type	Required	Description
externalId	string	Yes	performTransaction so‘rovida yuborilgan tashqi tranzaksiya ID

Success Response

{
  "status": "0",
  "statusText": "SUCCESS",
  "amountInTiyin": 2500000
}

4. Hisob Balansini Olish

A2C o‘tkazmalari uchun mavjud merchant deposit balansini qaytaradi.

Endpoint

GET {BASE_URL}/merchant/a2c/balance/

Headers

Authorization: Bearer <ACCESS_TOKEN>

Success Response

{
  "balance": 50000
}

Field	Type	Description
balance	integer	Mavjud balans tiyin ko‘rinishida

Balans formati

50000 qiymati 500.00 UZS degani.

Statuslar

Yuqoridagi misollarda muvaffaqiyatli tranzaksiya uchun status: "0" ishlatilgan. Umumiy Paylov status kodlari uchun Statuslar sahifasini ko‘ring.