Skip to main content
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
}

​
Overview

The Uzum FastPay Payment API is used to initiate a payment through Uzum’s FastPay system. This endpoint creates a payment transaction and returns a payment_id that must be used later for fiscalization.

​
Request Fields

FieldTypeRequiredDescription
amountinteger✅Payment amount in sums
qr_codestring✅Unique Uzum transaction identifier

​
Response Fields

​
✅ Success Response 200

FieldTypeDescription
dataobjectResponse payload
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

​
🚫 Error Response 400

Note: Even server says about error HTTP status code will be 200
FieldTypeDescription
datanullNo data returned
errorobjectError details
error.codeintegerInternal error code
error.messagestringHuman-readable error message
error.dataany | nullAdditional error details
is_successbooleanAlways false

Body

application/json
​
amount
integer
required

Payment amount in sums

Example:

1000

​
qr_code
string
required

Unique transaction identifier

Example:

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

Response

Fiscalization successful

​
data
object
​
error
string | null
​
is_success
boolean
Example:

true