# Статические кошельки ### Что такое статический кошелек Статический кошелек позволяет покупателям осуществлять платежи на один и тот же адрес без необходимости создания нового счета и перехода на страницу оплаты каждый раз. Это удобный способ, который дает возможность принимать средства в определенной криптовалюте с автоматическим зачислением их на баланс продавца после вычета всех комиссий. Решение отлично подходит для проектов, в которых предусмотрено пополнение баланса аккаунта пользователя, для приема пожертвований, проектов в сфере iGaming и др. ### Как работает статический кошелек 1. Пользователь переходит к пополнению баланса на сайте мерчанта. 2. Пользователь создает свои кошельки под разные криптовалюты и пополняет любой из них. Важно - 1 кошелек = 1 валюта 3. Переводит сумму по адресу кошелька или с помощью QR-кода. 4. После пополнения любая сумма в криптовалюте, поступившая на кошелек, зачисляется как успешное пополнение баланса пользователя. 5. Мерчант получает уведомление об успешном платеже. ### Преимущества статического кошелька Удобство для покупателей. Оплата в определенной криптовалюте осуществляется на один постоянный адрес без перехода на платежную страницу. Автоматизация зачисления. Средства автоматически поступают на баланс мерчанта с отправкой postback-уведомления. Прозрачность комиссий. Все комиссии (сервисная, трансферная и при необходимости AML) вычитаются из суммы транзакции автоматически. *** ### Создание статического кошелька #### Что делает метод * Создает статический кошелек с указанными параметрами #### Endpoint `POST` `https://api.cryptocloud.plus/v2/invoice/static/create` #### Headers | Name | Type | Example | Description | | ----------------------------------------------- | ------ | ----------------------------------- | ---------------- | | Authorization\* | string | Token eyJ0eXAiOiJK<...>4npi1ksS8tSY | API-ключ проекта | #### Request Body Основные параметры | Name | Type | Example | Description | | ------------------------------------------ | ------ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | shop\_id\* | string | NGpD44<...>KXRdQ | Уникальный идентификатор магазина из настроек проекта | | currency | string | ETH |

Код валют:

BTC, LTC, TRX, SOL, BNB, ETH, ETH\_ARB, ETH\_BASE, ETH\_OPT, USDT\_ARB, USDT\_BSC, USDT\_ERC20, USDT\_OPT, USDT\_SOL, 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, ARB\_ARB, OP\_OPT, PEPE\_BSC, PEPE\_ERC20, SHIB\_BSC, SHIB\_ERC20, TRUMP\_SOL

Статические кошельки не поддерживаются в сети TON

| | identify\* | string | ID\_8843 |

Идентификатор клиента.

При отправке POSTBACK по поступлению он будет записан в order\_id

