Informações da fatura

O método permite recuperar faturas específicas pelos seus identificadores usando uma solicitação POST.

O que o método permite fazer

• Retorna informações completas para as faturas especificadas.

• Número máximo de identificadores por pedido — 100.

Endpoint

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

Cabeçalhos

Nome	Tipo	Exemplo	Descrição
Autorização*	string	Token eyJ0eXAiOiJK<...>4npi1ksS8tSY	Chave de API do projeto

Corpo da solicitação

Parâmetros principais

Nome	Tipo	Exemplo	Descrição
uuids*	vetor	INV-89UX09KA	Lista de identificadores de fatura (INV-XXXXXXXX ou XXXXXXXX)

Exemplos de solicitação

Estes exemplos mostram como enviar um pedido para obter informações da fatura pelo número INV. Note que um único pedido não deve conter mais de 100 identificadores.

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("Sucesso:", response.json())
else:
    print("Falha:", 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('Falha: ' + response.status + ' ' + response.statusText);
    }
})
.then(data => console.log('Sucesso:', data))
.catch(error => console.error('Erro:', 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 'Erro:' . curl_error($ch);
} else {
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if ($statusCode == 200) {
        echo "Sucesso: " . $response;
    } else {
        echo "Falha: " . $statusCode . " " . $response;
    }
}

curl_close($ch);
?>

Exemplos de resposta

Uma solicitação bem-sucedida retorna uma resposta com o status sucesso e um resultado objeto.

200: OK – Informações da fatura

{
    "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": "comerciante",
            "type_payments": "crypto",
            "status": "pago a mais",
            "invoice_status": "sucesso",
            "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": "Nenhum",
            "phone": "",
            "order_id": "Nenhum",
            "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
        }
    ]
}

Parâmetros de resposta

O resultado objeto contém:

Nome	Tipo	Exemplo	Descrição
uuid	string	INV-89UX09KA	Identificador único da fatura com o prefixo INV
created	string	2026-01-01 12:00:00.000000	Horário de criação da fatura no formato UTC+0: YYYY-MM-DD HH:MI:SS.FFFFFF
address	string	LiWRq0uck<...>Axr8KbpBW	Endereço de pagamento
expiry_date	string	2026-01-02 12:00:00.000000	Data de expiração da fatura no formato UTC+0: YYYY-MM-DD HH:MI:SS.FFFFFF. Após o tempo de expiração, o status da fatura mudará para cancelado se o pagamento não tiver sido recebido.
side_commission	string	cliente	Pagador da taxa de transferência
side_commission_cc	string	cliente	Pagador da taxa de serviço
amount	float	0.033366	Valor da fatura na criptomoeda selecionada
amount_usd	float	100.0	Valor da fatura em USD
amount_in_fiat	float	100.0	Valor da fatura na moeda de criação (depende do currency parâmetro)
fee	float	4.500000159168849e-06	Taxa de transferência
fee_usd	float	0.01	Taxa de transferência em USD
service_fee	float	0.000634	Taxa de serviço
service_fee_usd	float	1.9	Taxa de serviço em USD
fiat_currency	string	USD	Código da moeda fiduciária em que a fatura foi criada
status	string	created	Status da fatura Quando uma solicitação de criação de fatura é enviada, o status é sempre created. Outros status possíveis: pago (pago), parcial (parcialmente pago), pago em excesso (pago em excesso) e cancelado (cancelado).
is_email_required	bool	false	Parâmetro para exigir o e-mail do pagador na fatura
link	string	pay.trybit.com/89UX09KA	Link para a página da fatura
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 }	Objeto da criptomoeda selecionada na fatura. Também contém o network objeto — informações sobre a rede da moeda selecionada.
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" }	Objeto que contém informações do projeto
test_mode	bool	false	Assinatura da fatura de teste
received	float	0.00206	Montante creditado no saldo em criptomoeda
received_usd	float	0.26	Montante creditado no saldo em USD
to_surcharge	float	0.001172	Montante restante a pagar em criptomoeda
to_surcharge_usd	float	0.08	Montante restante a pagar em USD