Static Wallets

The method allows you to create a static wallet to accept payments to the same address without creating a new invoice.

What is a static wallet

A static wallet allows customers to make payments to the same address without the need to create a new invoice or open a payment page each time.

This is a convenient solution that enables receiving funds in a specific cryptocurrency with automatic crediting to the merchant’s balance after all fees are deducted.

The solution is well-suited for projects that support user account balance top-ups, donation collection, iGaming platforms, and similar use cases.

How a static wallet works

The user proceeds to top up their balance on the merchant’s website.
The user creates wallets for different cryptocurrencies and can top up any of them. Important — 1 wallet = 1 currency.
The user transfers the amount to the wallet address or scans the QR code.
After the transfer, any amount of cryptocurrency received by the wallet is credited as a successful balance top-up for the user.
The merchant receives a notification about the 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

What the method allows you to do

Creates a static wallet with the specified parameters

Endpoint:

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

Headers:

Name

Type

Example

Description

Authorization*

string

Token eyJ0eXAiOiJK<...>4npi1ksS8tSY

Project API key

Request body

Key parameters

Name

Type

Example

Description

shop_id*

string

NGpD44<...>KXRdQ

Unique store identifier from the project settings

currency

string

ETH

Currency code:

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

Static wallets are not supported on the TON network.

identify*

string

ID_8843

Customer identifier.

When a POSTBACK is sent upon receiving a payment, it will be recorded in order_id.

Request examples

These examples show how to send a request to create a static wallet.

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

?>

Response examples

A successful request returns a response with the status success and a result object.

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

Response parameters

The result object contains:

Name

Type

Example

Description

status

string

success

Request execution status

currency

dict

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

}

Currency information

enable

boolean

true

Wallet status

address

string

“TT2T17<...>79zdkEWkU9N”

Generated static wallet address

uuid

string

“KW2W<...>UJPSDNFQVS4ER0X”

Static wallet identifier

created

string

"2026-01-01 09:13:57.599180"

Creation date

identify

string

test_static_wallet

Static wallet name

Getting the list of static wallets

What the method allows you to do

Returns a list of created static wallets.

Endpoint

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

Headers

Name

Type

Example

Description

Authorization*

string

Token eyJ0eXAiOiJK<...>4npi1ksS8tSY

Project API key

Request body

Key parameters

Name

Type

Example

Description

shop_id*

string

NGpD44<...>KXRdQ

Unique store identifier from the project settings

start

string

01.01.2026

Date in the format dd.mm.yyyy

end

string

31.01.2026

Date in the format dd.mm.yyyy. Must be greater than or equal to start

offset

int

This is the index of the starting record from which data retrieval begins.

For example, if offset=10, the data will start from the 11th record

limit

int

This is the number of the last record you want to retrieve.

For example, if limit=20, you will receive records up to and including the 20th, starting from the one specified in offset

Request examples

These examples show how to send a request to retrieve a list of static wallets.

curl --location 'https://api.cryptocloud.plus/v2/invoice/static/list' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <API KEY>' \
--data '{
    "shop_id": "<SHOP ID>",
    "start": "04.01.26",
    "end": "31.01.26",
    "limit": 100,
    "offset": 0
}'

import requests

url = "https://api.cryptocloud.plus/v2/invoice/static/list"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <API KEY>"
}
data = {
    "shop_id": "<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())

import fetch from 'node-fetch';

const url = 'https://api.cryptocloud.plus/v2/invoice/static/list';
const headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Token <API KEY>'
};
const body = JSON.stringify({
  shop_id: '<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));

<?php

$url = 'https://api.cryptocloud.plus/v2/invoice/static/list';

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

$data = json_encode([
    'shop_id' => '<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);

Response examples

A successful request returns a response with the status success and a result object.

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

Response parameters

The result object contains:

Name

Type

Example

Description

staticWallets

array

List of static wallets

currency

dict

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

}

Currency information

enable

boolean

true

Wallet status

address

string

“TT2T17K<...>79zdkEWkU9N”

Generated static wallet address

uuid

string

“KW2WW<...>JPSDNFQVS4ER0X”

Static wallet identifier

created

string

"2026-01-01 09:13:57.599180"

Creation date

identify

string

test_static_wallet

Static wallet name

all_count

int

Number of static wallets

Address subscription management

What the method allows you to do

Activates a previously created static wallet
Deactivates a previously created static wallet

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

Project API key

Request Body

Key parameters

Name

Type

Example

Description

uuid*

string

"J9JFJN085D922I394UL1P8EELYSE0P87"

Static wallet identifier

Activation request example

These examples show how to activate or deactivate a previously created static wallet.

cURL
curl --location 'https://api.cryptocloud.plus/v2/invoice/static/subscribe  ' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <API KEY>' \
--data '{
"uuid": "J9JFJN085D922I394UL1P8EELYSE0P87"
}'

import requests

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

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

const url = 'https://api.cryptocloud.plus/v2/invoice/static/subscribe';
const headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Token <API KEY>'
};
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));

<?php

$url = 'https://api.cryptocloud.plus/v2/invoice/static/subscribe';

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

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

Response example

A successful request returns a response with the status success and a result object.

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

Response parameters

The result object contains:

Name

Type

Example

Description

currency

dict

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

Currency information

enable

boolean

true

Wallet status

address

string

BZeZochH<...>vJEV5tiFJBkGiXFLw6XA

Generated static wallet address

active

boolean

true

Subscription status

PreviousAutomatic POSTBACK NextH2H Integration (White Label)

Last updated 5 days ago

Was this helpful?

hashtagWhat is a static wallet

hashtagHow a static wallet works

hashtagAdvantages of a static wallet

hashtagStatic wallet creation

hashtagWhat the method allows you to do

hashtagEndpoint:

hashtagHeaders:

hashtagRequest body

hashtagRequest examples

hashtagResponse examples

hashtagResponse parameters

hashtagGetting the list of static wallets

hashtagWhat the method allows you to do

hashtagEndpoint

hashtagHeaders

hashtagRequest body

hashtagRequest examples

hashtagResponse examples

hashtagResponse parameters

hashtagAddress subscription management

hashtagWhat the method allows you to do

hashtagEndpoint

hashtagHeaders

hashtagRequest Body

hashtagActivation request example

hashtagResponse example

hashtagResponse parameters

What is a static wallet

How a static wallet works

Advantages of a static wallet

Static wallet creation

What the method allows you to do

Endpoint:

Headers:

Request body

Request examples

Response examples

Response parameters

Getting the list of static wallets

What the method allows you to do

Endpoint

Headers

Request body

Request examples

Response examples

Response parameters

Address subscription management

What the method allows you to do

Endpoint

Headers

Request Body

Activation request example

Response example

Response parameters