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

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)

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

$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.

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

AnteriorLista de faturas SeguinteSaldo

Última atualização há 1 mês

Isto foi útil?