Перейти к основному содержанию
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
}

Обзор

Uzum FastPay Payment API используется для инициации платежа через Uzum’s FastPay system. Эндпоинт создает платежную транзакцию и возвращает payment_id that must be used later for fiscalization.

Поля запроса

ПолеТипОбяз.Описание
amountintegerPayment amount in sums
qr_codestringUnique Uzum transaction identifier

Поля ответа

✅ Успешный ответ 200

ПолеТипОписание
dataobjectДанные ответа
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

🚫 Ответ с ошибкой 400

Примечание: Даже при ошибке сервер возвращает HTTP 200.
ПолеТипОписание
datanullNo data returned
errorobjectError details
error.codeintegerInternal error code
error.messagestringПонятное описание ошибки
error.dataany | nullAdditional error details
is_successbooleanAlways false

Тело

application/json
amount
integer
обязательно

Payment amount in sums

Пример:

1000

qr_code
string
обязательно

Unique transaction identifier

Пример:

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

Ответ

Fiscalization successful

data
object
error
string | null
is_success
boolean
Пример:

true