Invoice Creation

The method allows you to create an invoice for a customer using a POST request.

In order to create an invoice, you need to send a POST request.

What the method allows you to do

Creates a unique invoice
Returns a payment link or payment details
Allows you to pass additional data

Endpoint

POST https://api.cryptocloud.plus/v2/invoice/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 identifier of the store from personal account

amount*

float

100

Payment amount in USD

currency

string

USD

Available conversion currencies:

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.

The default currency is USD.

order_id

string

ORDER_93223

Custom invoice number in the external system

string

[email protected]

Payer’s email address

Optional parameters

add_fields — an object for passing additional data

Name

Type

Example

Description

add_fields

dict

{time_to_pay: {

"hours": 24, "minutes": 0

}

Additional parametres

Optional parameters must be passed within the add_fields object.

Name

Type

Example

Description

time_to_pay

dict

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

Invoice lifetime

Invoice due time

available_currencies

list[string]

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

Available payment currencies:

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

Payment currencies

cryptocurrency

string

ETH

Selecting the payment currency on behalf of the user.

If a currency is specified, the payment page will display the payment details without a currency selection option.

The address and amount will also be returned in the API response.

Select the payment currency for the user. The details will be displayed on the payment page when specifying the currency. The address will be given in response to the request.

Request examples

These examples show how to send a request to create an invoice. Note that you must provide your API key in the Authorization header to successfully authorize the request.

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;
}
?>

Response examples

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

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

Response parameters

The result object contains:

Name

Type

Example

Description

uuid

string

INV-89UX09KA

Unique invoice identifier with the INV prefix

created

string

2026-01-01 12:00:00.000000

Invoice creation time in UTC+0 format: YYYY-MM-DD HH:MI:SS.FFFFFF

address

string

0xb07427<...>E93D3846ee58B63

Payment address

Will be prefilled only if a cryptocurrency for payment is selected.

To select the currency on behalf of the customer, specify a project-supported currency in add_fields.cryptocurrency.

expiry_date

string

2026-01-02 12:00:00.000000

Invoice expiration date in UTC+0 format: YYYY-MM-DD HH:MI:SS.FFFFFF.

After the expiration time, the invoice status will change to canceled if payment has not been received.

side_commission

string

client

Transfer fee payer

side_commission_cc

string

client

Service fee payer

amount

float

0.033366

Invoice amount in the selected cryptocurrency

amount_usd

float

100.0

Invoice amount in USD

amount_in_fiat

float

100.0

Invoice amount in the creation currency (depends on the currency parameter)

fee

float

4.500000159168849e-06

Invoice transfer fee

fee_usd

float

0.01

Invoice transfer fee in USD

service_fee

float

0.000634

Service fee

service_fee_usd

float

1.9

Service fee in USD

fiat_currency

string

USD

Fiat currency code in which the invoice was created

status

string

created

Invoice status

When a create-invoice request is sent, the status is always created.

Other possible statuses: paid (paid), partial (partially paid), overpaid (overpaid), and canceled (canceled).

is_email_required

bool

false

Parameter for requiring the payer’s email in the invoice

link

string

pay.cryptocloud.plus/89UX09KA

Link to the invoice page

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

}

Object of the selected cryptocurrency in the invoice.

Also contains the network object — information about the selected currency 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"

Object containing project information

test_mode

bool

false

Test invoice sign

PreviousRequest Authorization NextInvoice Cancellation

Last updated 1 day ago

Was this helpful?

hashtagWhat the method allows you to do

hashtagEndpoint

hashtagHeaders

hashtagRequest Body

hashtagRequest examples

hashtagResponse examples

hashtagResponse parameters

What the method allows you to do

Endpoint

Headers

Request Body

Request examples

Response examples

Response parameters