| #### Примеры запроса Эти примеры показывают, как можно отправить запрос на создание статического кошелька. {% tabs %} {% tab title="cURL" %} ```bash curl -X POST https://api.cryptocloud.plus/v2/invoice/static/create \ -H 'Authorization: Token ' \ -H 'Content-Type: application/json' \ -d '{"shop_id": "", "currency": "BTC", "identify": "F4jSjfpwf4t"}' ``` {% endtab %} {% tab title="Python" %} ```python import requests url = "https://api.cryptocloud.plus/v2/invoice/static/create" headers = { 'Authorization': "Token " } body = { "shop_id": "", "currency": "BTC", "identify": "F4jSjfpwf4t", } response = requests.post(url, headers=headers, json=body) if response.status_code == 200: print("Success:", response.json()) else: print("Fail:", response.status_code, response.text) ``` {% endtab %} {% tab title="JavaScript" %} ```javascript const url = "https://api.cryptocloud.plus/v2/invoice/static/create"; const headers = { 'Authorization': 'Token ', 'Content-Type': 'application/json' }; const body = { "shop_id": "", "currency": "BTC", "identify": "F4jSjfpwf4t" }; fetch(url, { method: 'POST', headers: headers, body: JSON.stringify(body) }) .then(response => { if (response.ok) { return response.json(); } else { throw new Error(`Failed to fetch: ${response.statusText}`); } }) .then(data => console.log("Success:", data)) .catch(error => console.log("Fail:", error)); ``` {% endtab %} {% tab title="PHP" %} ```php ', 'Content-Type: application/json' ]; $body = [ "shop_id" => "", "currency" => "BTC", "identify" => "F4jSjfpwf4t" ]; $ch = curl_init($url); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body)); $response = curl_exec($ch); if (curl_getinfo($ch, CURLINFO_HTTP_CODE) == 200) { echo "Success: " . $response; } else { echo "Fail: " . curl_getinfo($ch, CURLINFO_HTTP_CODE) . " " . $response; } curl_close($ch); ?> ``` {% endtab %} {% endtabs %} #### Примеры ответа На успешный запрос приходит ответ со статусом success и объектом result. {% tabs %} {% tab title="200: OK – Static wallet created" %} ```json { "status": "success", "result": { "currency": { "id": 4, "code": "USDT_TRC20", "short_code": "USDT", "name": "Tether", "is_email_required": false, "stablecoin": true, "icon_base": "https://cdn.cryptocloud.plus/img/currency/USDT.svg", "icon_network": "https://cdn.cryptocloud.plus/img/currency_network/USDT_TRC.svg", "icon_qr": "https://cdn.cryptocloud.plus/img/stroke/USDT_STROKE.svg", "order": 1, "obj_network": { "code": "TRC20", "id": 4, "icon": "https://cdn.cryptocloud.plus/img/network/TRC20.svg", "fullname": "Tron" }, "enable": true }, "address": "TKDyKp8F874WiPd1q2jrxgg3HE4AHPDms6", "uuid": "KW2WWTTNNBHM17MGFUJPSDOFQVS4ER0X", "active": true, "created": "2026-01-01 09:13:57.599180", "identify": "test_static_wallet" } } ``` {% endtab %} {% endtabs %} #### Параметры ответа Объект result содержит: | status | string | success | Статус выполнения запроса | | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | | currency | dict |

