Перейти к основному содержанию
POST
/
payment
/
uzum_confirm
Fiscalization Uzum payment
curl --request POST \
  --url https://fbox.ngrok.io/payment/uzum_confirm \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment_id": "bb75f609-6d97-4b45-9ed3-80e5fcd19ef1",
  "qr_code": "https://ofd.soliq.uz/check?t=UZ170703100597&r=2421&c=20230104121801&s=514343190161"
}
'
{
  "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 Fiscalization API используется для завершения (фискализации) ранее initiated Uzum FastPay payment. Эндпоинт подтверждает платеж, прикрепляя фискальный чек, сгенерированный by Soliq (OFD).

​
Поля запроса

ПолеТипОбяз.Описание
payment_idstring✅Unique payment identifier received from Uzum FastPay payment
qr_codestring✅URL of the fiscal receipt from Soliq (OFD)

​
Поля ответа

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

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

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

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

Тело

application/json
​
payment_id
string
обязательно

Unique order identifier received in the /uzum/api/apelsin-pay/merchant/v2/payment response and provided by Uzum.

Пример:

"bb75f609-6d97-4b45-9ed3-80e5fcd19ef1"

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

Link to fiscalization transaction on Soliq

Пример:

"https://ofd.soliq.uz/check?t=UZ170703100597&r=2421&c=20230104121801&s=514343190161"

Ответ

Fiscalization successful

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

true