> ## Documentation Index > Fetch the complete documentation index at: https://wallet-docs.iexexchanger.com/llms.txt > Use this file to discover all available pages before exploring further. # List payments (child deposits) of a static address > Каждый платёж — обычный объект депозита (как GET /v1/public/deposits/{uuid}); page/perPage, status, cursor. ## OpenAPI ````yaml /openapi-public.json get /v1/public/static-addresses/{uuid}/payments openapi: 3.0.0 info: title: Wallet Platform — Public API description: >- API для интеграции CMS обменника: создание депозитов и выплат, отслеживание статусов, справочники активов и сетей. ## Аутентификация Каждый запрос подписывается HMAC-SHA256. Обязательные заголовки: - `X-Api-Id` — публичный идентификатор ключа (выдаётся в админке). - `X-Api-Key` — публичный ключ. - `X-Timestamp` — Unix-секунды; сервер принимает ±300 сек от своего времени. - `X-Signature` — `HMAC_SHA256_Hex( X-Timestamp + "." + raw_body, api_secret )`. Для GET тело пустое. - `X-Idempotency-Key` — опционально (UUID). Гарантирует, что повторный POST не создаст дубликат. Дополнительно: IP-вызывающего должен быть в whitelist сайта (настраивается в админке). Секрет (`api_secret`) показывается один раз при создании ключа и хранится только у вас. ## Формат ответа Все ответы — единый envelope: `{ "ok": true, "data": ... }` при успехе либо `{ "ok": false, "error": { "code": "...", "message": "..." } }` при ошибке. ## Идемпотентность Создание депозита/выплаты идемпотентно по вашему `order_id` (уникален в рамках сайта и актива) и/или по `X-Idempotency-Key`. Повторный вызов с тем же ключом вернёт исходный объект, а не создаст новый. ## Webhooks (исходящие) При смене статуса платформа шлёт POST на ваш `callback_url`. Заголовки: `X-Event-Type`, `X-Event-Id` (uuid, идемпотентность на вашей стороне), `X-Timestamp`, `X-Signature` = `HMAC_SHA256_Hex(raw_body, callback_secret)`. Проверяйте подпись перед обработкой. События: `deposit.tx_detected`, `deposit.finalized`, `deposit.failed`, `deposit.refunded`, `payout.broadcasted`, `payout.confirmed`, `payout.failed`. Доставка считается успешной при HTTP 2xx за 10 секунд. Ретраи: 30s, 2m, 10m, 1h, 6h, 24h (до 8 попыток). version: '1' contact: {} servers: [] security: - X-Api-Id: [] X-Api-Key: [] hmac: [] X-Timestamp: [] tags: [] paths: /v1/public/static-addresses/{uuid}/payments: get: tags: - public · static addresses summary: List payments (child deposits) of a static address description: >- Каждый платёж — обычный объект депозита (как GET /v1/public/deposits/{uuid}); page/perPage, status, cursor. operationId: StaticAddressesPublicController_payments parameters: - name: uuid required: true in: path schema: type: string format: uuid - name: page required: false in: query description: Номер страницы (с 1). schema: minimum: 1 default: 1 type: number - name: perPage required: false in: query description: Размер страницы (макс 100). schema: minimum: 1 maximum: 100 default: 20 type: number - name: status required: false in: query description: >- Фильтр по статусу (одно значение или несколько через запятую). Напр. "paid" или "paid,paid_over". schema: type: string - name: cursor required: false in: query description: >- 1.4.0: курсор из `meta.nextCursor` предыдущего ответа. При наличии `page` игнорируется — выдача идёт keyset-методом (стабильна при появлении новых записей). Первую страницу по курсору запрашивайте без параметра — `meta.nextCursor` появится в ответе. schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PublicDepositListResponseDto' security: - hmac: [] components: schemas: PublicDepositListResponseDto: type: object properties: items: type: array items: $ref: '#/components/schemas/PublicDepositResponseDto' meta: $ref: '#/components/schemas/PublicListMetaDto' required: - items - meta PublicDepositResponseDto: type: object properties: uuid: type: string format: uuid description: Публичный идентификатор депозита (используйте в GET /{uuid}). orderId: type: string example: order_42_abc description: Ваш order_id (label), переданный при создании. address: type: string example: TXYZ...abcd description: >- Адрес для оплаты. Для memo-based сетей (TON) — общий приёмный адрес + memo. memo: type: string nullable: true example: WP-1A2B3C4D description: Memo/comment (ОБЯЗАТЕЛЕН для memo-based сетей, иначе null). assetCode: type: string example: USDT_TRC20 expectedAmount: type: string example: '100.50' description: Ожидаемая сумма (string). 0 = принимаем любую сумму. status: type: string enum: - check - process - confirm_check - paid - paid_over - wrong_amount - expired - cancel - fail - system_fail - refund_process - refund_paid - refund_fail example: check description: >- Бизнес-статус депозита (полный набор). Поток: check → process → confirm_check → paid | paid_over | wrong_amount. Терминальные/прочие: expired (окно мониторинга истекло), cancel, fail, system_fail, refund_process → refund_paid | refund_fail. expiresAt: type: string format: date-time description: До какого момента сеть мониторится на оплату. explorerAddressUrl: type: string nullable: true example: https://tronscan.org/#/address/TXYZ description: Ссылка на адрес в explorer. transaction: nullable: true description: >- On-chain данные incoming-транзакции. null пока депозит не получил ни одной tx. type: object allOf: - $ref: '#/components/schemas/PublicDepositTransactionDto' network: type: string example: TRON description: '1.4.0: сеть актива.' isFinal: type: boolean example: false description: '1.4.0: терминальный ли статус — можно прекращать поллинг.' amountUsd: type: string nullable: true example: '100.50' description: '1.4.0: оценка суммы в USD (полученной, иначе ожидаемой).' rateUsd: type: string nullable: true example: '1.00' description: '1.4.0: курс актива к USD на момент ответа.' commission: type: string nullable: true example: '0.50' description: >- 1.4.0: комиссия обменника (если учёт включён и депозит финализирован). createdAt: type: string format: date-time description: '1.4.0: время создания депозита.' updatedAt: type: string format: date-time description: '1.4.0: время последнего изменения статуса.' accuracyPaymentPercent: type: string nullable: true example: '1.00' description: >- 1.4.0: допуск недоплаты (%) для этого депозита; null — по настройкам сайта/платформы. allowTopUp: type: boolean example: false description: '1.4.0: режим доплаты включён.' topUp: nullable: true description: '1.4.0: состояние режима доплаты (null, если выключен).' type: object allOf: - $ref: '#/components/schemas/PublicDepositTopUpDto' staticAddress: nullable: true description: >- 1.4.0: платёж на статический адрес — ссылка на родительский адрес (null для обычных депозитов). type: object allOf: - $ref: '#/components/schemas/PublicDepositStaticAddressDto' refund: nullable: true description: >- 1.4.0: последняя выплата-возврат депозита (null — возврат не запрашивался). type: object allOf: - $ref: '#/components/schemas/PublicDepositRefundDto' required: - uuid - orderId - address - memo - assetCode - expectedAmount - status - expiresAt - explorerAddressUrl - transaction - network - isFinal - amountUsd - rateUsd - commission - createdAt - updatedAt - accuracyPaymentPercent - allowTopUp - topUp - staticAddress - refund PublicListMetaDto: type: object properties: page: type: number example: 1 perPage: type: number example: 20 total: type: number example: 137 description: Всего записей (для всех страниц). nextCursor: type: string nullable: true example: MTIzNDU description: >- 1.4.0: курсор следующей страницы (keyset-пагинация). Передайте его в `?cursor=` — получите следующую порцию без сдвига при появлении новых записей. null — страниц больше нет. Присутствует только если запрос шёл по курсору или это первая страница. required: - page - perPage - total PublicDepositTransactionDto: type: object properties: networkStatus: type: string enum: - pending - mempool - confirmed - fail example: confirmed description: >- Статус транзакции в сети: pending (создана) → mempool (в мемпуле) → confirmed (подтверждена) | fail. receivedAmount: type: string nullable: true example: '100.500000' description: Фактически полученная сумма (string). null пока tx не подтверждена. txhash: type: string nullable: true example: a1b2c3...e9f0 description: Хеш incoming blockchain-транзакции. confirmations: type: number nullable: true example: 12 description: Текущее число подтверждений сети. requiredConfirmations: type: number nullable: true example: 19 description: >- Сколько подтверждений требуется для финализации (asset.minConfirmations). blockNumber: type: string nullable: true example: '65123456' description: >- Номер блока (string, т.к. может превышать Number.MAX_SAFE_INTEGER). null если ещё в mempool. explorerTxUrl: type: string nullable: true example: https://tronscan.org/#/transaction/a1b2c3 description: Ссылка на транзакцию в explorer. detectedAt: type: string format: date-time nullable: true description: Когда tx впервые замечена в сети. paidAt: type: string format: date-time nullable: true description: >- Когда депозит финализирован (paid / paid_over / wrong_amount). null пока не финализирован. fromAddress: type: string nullable: true description: '1.4.0: адрес отправителя входящей tx (source of funds).' required: - networkStatus - receivedAmount - txhash - confirmations - requiredConfirmations - blockNumber - explorerTxUrl - detectedAt - paidAt - fromAddress PublicDepositTopUpDto: type: object properties: enabled: type: boolean example: true waiting: type: boolean example: true description: >- Окно доплаты открыто — ждём ещё средств (status wrong_amount не финален). remainingAmount: type: string nullable: true example: '39.5' description: Сколько ещё нужно прислать (expected − received). closedAt: type: string format: date-time nullable: true description: Окно закрыто (истёк срок) — итог wrong_amount. txs: type: array items: $ref: '#/components/schemas/PublicDepositTopUpTxDto' required: - enabled - waiting - remainingAmount - closedAt - txs PublicDepositStaticAddressDto: type: object properties: uuid: type: string format: uuid orderId: type: string example: customer-42 description: orderId статического адреса. label: type: string nullable: true example: Ivan required: - uuid - orderId - label PublicDepositRefundDto: type: object properties: payoutUuid: type: string format: uuid description: UUID выплаты-возврата (GET /v1/public/payouts/{uuid}). status: type: string example: pending_approval description: >- Статус выплаты-возврата (new … confirmed | failed | rejected | cancelled). amount: type: string example: '95.5' destinationAddress: type: string example: TXYZ… createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - payoutUuid - status - amount - destinationAddress - createdAt - updatedAt PublicDepositTopUpTxDto: type: object properties: txhash: type: string amount: type: string example: '10.5' fromAddress: type: string confirmations: type: number example: 3 requiredConfirmations: type: number example: 19 confirmed: type: boolean example: false detectedAt: type: string format: date-time confirmedAt: type: string format: date-time nullable: true required: - txhash - amount - fromAddress - confirmations - requiredConfirmations - confirmed - detectedAt - confirmedAt securitySchemes: X-Api-Id: type: apiKey in: header name: X-Api-Id description: Публичный идентификатор API-ключа X-Api-Key: type: apiKey in: header name: X-Api-Key description: Публичный API-ключ hmac: type: apiKey in: header name: X-Signature description: HMAC-SHA256-Hex(timestamp + "." + raw_body, api_secret) X-Timestamp: type: apiKey in: header name: X-Timestamp description: Unix-секунды, ±300с ````