Информация о счете

Метод позволяет получить о конкретных счетах по их идентификаторам с помощью отправки POST запроса.

Что делает метод

Возвращает полную информацию по указанным счетам
Максимальное количество идентификаторов в одном запросе — 100

Endpoint

POST https://api.cryptocloud.plus/v2/invoice/merchant/info

Headers

Name

Type

Example

Description

Authorization*

string

Token eyJ0eXAiOiJK<...>4npi1ksS8tSY

API-ключ проекта

Request Body

Основные параметры

Name

Type

Example

Description

uuids*

array

INV-89UX09KA

Список идентификаторов счетов (INV-XXXXXXXX или XXXXXXXX)

Пример запроса

Эти примеры показывают, как можно выполнить запрос для получения информации о счетах по их INV номеру. Обратите внимание, что в 1 запросе должно быть не более 100 идентификаторов.

curl -X POST https://api.cryptocloud.plus/v2/invoice/merchant/info \
     -H "Authorization: Token <API KEY>" \
     -H "Content-Type: application/json" \
     -d '{"uuids":["INV-XXXXXXXX","INV-YYYYYYYY"]}'

import requests

url = "https://api.cryptocloud.plus/v2/invoice/merchant/info"
headers = {
    "Authorization": "Token <API KEY>"
}
data = {
    "uuids": ["INV-XXXXXXXX", "INV-YYYYYYYY"]
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Fail:", response.status_code, response.text)

fetch('https://api.cryptocloud.plus/v2/invoice/merchant/info', {
    method: 'POST',
    headers: {
        'Authorization': 'Token <API KEY>',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        uuids: ['INV-XXXXXXXX', 'INV-YYYYYYYY']
    })
})
.then(response => {
    if (response.ok) {
        return response.json();
    } else {
        throw new Error('Fail: ' + response.status + ' ' + response.statusText);
    }
})
.then(data => console.log('Success:', data))
.catch(error => console.error('Error:', error));

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://api.cryptocloud.plus/v2/invoice/merchant/info");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(array(
    "uuids" => array("INV-XXXXXXXX", "INV-YYYYYYYY")
)));

$headers = array(
    "Authorization: Token <API KEY>",
    "Content-Type: application/json"
);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if ($statusCode == 200) {
        echo "Success: " . $response;
    } else {
        echo "Fail: " . $statusCode . " " . $response;
    }
}

curl_close($ch);
?>

Пример ответа

На успешный запрос приходит ответ со статусом success и объектом result.

{
    "status": "success",
    "result": [
        {
            "uuid": "INV-DO8ETFVT",
            "created": "2026-01-01 09:03:58.958133",
            "address": "LiWRq0uckKZ8qj5dhvgBdWzEtAxr8KbpBW",
            "currency": {
                "id": 2,
                "code": "LTC",
                "fullcode": "LTC",
                "network": {
                    "code": "litecoin",
                    "id": 2,
                    "icon": "https://cdn.cryptocloud.plus/img/network/LTC.svg",
                    "fullname": "Litecoin"
                },
                "name": "Litecoin",
                "is_email_required": false,
                "stablecoin": false,
                "icon_base": "https://cdn.cryptocloud.plus/img/currency/LTC.svg",
                "icon_network": "https://cdn.cryptocloud.plus/img/currency/LTC.svg",
                "icon_qr": "https://cdn.cryptocloud.plus/img/stroke/LTC_STROKE.svg",
                "order": 8
            },
            "date_finished": "2026-01-01 19:03:58.958133",
            "expiry_date": "2026-01-02 09:03:57.493361",
            "side_commission": "client",
            "side_commission_cc": "merchant",
            "type_payments": "crypto",
            "status": "overpaid",
            "invoice_status": "success",
            "is_email_required": false,
            "project": {
                "id": 1,
                "name": "Test",
                "fail": "https://test.com/failed-payment",
                "success": "https://test.com/successful-payment",
                "logo": ""
            },
            "tx_list": [
                ""
            ],
            "test_mode": false,
            "type": "up",
            "user_email": "",
            "pay_url": "None",
            "phone": "",
            "order_id": "None",
            "amount_in_crypto": null,
            "amount_in_fiat": 0.1,
            "amount": 0.01,
            "amount_usd": 0.1,
            "amount_to_pay": 0.01,
            "amount_to_pay_usd": 0.69,
            "amount_paid": 0.01,
            "amount_paid_usd": 0.69,
            "fee": 0.0,
            "fee_usd": 0.0,
            "service_fee": 0.00019,
            "service_fee_usd": 0.01,
            "received": 0.00981,
            "received_usd": 0.68,
            "to_surcharge": 0.0,
            "to_surcharge_usd": 0.0
        }
    ]
}

