Invoice Information

The method allows you to retrieve specific invoices by their identifiers using a POST request.

What the method allows you to do

• Returns complete information for the specified invoices.

• Maximum number of identifiers per request — 100.

Endpoint

POST https://api.trybit.com/v2/invoice/merchant/info

Headers

Name	Type	Example	Description
Authorization*	string	Token eyJ0eXAiOiJK<...>4npi1ksS8tSY	Project API key

Request Body

Key parameters

Name	Type	Example	Description
uuids*	array	INV-89UX09KA	List of invoice identifiers (INV-XXXXXXXX or XXXXXXXX)

Request examples

These examples show how to send a request to retrieve invoice information by INV number. Note that a single request must contain no more than 100 identifiers.

cURL

curl -X POST https://api.trybit.com/v2/invoice/merchant/info \
     -H "Authorization: Token <API KEY>" \
     -H "Content-Type: application/json" \
     -d '{"uuids":["INV-XXXXXXXX","INV-YYYYYYYY"]}'

Python

import requests

url = "https://api.trybit.com/v2/invoice/merchant/info"
headers = {
    "Authorization": "Token <API KEY>"
}
data = {
    "uuids": ["INV-XXXXXXXX", "INV-YYYYYYYY"]
}

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)

JavaScript

fetch('https://api.trybit.com/v2/invoice/merchant/info', {
    method: 'POST',
    headers: {
        'Authorization': 'Token <API KEY>',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        uuids: ['INV-XXXXXXXX', 'INV-YYYYYYYY']
    })
})
.then(response => {
    if (response.ok) {
        return response.json();
    } else {
        throw new Error('Fail: ' + response.status + ' ' + response.statusText);
    }
})
.then(data => console.log('Success:', data))
.catch(error => console.error('Error:', error));

PHP

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://api.trybit.com/v2/invoice/merchant/info");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(array(
    "uuids" => array("INV-XXXXXXXX", "INV-YYYYYYYY")
)));

$headers = array(
    "Authorization: Token <API KEY>",
    "Content-Type: application/json"
);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if ($statusCode == 200) {
        echo "Success: " . $response;
    } else {
        echo "Fail: " . $statusCode . " " . $response;
    }
}

curl_close($ch);
?>

Response examples

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

200: OK – Invoice info

{
    "status": "success",
    "result": [
        {
            "uuid": "INV-DO8ETFVT",
            "created": "2026-01-01 09:03:58.958133",
            "address": "LiWRq0uckKZ8qj5dhvgBdWzEtAxr8KbpBW",
            "currency": {
                "id": 2,
                "code": "LTC",
                "fullcode": "LTC",
                "network": {
                    "code": "litecoin",
                    "id": 2,
                    "icon": "https://cdn.trybit.com/img/network/LTC.svg",
                    "fullname": "Litecoin"
                },
                "name": "Litecoin",
                "is_email_required": false,
                "stablecoin": false,
                "icon_base": "https://cdn.trybit.com/img/currency/LTC.svg",
                "icon_network": "https://cdn.trybit.com/img/currency/LTC.svg",
                "icon_qr": "https://cdn.trybit.com/img/stroke/LTC_STROKE.svg",
                "order": 8
            },
            "date_finished": "2026-01-01 19:03:58.958133",
            "expiry_date": "2026-01-02 09:03:57.493361",
            "side_commission": "client",
            "side_commission_cc": "merchant",
            "type_payments": "crypto",
            "status": "overpaid",
            "invoice_status": "success",
            "is_email_required": false,
            "project": {
                "id": 1,
                "name": "Test",
                "fail": "https://test.com/failed-payment",
                "success": "https://test.com/successful-payment",
                "logo": ""
            },
            "tx_list": [
                ""
            ],
            "test_mode": false,
            "type": "up",
            "user_email": "",
            "pay_url": "None",
            "phone": "",
            "order_id": "None",
            "amount_in_crypto": null,
            "amount_in_fiat": 0.1,
            "amount": 0.01,
            "amount_usd": 0.1,
            "amount_to_pay": 0.01,
            "amount_to_pay_usd": 0.69,
            "amount_paid": 0.01,
            "amount_paid_usd": 0.69,
            "fee": 0.0,
            "fee_usd": 0.0,
            "service_fee": 0.00019,
            "service_fee_usd": 0.01,
            "received": 0.00981,
            "received_usd": 0.68,
            "to_surcharge": 0.0,
            "to_surcharge_usd": 0.0
        }
    ]
}

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	LiWRq0uck<...>Axr8KbpBW	Payment address
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	Transfer fee
fee_usd	float	0.01	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.trybit.com/89UX09KA	Link to the invoice page
currency	dict	"currency": { "id": 3, "code": "ETH", "fullcode": "ETH", "network": { "code": "ERC20", "id": 3, "icon": "https://cdn.trybit.com/img/network/ERC.svg", "fullname": "Ethereum" }, "name": "Ethereum", "is_email_required": false, "stablecoin": false, "icon_base": "https://cdn.trybit.com/img/currency/ETH.svg", "icon_network": "https://cdn.trybit.com/img/currency/ETH.svg", "icon_qr": "https://cdn.trybit.com/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.trybit.com/logo/logo.jpg" }	Object containing project information
test_mode	bool	false	Test invoice sign
received	float	0.00206	Amount credited to the balance in cryptocurrency
received_usd	float	0.26	Amount credited to the balance in USD
to_surcharge	float	0.001172	Amount remaining to be paid in cryptocurrency
to_surcharge_usd	float	0.08	Amount remaining to be paid in USD