PaymentInfoDTO

Full payment details object. Returned by GET /v1/open-api/payment/{id}.

idint64

Payment ID

Example: 98765

uuidstringnullable

Payment UUID

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

numberstring

Payment number

Example: PAY-00123

amountdouble

Payment amount

Example: 5000000

basePaymentBase

Payment source enum — which entity the payment belongs to.

• CONTRACT — Contract payment
• SURCHARGE — Fine / penalty payment
• CLIENT — Client balance top-up
• BOOKING — Booking (reservation) payment
• CASHBACK — Cashback payment

Possible values: [CONTRACT, SURCHARGE, CLIENT, BOOKING, CASHBACK]

Example: CONTRACT

typePaymentType

Payment method enum.

• CARD — Card
• CASH — Cash
• TRANSFER — Transfer (card to card)
• BALANCE — From client balance
• BANK — Via bank
• PAYME — Payme
• MY_UZCARD — MyUzcard
• UZUM — Uzum
• PAYLOV — Paylov
• UYSOT_PAY — Uysot pay
• ATMOS — Atmos
• OTHERS — Others
• CUSTOM — Custom
• CASHBACK — Cashback
• CLICK — Click

Possible values: [CARD, CASH, TRANSFER, BALANCE, BANK, PAYME, MY_UZCARD, UZUM, PAYLOV, UYSOT_PAY, ATMOS, OTHERS, CUSTOM, CASHBACK, CLICK]

Example: CASH

debitPaymentDebit

Payment direction enum.

• INCOME — Income
• OUTCOME — Outcome

Possible values: [INCOME, OUTCOME]

Example: INCOME

notestringnullable

Payment note

Example: Advance payment

mortgagebooleannullable

Whether it is a mortgage payment

Example: false

customTypeNamestringnullable

Custom payment type name (present when type is CUSTOM)

Example: Online payment

timestampint64nullable

Payment date (epoch seconds)

Example: 1718000000

createdTimestampint64nullable

System entry time (epoch seconds)

Example: 1718001000

payerIdint64nullable

Payer client ID

Example: 3001

payerstring

Payer client full name

Example: Aliyev Vohid

payerPhonesstring[]

Payer client phone numbers.

Example: ["+998901234567"]

createdByIdint32nullabledeprecated

ID of the employee who created the payment. Use createdBy.id instead.

Example: 42

createdBy object

Employee who created the payment. Breaking change: this used to be the employee's name as a plain string; the name now lives in createdByName.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

createdByNamestringdeprecated

Full name of the employee who created the payment. Use createdBy.fullName instead.

Example: Toshmatov Saidakbar

currency object

Currency information object.

idint32

Currency ID

Example: 1

valuedouble

Exchange rate (1 for the basic currency)

Example: 1

updateTimestampint64

Last update time (epoch seconds)

Example: 1672531200

basicboolean

Whether it's the company's basic currency

Example: true

ccystring

Currency code

Example: USD

exchangedoublenullable

Exchange rate at time of payment

Example: 12800

basicExchangedoublenullable

Exchange rate in the basic currency

Example: 1

branchIdint32nullable

Branch ID

Example: 1

branchNamestringnullable

Branch name

Example: Chilonzor

buildingIdint32nullable

Building ID

Example: 10

buildingNamestringnullable

Building name

Example: A blok

houseIdint32nullable

House (residential complex) ID

Example: 2

houseNamestringnullable

House (residential complex) name

Example: Navruz

contractIdint32nullable

Contract ID (present for CONTRACT / SURCHARGE payments)

Example: 1409

contractNumberstringnullable

Contract number (present for CONTRACT / SURCHARGE payments)

Example: SH-2024-001

bookingIdint64nullable

Booking ID (present for BOOKING payments)

Example: 512

canceledTimestampint64nullable

Cancellation time (epoch seconds)

Example: 1718100000

cancelNotestringnullable

Cancellation reason

Example: Wrong payment

canceledByIdint32nullabledeprecated

ID of the employee who cancelled the payment. Use canceledBy.id instead.

Example: 5

canceledBy objectnullable

Employee who cancelled the payment. Breaking change: this used to be the employee's name as a plain string; the name now lives in canceledByName.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

