Создание счета

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

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

Создает уникальный invoice
Возвращает ссылку или реквизиты для оплаты
Позволяет передать дополнительные данные

Endpoint

POST https://api.cryptocloud.plus/v2/invoice/create

Headers

Name

Type

Example

Description

Authorization*

string

Token eyJ0eXAiOiJK<...>4npi1ksS8tSY

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

Request Body

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

Name

Type

Example

Description

shop_id*

string

NGpD44<...>KXRdQ

Уникальный идентификатор магазина из личного кабинета

amount*

float

100

Сумма платежа в USD

currency*

string

USD

Доступные валюты для конвертации:

USD, UZS, KGS, KZT, AMD, AZN, BYN, AUD, 'TRY', AED, CAD, CNY, HKD, IDR, INR, JPY, PHP, SGD, THB, VND, MYR, RUB, UAH, EUR, GBP.

По умолчанию устанавливается валюта USD

order_id

string

ORDER_93223

Произвольный номер счета во внешней системе

string

[email protected]

Email адрес плательщика

Необязательные параметры

add_fields — это объект для передачи дополнительных данных

Name

Type

Example

Description

add_fields

dict

{time_to_pay: {

"hours": 24, "minutes": 0

}

Дополнительные параметры

Необязательные параметры должны передаваться внутри объекта add_fields

Name

Type

Example

Description

time_to_pay

dict

{ "hours": 24, "minutes": 0 }

Время жизни счета

available_currencies

list[string]

[ "USDT_TRC20", "ETH", "BTC" ]

Доступные валюты для оплаты:

BTC, LTC, TRX, SOL, TON, BNB, ETH, ETH_ARB, ETH_BASE, ETH_OPT, USDT_ARB, USDT_BSC, USDT_ERC20, USDT_OPT, USDT_SOL, USDT_TON, USDT_TRC20, USDC_ARB, USDC_BASE, USDC_BSC, USDC_ERC20, USDC_OPT, USDC_SOL, DAI_ARB, DAI_BASE, DAI_BSC, DAI_ERC20, DAI_OPT, USDD_TRC20, PYUSD_ERC20, PYUSD_SOL, XAUT_ERC20, XAUT_TON, ARB_ARB, OP_OPT, PEPE_BSC, PEPE_ERC20, SHIB_BSC, SHIB_ERC20, TRUMP_SOL

cryptocurrency

string

ETH

Выбор валюты оплаты за пользователя.

При указании валюты на странице оплаты будут отображаться реквизиты без выбора валюты.

Так же адрес и сумма будут выданы в ответе на запрос.

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

Эти примеры показывают, как можно отправить запрос на создание счета. Обратите внимание, что необходимо предоставить ваш API ключ в заголовке Authorization для успешной авторизации запроса.

curl -X POST \
     -H "Authorization: Token <API KEY>" \
     -H "Content-Type: application/json" \
     -d '{"amount": 100, "shop_id": "xBAivfPIbskwuEWj", "currency": "USD"}' \
     "https://api.cryptocloud.plus/v2/invoice/create"

import requests
import json

url = "https://api.cryptocloud.plus/v2/invoice/create"
headers = {
    "Authorization": "Token <API KEY>",
    "Content-Type": "application/json"
}

data = {
    "amount": 100,
    "shop_id": "xBAivfPIbskwuEWj",
    "currency": "USD"
}

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.js:

const url = 'https://api.cryptocloud.plus/v2/invoice/create';
const headers = new Headers({
    'Authorization': 'Token <API KEY>',
    'Content-Type': 'application/json'
});
const data = {
    amount: 100,
    shop_id: 'xBAivfPIbskwuEWj',
    currency: 'USD'
};

fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify(data)
})
.then(response => {
    if (response.ok) {
        return response.json();
    } else {
        return Promise.reject('Creation Error');
    }
})
.then(data => {
    console.log('Success:', data);
})
.catch(error => {
    console.error('Fail:', error);
});

