Asosiy tarkibga o'tish
POST
/
payment
/
uzum
Uzum FastPay payment
curl --request POST \
  --url https://fbox.ngrok.io/payment/uzum \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000,
  "qr_code": "7993:5061401:01KFDH7KB4KNBJD8QRVFBVQ39X:3sySIUxrog+hhtBwUXquxn97N5k="
}
'
{
  "data": {
    "payment_id": "bb75f609-6d97-4b45-9ed3-80e5fcd19ef1",
    "payment_status": "SUCCESS",
    "error_code": "0",
    "error_message": null,
    "client_phone_number": "998712565009"
  },
  "error": null,
  "is_success": true
}

Umumiy ko’rinish

Uzum FastPay Payment API orqali to’lovni boshlash uchun ishlatiladi Uzum’s FastPay system. Bu endpoint to’lov tranzaksiyasini yaratadi va payment_id qaytaradi that must be used later for fiscalization.

So’rov maydonlari

MaydonTuriMajburiyTavsif
amountintegerPayment amount in sums
qr_codestringUnique Uzum transaction identifier

Javob maydonlari

✅ Muvaffaqiyatli javob 200

MaydonTuriTavsif
dataobjectJavob ma’lumoti
data.payment_idstringUnique payment identifier
data.payment_statusstringPayment status (SUCCESS, FAILED, etc.)
data.error_codestringProvider error code (0 on success)
data.error_messagestring | nullError description (null on success)
data.client_phone_numberstringClient phone number
errornullError object (always null on success)
is_successbooleanAlways true

🚫 Xatolik javobi 400

Eslatma: Xatolik holatida ham server HTTP 200 qaytaradi.
MaydonTuriTavsif
datanullNo data returned
errorobjectError details
error.codeintegerInternal error code
error.messagestringO’qilishi oson xato xabari
error.dataany | nullAdditional error details
is_successbooleanAlways false

Tanasi

application/json
amount
integer
talab qilinadi

Payment amount in sums

Misol:

1000

qr_code
string
talab qilinadi

Unique transaction identifier

Misol:

"7993:5061401:01KFDH7KB4KNBJD8QRVFBVQ39X:3sySIUxrog+hhtBwUXquxn97N5k="

Javob

Fiscalization successful

data
object
error
string | null
is_success
boolean
Misol:

true