Статический кошелек

Что такое статический кошелек

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

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

Решение отлично подходит для проектов, в которых предусмотрено пополнение баланса аккаунта пользователя, для приема пожертвований, проектов в сфере iGaming и др.

Как работает статический кошелек

1. Пользователь переходит к пополнению баланса на сайте мерчанта.

2. Пользователь созадет свои кошельки под разные криптовалюты и пополняет любой из них.

3. Переводит сумму по адресу кошелька или с помощью QR-кода.

4. После пополнения любая сумма в криптовалюте, закрепленной за кошельком, зачисляется как успешное пополнение баланса пользователя.

5. Пользователь получает уведомление об успешном платеже.

Преимущества статического кошелька

• Удобство для покупателей. Оплата в определенной криптовалюте осуществляется на один постоянный адрес без перехода на платежную страницу.

• Автоматизация зачисления. Средства автоматически поступают на баланс клиента с отправкой postback-уведомления.

• Прозрачность комиссий. Все комиссии (сервисная, трансферная и при необходимости AML) вычитаются из суммы транзакции автоматически.

Создание статического кошелька

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

Request Body

Name	Type	Description
shop_id*	String	Идентификатор проекта
currency*	String	Криптовалюта статического кошелька
identify*	String	Идентификатор клиента. При отправке POSTBACK по поступлению он будет записан в order_id

200: OK

{
    "status": "success",
    "result": {
        "currency": {
            "id": 3,
            "code": "ETH",
            "short_code": "ETH",
            "name": "Ethereum",
            "is_email_required": false,
            "stablecoin": false,
            "icon_base": "https://cdn.cryptocloud.plus/currency/icons/main/eth.svg",
            "icon_network": "None",
            "icon_qr": "https://cdn.cryptocloud.plus/currency/icons/stroke/eth.svg",
            "order": 9,
            "obj_network": {
                "code": "ERC20",
                "id": 3,
                "icon": "https://cdn.cryptocloud.plus/currency/crypto/ETH.svg",
                "fullname": "Ethereum"
            },
            "enable": true
        },
        "address": "StaticAdresse",
        "uuid": "2K0NFXT9E1X3VOY07VY1LRV8XGMLQNQX"
    }
}

400: Bad Request

{
    "status": "error",
    "result": {
        "validation_error": "Address not created / currency not passed / shop_id not passed"
    }
}

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

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

cURL

curl -X POST https://api.cryptocloud.plus/v2/invoice/static/create \
     -H 'Authorization: Token <API KEY>' \
     -H 'Content-Type: application/json' \
     -d '{"shop_id": "<SHOP ID>", "currency": "BTC", "identify": "F4jSjfpwf4t"}'

Python

import requests

url = "https://api.cryptocloud.plus/v2/invoice/static/create"

headers = {
    'Authorization': "Token <API KEY>"
}

body = {
    "shop_id": "<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)

JavaScript

const url = "https://api.cryptocloud.plus/v2/invoice/static/create";

const headers = {
    'Authorization': 'Token <API KEY>',
    'Content-Type': 'application/json'
};

const body = {
    "shop_id": "<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));

PHP

<?php

$url = "https://api.cryptocloud.plus/v2/invoice/static/create";

$headers = [
    'Authorization: Token <API KEY>',
    'Content-Type: application/json'
];

$body = [
    "shop_id" => "<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);

?>

Получение списка статических кошельков

POST https://api.cryptocloud.plus/v2/invoice/static/list

Request Body

Name	Type	Description
shop_id*	String	Идентификатор проекта
start	String	Начало временного интервала поиска
end	String	Конец временного интервала поиска
offset	Int	Первый кошелек в списке
limit	Int	Последний кошелек в списке

200: OK

{
    "status": "success",
    "result": {
        "staticWallets": [
            {
                "currency": {
                    "id": 4,
                    "code": "USDT_TRC20",
                    "short_code": "USDT",
                    "name": "Tether",
                    "is_email_required": false,
                    "stablecoin": true,
                    "icon_base": "https://cdn.cryptocloud.plus/currency/icons/main/usdt.svg",
                    "icon_network": "https://cdn.cryptocloud.plus/icons-currency/USDT-TRC20.svg",
                    "icon_qr": "https://cdn.cryptocloud.plus/currency/icons/stroke/usdt.svg",
                    "order": 1,
                    "obj_network": {
                        "code": "TRC20",
                        "id": 4,
                        "icon": "https://cdn.cryptocloud.plus/currency/crypto/TRX.svg",
                        "fullname": "Tron"
                    },
                    "enable": true
                },
                "active": true,
                "address": "StaticAdresse",
                "uuid": "3K0NFXT9E1X3VOY07VY1LRV8XGMLQNQX"
            }
        ],
        "all_count": 1
    }
}

400: Bad Request

{
    "status": "error",
    "result": {
        "validation_error": "Cannot resolve keyword 'not_existing_field' into field. Choices are: active, address, created, currency, currency_id, id, identify, project, project_id, user, user_id, uuid"
    }
}

Управление подпиской на адрес

POST https://api.cryptocloud.plus/v2/invoice/static/subscribe

POST https://api.cryptocloud.plus/v2/invoice/static/unsubscribe

Request Body

Name	Type	Description
uuid*	String	Идентификатор кошелька из 32 символов

200: OK

{
    "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/currency/icons/main/usdt.svg",
            "icon_network": "https://cdn.cryptocloud.plus/icons-currency/USDT-TRC20.svg",
            "icon_qr": "https://cdn.cryptocloud.plus/currency/icons/stroke/usdt.svg",
            "order": 1,
            "obj_network": {
                "code": "TRC20",
                "id": 4,
                "icon": "https://cdn.cryptocloud.plus/currency/crypto/TRX.svg",
                "fullname": "Tron"
            },
            "enable": true,
        "active": true,
        "address": "StaticAdresse",
        "created": "2025-01-01 09:15:00.849379",
        "identify": "identification"
        }
    }
}

400: Bad Request

{
    "status": "error",
    "result": {
        "validation_error": "Error message"
    }
}

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