"currency": {

"id": 4,

"code": "USDT\_TRC20",

"short\_code": "USDT",

"name": "Tether", "is\_email\_required": false,

"stablecoin": true,

"icon\_base": "", "icon\_network": "",

"icon\_qr": "",

"order": 1, "obj\_network": {

"code": "TRC20",

"id": 4,

"icon": "", "fullname": "Tron"

}

| Информация по валюте | | enable | boolean | true | Статус кошелька | | address | string | “TT2T17<...>79zdkEWkU9N” | Сгенерированный адрес статического кошелька | | uuid | string | “KW2W<...>UJPSDNFQVS4ER0X” | Идентификатор статического кошелька | | created | string | "2026-01-01 09:13:57.599180" | Дата создания | | identify | string | test\_static\_wallet | Наименование статического кошелька | *** ### Получение списка статических кошельков #### Что делает метод * Возвращает список созданных статических кошельков #### Endpoint `POST` `https://api.cryptocloud.plus/v2/invoice/static/list` #### Headers | Name | Type | Example | Description | | ----------------------------------------------- | ------ | ----------------------------------- | ---------------- | | Authorization\* | string | Token eyJ0eXAiOiJK<...>4npi1ksS8tSY | API-ключ проекта | #### Request Body Основные параметры | Name | Type | Example | Description | | -------- | ------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | shop\_id | string | NGpD44<...>KXRdQ | Уникальный идентификатор магазина из настроек проекта | | start | string | 01.01.2026 | Дата в формате "dd.mm.yyyy" | | end | string | 31.01.2026 |

Дата в формате "dd.mm.yyyy".

Должна быть больше или равна start

| | offset | int | 0 |

Это номер начальной записи, с которой начнется вывод данных.

Например, если установить offset=10, то данные начнут показываться с 11-й записи

| | limit | int | 10 |

Это номер последней записи, которую вы хотите получить.

Например, если limit=20, то вы получите записи до 20-й включительно, начиная с той, что указана в offset

| #### Примеры запроса Эти примеры показывают, как можно отправить запрос на получение списка статических кошельков. {% tabs %} {% tab title="cURL" %} ```bash curl --location 'https://api.cryptocloud.plus/v2/invoice/static/list' \ --header 'Content-Type: application/json' \ --header 'Authorization: Token ' \ --data '{ "shop_id": "", "start": "04.01.26", "end": "31.01.26", "limit": 100, "offset": 0 }' ``` {% endtab %} {% tab title="Python" %} ```python import requests url = "https://api.cryptocloud.plus/v2/invoice/static/list" headers = { "Content-Type": "application/json", "Authorization": "Token " } data = { "shop_id": "", "start": "04.01.26", "end": "31.01.26", "limit": 100, "offset": 0 } response = requests.post(url, json=data, headers=headers) print(response.json()) ``` {% endtab %} {% tab title="JavaScript" %} ```javascript import fetch from 'node-fetch'; const url = 'https://api.cryptocloud.plus/v2/invoice/static/list'; const headers = { 'Content-Type': 'application/json', 'Authorization': 'Token ' }; const body = JSON.stringify({ shop_id: '', start: '04.01.26', end: '31.01.26', limit: 100, offset: 0 }); fetch(url, { method: 'POST', headers: headers, body: body }) .then(res => res.json()) .then(data => console.log(data)) .catch(err => console.error('Error:', err)); ``` {% endtab %} {% tab title="PHP" %} ```php ' ]; $data = json_encode([ 'shop_id' => '', 'start' => '04.01.26', 'end' => '31.01.26', 'limit' => 100, 'offset' => 0 ]); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); print_r($result); ``` {% endtab %} {% endtabs %} #### Примеры ответа На успешный запрос приходит ответ со статусом `success` и объектом `result`. {% tabs %} {% tab title="200: OK – Static list" %} ```json { "status": "success", "result": { "staticWallets": [ { "currency": { "id": 19, "code": "USDT_BSC", "short_code": "USDT", "name": "Tether", "is_email_required": false, "stablecoin": true, "icon_base": "https://cdn.cryptocloud.plus/img/currency/USDT.svg", "icon_network": "https://cdn.cryptocloud.plus/img/currency_network/USDT_BSC.svg", "icon_qr": "https://cdn.cryptocloud.plus/img/stroke/USDT_STROKE.svg", "order": 14, "obj_network": { "code": "BSC", "id": 19, "icon": "https://cdn.cryptocloud.plus/img/network/BSC.svg", "fullname": "BNB Smart Chain" }, "enable": true }, "address": "0x34eD0a7d57d2abA71871603dB206A06df141309D", "uuid": "J9JFJN085D921I390ULTP8EELYSE0P87", "active": true, "created": "2026-01-01 09:49:36.311119", "identify": "Test1" }, { "currency": { "id": 4, "code": "USDT_TRC20", "short_code": "USDT", "name": "Tether", "is_email_required": false, "stablecoin": true, "icon_base": "https://cdn.cryptocloud.plus/img/currency/USDT.svg", "icon_network": "https://cdn.cryptocloud.plus/img/currency_network/USDT_TRC.svg", "icon_qr": "https://cdn.cryptocloud.plus/img/stroke/USDT_STROKE.svg", "order": 1, "obj_network": { "code": "TRC20", "id": 4, "icon": "https://cdn.cryptocloud.plus/img/network/TRC20.svg", "fullname": "Tron" }, "enable": true }, "address": "TKDyKl8F871WiPd3q1jrxgg3HE4AHPDms6", "uuid": "KW2WWTTVNBHM97AGFUJ1SDNFQVS4ER0X", "active": true, "created": "2026-01-01 09:13:57.599180", "identify": "Test1" } ], "all_count": 2 } } ``` {% endtab %} {% endtabs %} #### Параметры ответа Объект result содержит: | staticWallets | array | - | Список статических кошельков | | ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | | currency | dict |

"currency": {

"id": 4,

"code": "USDT\_TRC20",

"short\_code": "USDT",

"name": "Tether", "is\_email\_required": false,

"stablecoin": true,

"icon\_base": "", "icon\_network": "",

"icon\_qr": "",

"order": 1, "obj\_network": {

"code": "TRC20",

"id": 4,

"icon": "", "fullname": "Tron"

}

| Информация по валюте | | enable | boolean | true | Статус кошелька | | address | string | “TT2T17K<...>79zdkEWkU9N” | Сгенерированный адрес статического кошелька | | uuid | string | “KW2WW<...>JPSDNFQVS4ER0X” | Идентификатор статического кошелька | | created | string | "2026-01-01 09:13:57.599180" | Дата создания | | identify | string | test\_static\_wallet | Наименование статического кошелька | | all\_count | int | 2 | Количество статических кошельков | *** ### Управление подпиской на адрес #### Что делает метод: * Активирует ранее созданный статический кошелек * Деактивирует ранее созданный статические кошелек #### Endpoint `POST` `https://api.cryptocloud.plus/v2/invoice/static/subscribe` `POST` `https://api.cryptocloud.plus/v2/invoice/static/unsubscribe` #### Headers | Name | Type | Example | Description | | ----------------------------------------------- | ------ | ----------------------------------- | ---------------- | | Authorization\* | string | Token eyJ0eXAiOiJK<...>4npi1ksS8tSY | API-ключ проекта | #### Request Body Основные параметры | Name | Type | Example | Description | | -------------------------------------- | ------ | ---------------------------------- | ----------------------------------- | | uuid\* | string | "J9JFJN085D922I394UL1P8EELYSE0P87" | Идентификатор статического кошелька | #### Пример запроса на активацию Эти примеры показывают, как можно активировать/деактивировать ранее созданный статический кошелек. {% tabs %} {% tab title="cURL" %} ```bash cURL curl --location 'https://api.cryptocloud.plus/v2/invoice/static/subscribe ' \ --header 'Content-Type: application/json' \ --header 'Authorization: Token ' \ --data '{ "uuid": "J9JFJN085D922I394UL1P8EELYSE0P87" }' ``` {% endtab %} {% tab title="Python" %} ```python import requests url = "https://api.cryptocloud.plus/v2/invoice/static/subscribe" headers = { "Content-Type": "application/json", "Authorization": "Token " } data = { "uuid": "J9JFJN085D922I394UL1P8EELYSE0P87" } response = requests.post(url, json=data, headers=headers) print(response.json()) ``` {% endtab %} {% tab title="JavaScript" %} ```javascript const url = 'https://api.cryptocloud.plus/v2/invoice/static/subscribe'; const headers = { 'Content-Type': 'application/json', 'Authorization': 'Token ' }; const body = JSON.stringify({ uuid: 'J9JFJN085D922I394UL1P8EELYSE0P87' }); fetch(url, { method: 'POST', headers: headers, body: body }) .then(res => res.json()) .then(data => console.log(data)) .catch(err => console.error('Error:', err)); ``` {% endtab %} {% tab title="PHP" %} ```php ' ]; $data = json_encode([ 'uuid' => 'J9JFJN085D922I394UL1P8EELYSE0P87' ]); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); print_r($result); ``` {% endtab %} {% endtabs %} #### Пример ответа На успешный запрос приходит ответ со статусом `success` и объектом `result`. {% tabs %} {% tab title="200: OK – Subscribe" %} ```json { "status": "success", "result": { "currency": { "id": 23, "code": "SOL", "short_code": "SOL", "name": "Solana", "is_email_required": false, "stablecoin": false, "icon_base": "https://cdn.cryptocloud.plus/img/currency/SOL.svg", "icon_network": "https://cdn.cryptocloud.plus/img/currency/SOL.svg", "icon_qr": "https://cdn.cryptocloud.plus/img/stroke/SOL_STROKE.svg", "order": 19, "obj_network": { "code": "SOL", "id": 23, "icon": "https://cdn.cryptocloud.plus/img/currency/SOL.svg", "fullname": "Solana" }, "enable": true }, "address": "BZeZochHaCVNtyS1vLAzavd5vJEV5tiFJBkGiXFLw6XA", "active": false } } ``` {% endtab %} {% endtabs %} #### Параметры ответа Объект `result` содержит: | Name | Type | Example | Description | | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- | | currency | dict |

"currency": {

"id": 23,

"code": "SOL",

"short\_code": "SOL",

"name": "Solana", "is\_email\_required": false,

"stablecoin": false,

"icon\_base": "", "icon\_network": "",

"icon\_qr": "",

"order": 19, "obj\_network": {

"code": "SOL",

"id": 23,

"icon": "",

"fullname": "Solana"

},

| Информация по валюте | | enable | boolean | true | Статус кошелька | | address | string | BZeZochH<...>vJEV5tiFJBkGiXFLw6XA | Сгенерированный адрес статического кошелька | | active | boolean | true | Статус подписки | > Мы регулярно работаем над улучшением документации сервиса для разработчиков. Пожалуйста, оцените качество и полезность материалов [по ссылке](https://survey.zohopublic.eu/zs/G6TdRh).