Static Wallet

What is a static wallet

A static wallet allows customers to make payments to the same address without having to create a new invoice and proceed to the payment page each time.

This is a convenient method that allows you to accept funds in a specific cryptocurrency with automatic crediting to the balance after deducting all commissions.

The solution is perfectly suited for projects that involve topping up the user's account balance, accepting donations, iGaming projects, and others.

How a static wallet works

The user proceeds to replenish the balance on the merchant's website.
The user creates their own wallets for different cryptocurrencies and tops up any of them.
The user transfers the amount via wallet address or QR code.
After replenishment, any amount in the cryptocurrency assigned to the wallet is credited as a successful replenishment of the user's balance.
The user receives a notification of a successful payment.

Advantages of a static wallet

Convenience for customers. Payment in a particular cryptocurrency is made to one permanent address without going to a payment page.
Automation of crediting. Funds are automatically credited to the client's balance with the sending of a postback notification.
Transparency of fees. All fees (service, transfer and, if necessary, AML) are deducted from the transaction amount automatically.

Static wallet creation

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

Request Body

Name

Type

Description

shop_id*

String

Project identifier

currency*

String

Static wallet cryptocurrenc

identify*

String

Customer identifier. When POSTBACK is sent on receipt, it will be written to order_id

{
    "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"
    }
}

Request examples

These examples show how you can submit a request to create a static wallet. Note that you need to provide your API key in the Authorization header to successfully authorize the request.

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"}'

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)

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

$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);

?>

Getting the list of static wallets

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

Request Body

Name

Type

Description

shop_id*

String

Project Identifier

start

String

Start of the search time interval

end

String

End of the search time interval

offset

Int

The first wallet on the list

limit

Int

The last wallet on the list

{
    "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
    }
}

{
    "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"
    }
}

Subscription management for the address

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

Wallet identifier of 32 characters

{
    "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"
        }
    }
}

PreviousStatistics NextFunds Withdrawal

Last updated 8 months ago

Was this helpful?

hashtagWhat is a static wallet

hashtagHow a static wallet works

hashtagAdvantages of a static wallet

hashtagStatic wallet creation

hashtagRequest Body

hashtagRequest examples

hashtagGetting the list of static wallets

hashtagRequest Body

hashtagSubscription management for the address

hashtagRequest Body

What is a static wallet

How a static wallet works

Advantages of a static wallet

Static wallet creation

Request Body

Request examples

Getting the list of static wallets

Request Body

Subscription management for the address

Request Body