Параметры ответа

Объект result содержит:

Name

Type

Example

Description

uuid

string

INV-89UX09KA

Уникальный идентификатор счета с префиксом INV

created

string

2026-01-01 12:00:00.000000

Время создания счета по UTC +0 в формате YYYY-MM-DD HH:MI:SS.FFFFFF

address

string

LiWRq0uck<...>Axr8KbpBW

Адрес для оплаты

expiry_date

string

2026-01-02 12:00:00.000000

Дата истечения срока действия счета по UTC +0 в формате YYYY-MM-DD HH:MI:SS.FFFFFF

После истечения срока действия счет переведется в статус canceled, если оплата не поступила

side_commission

string

client

Сторона оплаты трансферной комиссии

side_commission_cc

string

client

Сторона оплаты комиссии сервиса

amount

float

0.033366

Сумма счета в выбранной криптовалюте

amount_usd

float

100.0

Сумма счета в USD

amount_in_fiat

float

100.0

Сумма счета в валюте создания (зависит от параметра currency)

fee

float

4.500000159168849e-06

Трансферная комиссия счета

fee_usd

float

0.01

Трансферная комиссия счета в USD

service_fee

float

0.000634

Комиссия сервиса

service_fee_usd

float

1.9

Комиссия сервиса в USD

fiat_currency

string

USD

Код фиатной валюты, в которой был создан счет

status

string

created

Статус счета

При отправке запроса на создание счета всегда равен created.

Так же есть статусы paid (оплачен), partial (оплачен частично), overpaid (переплачен) и canceled (отменен)

is_email_required

bool

false

Параметр для обязательного заполнения почты в счете

link

string

pay.cryptocloud.plus/89UX09KA

Ссылка на страницу счета

currency

dict

"currency": {

"id": 3,

"code": "ETH",

"fullcode": "ETH",

"network": {

"code": "ERC20",

"id": 3,

"icon": "https://cdn.cryptocloud.plus/img/network/ERC.svg",

"fullname": "Ethereum"

"name": "Ethereum",

"is_email_required": false,

"stablecoin": false,

"icon_base": "https://cdn.cryptocloud.plus/img/currency/ETH.svg",

"icon_network": "https://cdn.cryptocloud.plus/img/currency/ETH.svg",

"icon_qr": "https://cdn.cryptocloud.plus/img/stroke/ETH_STROKE.svg",

"order": 9

}

Объект выбранной криптовалюты в счете.

Так же содержит объект network — информация о выбранной сети валюты

project

dict

"project": {

"id": 0,

"name": "MyShop",

"fail": "https://test.com/failed-payment",

"success": "https://test.com/successful-payment",

"logo": "https://static.cryptocloud.plus/logo/logo.jpg"

}

Объект с информацией о проекте

test_mode

bool

false

Признак тестового счета

received

float

0.00206

Зачисленная на баланс сумма в криптовалюте

received_usd

float

0.26

Зачисленная на баланс сумма в USD

to_surcharge

float

0.001172

Сумма к доплате в криптовалюте

to_surcharge_usd

float

0.08

Сумма к доплате в USD

Мы регулярно работаем над улучшением документации сервиса для разработчиков. Пожалуйста, оцените качество и полезность материалов по ссылке.

PreviousСписок счетов NextБаланс

Last updated 7 hours ago

Was this helpful?

hashtagЧто делает метод

hashtagEndpoint

hashtagHeaders

hashtagRequest Body

hashtagПример запроса

hashtagПример ответа

hashtagПараметры ответа

Что делает метод

Endpoint

Headers

Request Body

Пример запроса

Пример ответа

Параметры ответа