Создать инвойс

Этот эндпоинт используется для создания нового инвойса (счета на оплату) в рамках выбранного юнита. Инвойс — это разовый платежный документ, который позволяет клиенту оплатить заданную сумму в определённой валюте и сети. После успешной оплаты средства автоматически поступают на баланс юнита.

POST/v1/invoices

Headers

Example of x-api-key

74364121-2fb8-4e06-b093-7b1f83f0d5a8

Please note: the x-api-key is unique and provided to each client individually by Monocrypt.

Body Parameters 📝

Field	Type	Required	Description
title	string	✅	Название инвойса.
description	string	❌	Описание инвойса, можно указать за что производится оплата.
amount	string	✅	Сумма, которую клиент должен оплатить.
unitId	number	✅	Идентификатор юнита, для которого создаётся инвойс.
currency	string	✅	Валюта инвойса (например, USDT, BTC, ETH).
network	string	✅	Сеть, в которой должен быть выполнен платеж (TRC20, ERC20, Bitcoin и т.д.).
customerEmail	string	❌	Email клиента для уведомления или связи.

---

Пример тела запроса 💡

{
  "title": "Invoice one",
  "description": "Invoice description",
  "amount": "100",
  "expirationAt": "2024-12-31T23:59:59Z",
  "unitId": 1,
  "currency": "USDT",
  "network": "TRC20",
  "customerEmail": "[email protected]"
}

Response

201 Created

{
    "amount": "100",
    "currency": "USDT",
    "network": "TRC20",
    "unitId": 6,
    "customerEmail": "[email protected]",
    "description": "payment",
    "title": "test",
    "status": "awaiting_payment",
    "manager": {
        "isAPI": true,
    },
    "id": 642,
    "createdAt": "2025-11-03T15:04:54.782Z",
    "updatedAt": "2025-11-03T15:04:54.782Z",
    "uuid": "f53fbf8d-b02e-4cd9-a641-5e0307798561",
    "total_available_amount": "0",
    "total_received_amount": "0",
    "total_fee_paid": "0",
    "wallets": [
        {
            "currency": "USDT",
            "network": "TRC20",
            "subId": null,
            "name": null,
            "walletAddress": "TRSJKhJTERAmDQAkMa1Pe5zuh8GtHzEyTV",
            "invoiceId": 642,
            "clientId": null,
            "unitId": null,
            "id": 2673,
            "createdAt": "2025-11-03T15:04:54.782Z",
            "updatedAt": "2025-11-03T15:04:54.782Z",
            "balance": "0",
            "transit_balance": "0",
            "service_fee_balance": "0",
            "riskScore": 0,
            "total_deposits": "0"
        }
    ]
}

401 Unauthorized

500 Internal Server Error

Где взять адрес для оплаты 💰

👉 Адрес для перевода средств находится в объекте wallets, который возвращается в ответе.

"wallets": [
  {
    "currency": "USDT",
    "network": "TRC20",
    "walletAddress": "TRSJKhJTERAmDQAkMa1Pe5zuh8GtHzEyTV"
  }
]

💡 Этот адрес (walletAddress) — уникальный для данного инвойса, и все переводы на него будут учтены только в рамках этого инвойса.

После поступления полной суммы (amount) статус инвойса изменится на completed.