Criação de fatura

O método permite criar uma fatura para um cliente usando uma solicitação POST.

Para criar uma fatura, você precisa enviar uma solicitação POST.

O que o método permite fazer

Cria uma fatura única
Retorna um link de pagamento ou detalhes de pagamento
Permite passar dados adicionais

Endpoint

POST https://api.trybit.com/v2/invoice/create

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

shop_id*

string

NGpD44<...>KXRdQ

Identificador único da loja da conta pessoal

amount*

float

100

Valor do pagamento em USD

currency

string

USD

Moedas de conversão disponíveis:

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.

A moeda padrão é USD.

order_id

string

ORDER_93223

Número personalizado da fatura no sistema externo

string

email@gmail.com

Endereço de e-mail do pagador

Parâmetros opcionais

add_fields — um objeto para passar dados adicionais

Nome

Tipo

Exemplo

Descrição

add_fields

dict

{time_to_pay: {

"hours": 24, "minutes": 0

}

Parâmetros adicionais

Os parâmetros opcionais devem ser passados dentro do add_fields objeto.

Nome

Tipo

Exemplo

Descrição

time_to_pay

dict

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

Tempo de vida da fatura

available_currencies

list[string]

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

Moedas de pagamento disponíveis:

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

cryptocurrency

string

ETH

Selecionando a moeda de pagamento em nome do usuário.

Se uma moeda for especificada, a página de pagamento exibirá os detalhes do pagamento sem uma opção de seleção de moeda.

O endereço e o valor também serão retornados na resposta da API.

Exemplos de solicitação

Estes exemplos mostram como enviar uma solicitação para criar uma fatura. Observe que você deve fornecer sua chave de API no Autorização cabeçalho para autorizar a solicitação com sucesso.

curl -X POST \\
     -H "Authorization: Token <API KEY>" \\
     -H "Content-Type: application/json" \\
     -d '{"amount": 100, "shop_id": "xBAivfPIbskwuEWj", "currency": "USD"}' \\
     "https://api.trybit.com/v2/invoice/create"

import requests
import json

url = "https://api.trybit.com/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("Sucesso:", response.json())
else:
    print("Falha:", response.status_code, response.text)

Fetch.js:

const url = 'https://api.trybit.com/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('Erro de criação');
    }
})
.then(data => {
    console.log('Sucesso:', data);
})
.catch(error => {
    console.error('Falha:', error);
});

Ajax.js:

$.ajax({
    url: 'https://api.trybit.com/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('Sucesso:', data);
    },
    error: function(error) {
        console.error('Falha:', error);
    }
});

Axios.js:

const axios = require('axios');

const url = 'https://api.trybit.com/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('Sucesso:', response.data);
    })
    .catch(error => {
        console.error('Falha:', error);
    });

cURL:

<?php
$url = "https://api.trybit.com/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 "Sucesso: " . $response;
} else {
    echo "Falha: " . $http_code . " " . $response;
}

curl_close($ch);
?>

File_get_contents:

<?php
$url = "https://api.trybit.com/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 "Sucesso: " . $response;
} else {
    echo "Falha: " . $http_code . " " . $response;
}
?>

Exemplos de resposta

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

{
    "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.trybit.com/89UX09KA",
        "invoice_id": null,
        "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
        },
        "project": {
            "id": 1,
            "name": "Test",
            "fail": "https://test.com/failed-payment",
            "success": "https://test.com/successful-payment",
            "logo": "https://static.trybit.com/logo/L52hWwjt98uYtUF91765782359.174416.jpg"
        },
        "test_mode": false
    }
}

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

0xb07427<...>E93D3846ee58B63

Endereço de pagamento

Será preenchido apenas se uma criptomoeda para pagamento for selecionada.

Para selecionar a moeda em nome do cliente, especifique uma moeda suportada pelo projeto em add_fields.cryptocurrency.

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 da fatura

fee_usd

float

0.01

Taxa de transferência da fatura 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

AnteriorAutorização da solicitação SeguinteCancelamento de fatura

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

Isto foi útil?