canceledByNamestringnullabledeprecated

Full name of the employee who cancelled the payment. Use canceledBy.fullName instead.

Example: Karimov Jasur

fields object[]nullable

The payment's custom field values — see GET /v1/open-api/payment-field for the field definitions.

Array [

fieldIdint64

Field ID — matches PaymentFieldDTO.id

Example: 42

valuestringnullable

The resolved value as text (option name, date, URL, …)

Example: Naqd

namestringnullable

Field name

Example: To'lov kanali

typeCustomFieldType

Custom field type, shared by every custom-field family (contract, flat, payment and lead task). Serialized by name. Identical value set to ContractFieldType, which remains as the contract-family alias.

Possible values: [TEXT, EXTENDED_TEXT, DATE, SELECT, MULTI_SELECT, RADIO, TOGGLE_SWITCH, URL, TAG, LOCATION, COUNTER, ADDRESS, EMPLOYEE, FILE, NUMBER]

Example: SELECT

requiredbooleannullable

Whether the field is mandatory

Example: false

sortOrderint32nullable

Display position

Example: 1

numberdoublenullable

Numeric value — NUMBER fields only

Example: 1500000

currencyIdint32nullable

Currency of number — NUMBER fields only

Example: 24

valuesstring[]

Ordered values of a multi-value field (MULTI_SELECT, EMPLOYEE, FILE). Empty for single-value types.

Example: ["Naqd","Karta"]

latitudedoublenullable

Latitude — LOCATION fields only

Example: 41.311081

longitudedoublenullable

Longitude — LOCATION fields only

Example: 69.240562

files object[]

Attached files — FILE fields only. Empty for every other type.

Array [

absolutePathstringnullable

Presigned URL to the full-size file

Example: https://minio.uysot.uz/uysot/files/201/avatar.png?X-Amz-Expires=3600

thumbAbsolutePathstringnullable

Presigned URL to the thumbnail rendition

Example: https://minio.uysot.uz/uysot/files/201/avatar_thumb.png?X-Amz-Expires=3600

smallestAbsolutePathstringnullable

Presigned URL to the smallest rendition

Example: https://minio.uysot.uz/uysot/files/201/avatar_small.png?X-Amz-Expires=3600

]

]

PaymentInfoDTO

{
  "id": 98765,
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "number": "PAY-00123",
  "amount": 5000000,
  "base": "CONTRACT",
  "type": "CASH",
  "debit": "INCOME",
  "note": "Advance payment",
  "mortgage": false,
  "customTypeName": "Online payment",
  "timestamp": 1718000000,
  "createdTimestamp": 1718001000,
  "payerId": 3001,
  "payer": "Aliyev Vohid",
  "payerPhones": [
    "+998901234567"
  ],
  "createdBy": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "currency": {
    "id": 1,
    "value": 1,
    "updateTimestamp": 1672531200,
    "basic": true,
    "ccy": "USD"
  },
  "exchange": 12800,
  "basicExchange": 1,
  "branchId": 1,
  "branchName": "Chilonzor",
  "buildingId": 10,
  "buildingName": "A blok",
  "houseId": 2,
  "houseName": "Navruz",
  "contractId": 1409,
  "contractNumber": "SH-2024-001",
  "bookingId": 512,
  "canceledTimestamp": 1718100000,
  "cancelNote": "Wrong payment",
  "canceledBy": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "fields": [
    {
      "fieldId": 42,
      "value": "Naqd",
      "name": "To'lov kanali",
      "type": "SELECT",
      "required": false,
      "sortOrder": 1,
      "number": 1500000,
      "currencyId": 24,
      "values": [
        "Naqd",
        "Karta"
      ],
      "latitude": 41.311081,
      "longitude": 69.240562,
      "files": [
        {
          "absolutePath": "https://minio.uysot.uz/uysot/files/201/avatar.png?X-Amz-Expires=3600",
          "thumbAbsolutePath": "https://minio.uysot.uz/uysot/files/201/avatar_thumb.png?X-Amz-Expires=3600",
          "smallestAbsolutePath": "https://minio.uysot.uz/uysot/files/201/avatar_small.png?X-Amz-Expires=3600"
        }
      ]
    }
  ]
}