Ajax.js:

$.ajax({
    url: 'https://api.cryptocloud.plus/v2/invoice/create',
    method: 'POST',
    headers: {
        'Authorization': 'Token <API KEY>',
        'Content-Type': 'application/json'
    },
    data: JSON.stringify({
        amount: 100,
        shop_id: 'xBAivfPIbskwuEWj',
        currency: 'USD'
    }),
    success: function(data) {
        console.log('Success:', data);
    },
    error: function(error) {
        console.error('Fail:', error);
    }
});

Axios.js:

const axios = require('axios');

const url = 'https://api.cryptocloud.plus/v2/invoice/create';
const headers = {
    'Authorization': 'Token <API KEY>',
    'Content-Type': 'application/json'
};
const data = {
    amount: 100,
    shop_id: 'xBAivfPIbskwuEWj',
    currency: 'USD'
};

axios.post(url, data, { headers })
    .then(response => {
        console.log('Success:', response.data);
    })
    .catch(error => {
        console.error('Fail:', error);
    });

cURL:

<?php
$url = "https://api.cryptocloud.plus/v2/invoice/create";
$headers = array(
    "Authorization: Token <API KEY>",
    "Content-Type: application/json"
);

$data = array(
    "amount" => 100,
    "shop_id" => "xBAivfPIbskwuEWj",
    "currency" => "USD"
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if($http_code == 200){
    echo "Success: " . $response;
} else {
    echo "Fail: " . $http_code . " " . $response;
}

curl_close($ch);
?>

File_get_contents:

<?php
$url = "https://api.cryptocloud.plus/v2/invoice/create";
$headers = array(
    "http" => array(
        "header" => "Authorization: Token <API KEY>\r\n" .
                    "Content-Type: application/json\r\n",
        "method" => "POST",
        "content" => json_encode(array(
            "amount" => 100,
            "shop_id" => "xBAivfPIbskwuEWj",
            "currency" => "USD"
        )),
    ),
);

$context  = stream_context_create($headers);
$response = file_get_contents($url, false, $context);
$http_code = $http_response_header[0];

if(strpos($http_code, "200")){
    echo "Success: " . $response;
} else {
    echo "Fail: " . $http_code . " " . $response;
}
?>

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

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

{
    "status": "success",
    "result": {
        "uuid": "INV-89UX09KA",
        "created": "2026-01-27 09:03:58.958133",
        "address": "0xb07427fc721C23674c48233ffE93D3846ee58B63",
        "expiry_date": "2026-01-28 09:03:57.493361",
        "side_commission": "client",
        "side_commission_service": "merchant",
        "type_payments": "crypto",
        "amount": 0.034187,
        "amount_usd": 100.0,
        "amount_in_fiat": 100.0,
        "fee": 1.499999996212864e-06,
        "fee_usd": 0.0,
        "service_fee": 0.00065,
        "service_fee_usd": 1.9,
        "fiat_currency": "USD",
        "status": "created",
        "is_email_required": false,
        "link": "https://pay.cryptocloud.plus/89UX09KA",
        "invoice_id": null,
        "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
        },
        "project": {
            "id": 1,
            "name": "Test",
            "fail": "https://test.com/failed-payment",
            "success": "https://test.com/successful-payment",
            "logo": "https://static.cryptocloud.plus/logo/L52hWwjt98uYtUF91765782359.174416.jpg"
        },
        "test_mode": false
    }
}

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

Объект 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

0xb07427<...>E93D3846ee58B63

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

Будет предзаполнен только в случае выбора криптовалюты для оплаты

Для выбора валюты за клиента необходимо в add_fields.cryptocurrency указать доступную в проекте валюту

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

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

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

PreviousАвторизация запросов NextОтмена счета

Last updated 7 hours ago

Was this helpful?

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

hashtagEndpoint

hashtagHeaders

hashtagRequest Body

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

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

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

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

Endpoint

Headers

Request Body

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

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

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