Carteiras estáticas

O método permite criar uma carteira estática para aceitar pagamentos no mesmo endereço sem criar uma nova fatura.

O que é uma carteira estática

Uma carteira estática permite que os clientes efetuem pagamentos para o mesmo endereço sem a necessidade de criar uma nova fatura ou abrir uma página de pagamento a cada vez.

Esta é uma solução conveniente que permite receber fundos numa criptomoeda específica com crédito automático no saldo do comerciante após a dedução de todas as taxas.

A solução é bem adequada para projetos que suportam recargas do saldo da conta do utilizador, recolha de donativos, plataformas de iGaming e casos de uso semelhantes.

Como uma carteira estática funciona

O utilizador prossegue para recarregar o seu saldo no site do comerciante.
O utilizador cria carteiras para diferentes criptomoedas e pode recarregar qualquer uma delas. Importante — 1 carteira = 1 moeda.
O utilizador transfere o montante para o endereço da carteira ou digitaliza o código QR.
Após a transferência, qualquer montante de criptomoeda recebido pela carteira é creditado como uma recarga de saldo bem-sucedida para o utilizador.
O comerciante recebe uma notificação sobre o pagamento bem-sucedido.

Vantagens de uma carteira estática

Comodidade para os clientes. O pagamento numa criptomoeda específica é feito para um endereço permanente sem aceder a uma página de pagamento.
Automatização do crédito. Os fundos são creditados automaticamente no saldo do cliente com o envio de uma notificação postback.
Transparência das taxas. Todas as taxas (de serviço, de transferência e, se necessário, AML) são deduzidas automaticamente do valor da transação.

Criação de carteira estática

O que o método permite fazer

Cria uma carteira estática com os parâmetros especificados

Ponto de extremidade:

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

Cabeçalhos:

Nome

Tipo

Exemplo

Descrição

Autorização*

string

Token eyJ0eXAiOiJK<...>4npi1ksS8tSY

Chave de API do projeto

Corpo do pedido

Parâmetros principais

Nome

Tipo

Exemplo

Descrição

shop_id*

string

NGpD44<...>KXRdQ

Identificador exclusivo da loja nas definições do projeto

currency

string

ETH

Código da moeda:

BTC, LTC, TRX, SOL, BNB, ETH, ETH_ARB, ETH_BASE, ETH_OPT, USDT_ARB, USDT_BSC, USDT_ERC20, USDT_OPT, USDT_SOL, 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, ARB_ARB, OP_OPT, PEPE_BSC, PEPE_ERC20, SHIB_BSC, SHIB_ERC20, TRUMP_SOL

As carteiras estáticas não são suportadas na rede TON.

identify*

string

ID_8843

Identificador do cliente.

Quando um POSTBACK é enviado ao receber um pagamento, ele será registado em order_id.

Exemplos de solicitação

Estes exemplos mostram como enviar um pedido para criar uma carteira estática.

curl -X POST https://api.trybit.com/v2/invoice/static/create \\
     -H 'Authorization: Token <API KEY>' \\
     -H 'Content-Type: application/json' \\
     -d '{"shop_id": "<SHOP ID>", "currency": "BTC", "identify": "F4jSjfpwf4t"}'

import requests

url = "https://api.trybit.com/v2/invoice/static/create"

headers = {
    'Authorization': "Token <API KEY>"
}

body = {
    "shop_id": "<SHOP ID>",
    "currency": "BTC",
    "identify": "F4jSjfpwf4t",
}

response = requests.post(url, headers=headers, json=body)

if response.status_code == 200:
    print("Sucesso:", response.json())
else:
    print("Falha:", response.status_code, response.text)

const url = "https://api.trybit.com/v2/invoice/static/create";

const headers = {
    'Authorization': 'Token <API KEY>',
    'Content-Type': 'application/json'
};

const body = {
    "shop_id": "<SHOP ID>",
    "currency": "BTC",
    "identify": "F4jSjfpwf4t"
};

fetch(url, {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(body)
})
.then(response => {
    if (response.ok) {
        return response.json();
    } else {
        throw new Error(`Falha ao buscar: ${response.statusText}`);
    }
})
.then(data => console.log("Sucesso:", data))
.catch(error => console.log("Falha:", error));

<?php

$url = "https://api.trybit.com/v2/invoice/static/create";

$headers = [
    'Authorization: Token <API KEY>',
    'Content-Type: application/json'
];

$body = [
    "shop_id" => "<SHOP ID>",
    "currency" => "BTC",
    "identify" => "F4jSjfpwf4t"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));

$response = curl_exec($ch);

if (curl_getinfo($ch, CURLINFO_HTTP_CODE) == 200) {
    echo "Sucesso: " . $response;
} else {
    echo "Falha: " . curl_getinfo($ch, CURLINFO_HTTP_CODE) . " " . $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": {
        "currency": {
            "id": 4,
            "code": "USDT_TRC20",
            "short_code": "USDT",
            "name": "Tether",
            "is_email_required": false,
            "stablecoin": true,
            "icon_base": "https://cdn.trybit.com/img/currency/USDT.svg",
            "icon_network": "https://cdn.trybit.com/img/currency_network/USDT_TRC.svg",
            "icon_qr": "https://cdn.trybit.com/img/stroke/USDT_STROKE.svg",
            "order": 1,
            "obj_network": {
                "code": "TRC20",
                "id": 4,
                "icon": "https://cdn.trybit.com/img/network/TRC20.svg",
                "fullname": "Tron"
            },
            "enable": true
        },
        "address": "TKDyKp8F874WiPd1q2jrxgg3HE4AHPDms6",
        "uuid": "KW2WWTTNNBHM17MGFUJPSDOFQVS4ER0X",
        "active": true,
        "created": "2026-01-01 09:13:57.599180",
        "identify": "test_static_wallet"
    }
}

Parâmetros de resposta

O resultado objeto contém:

Nome

Tipo

Exemplo

Descrição

status

string

sucesso

Estado de execução do pedido

currency

dict

"currency": {

"id": 4,

"code": "USDT_TRC20",

"short_code": "USDT",

"name": "Tether", "is_email_required": false,

"stablecoin": true,

"icon_base": "https://cdn.trybit.com/img/currency/USDT.svg", "icon_network": "https://cdn.trybit.com/img/currency_network/USDT_TRC.svg",

"icon_qr": "https://cdn.trybit.com/img/stroke/USDT_STROKE.svg",

"order": 1, "obj_network": {

"code": "TRC20",

"id": 4,

"icon": "https://cdn.trybit.com/img/network/TRC20.svg", "fullname": "Tron"

}

Informações da moeda

enable

booleano

true

Estado da carteira

address

string

“TT2T17<...>79zdkEWkU9N”

Endereço gerado da carteira estática

uuid

string

“KW2W<...>UJPSDNFQVS4ER0X”

Identificador da carteira estática

created

string

"2026-01-01 09:13:57.599180"

Data de criação

identify

string

test_static_wallet

Nome da carteira estática

Obtendo a lista de carteiras estáticas

O que o método permite fazer

Devolve uma lista de carteiras estáticas criadas.

Endpoint

POST https://api.trybit.com/v2/invoice/static/list

Cabeçalhos

Nome

Tipo

Exemplo

Descrição

Autorização*

string

Token eyJ0eXAiOiJK<...>4npi1ksS8tSY

Chave de API do projeto

Corpo do pedido

Parâmetros principais

Nome

Tipo

Exemplo

Descrição

shop_id*

string

NGpD44<...>KXRdQ

Identificador exclusivo da loja nas definições do projeto

start

string

01.01.2026

Data no formato dd.mm.aaaa

end

string

31.01.2026

Data no formato dd.mm.aaaa. Deve ser maior ou igual a start

offset

int

Este é o índice do registo inicial a partir do qual a obtenção dos dados começa.

Por exemplo, se offset=10, os dados começarão a partir do 11.º registo

limit

int

Este é o número do último registo que você deseja obter.

Por exemplo, se limit=20, você receberá registos até e incluindo o 20.º, começando pelo especificado em offset

Exemplos de solicitação

Estes exemplos mostram como enviar um pedido para recuperar uma lista de carteiras estáticas.

curl --location 'https://api.trybit.com/v2/invoice/static/list' \\
--header 'Content-Type: application/json' \\
--header 'Authorization: Token <API KEY>' \\
--data '{
    "shop_id": "<SHOP ID>",
    "start": "04.01.26",
    "end": "31.01.26",
    "limit": 100,
    "offset": 0
}'

import requests

url = "https://api.trybit.com/v2/invoice/static/list"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <API KEY>"
}
data = {
    "shop_id": "<SHOP ID>",
    "start": "04.01.26",
    "end": "31.01.26",
    "limit": 100,
    "offset": 0
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

import fetch from 'node-fetch';

const url = 'https://api.trybit.com/v2/invoice/static/list';
const headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Token <API KEY>'
};
const body = JSON.stringify({
  shop_id: '<SHOP ID>',
  start: '04.01.26',
  end: '31.01.26',
  limit: 100,
  offset: 0
});

fetch(url, {
  method: 'POST',
  headers: headers,
  body: body
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error('Erro:', err));

<?php

$url = 'https://api.trybit.com/v2/invoice/static/list';

$headers = [
    'Content-Type: application/json',
    'Authorization: Token <API KEY>'
];

$data = json_encode([
    'shop_id' => '<SHOP ID>',
    'start' => '04.01.26',
    'end' => '31.01.26',
    'limit' => 100,
    'offset' => 0
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Exemplos de resposta

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

{
    "status": "success",
    "result": {
        "staticWallets": [
            {
                "currency": {
                    "id": 19,
                    "code": "USDT_BSC",
                    "short_code": "USDT",
                    "name": "Tether",
                    "is_email_required": false,
                    "stablecoin": true,
                    "icon_base": "https://cdn.trybit.com/img/currency/USDT.svg",
                    "icon_network": "https://cdn.trybit.com/img/currency_network/USDT_BSC.svg",
                    "icon_qr": "https://cdn.trybit.com/img/stroke/USDT_STROKE.svg",
                    "order": 14,
                    "obj_network": {
                        "code": "BSC",
                        "id": 19,
                        "icon": "https://cdn.trybit.com/img/network/BSC.svg",
                        "fullname": "BNB Smart Chain"
                    },
                    "enable": true
                },
                "address": "0x34eD0a7d57d2abA71871603dB206A06df141309D",
                "uuid": "J9JFJN085D921I390ULTP8EELYSE0P87",
                "active": true,
                "created": "2026-01-01 09:49:36.311119",
                "identify": "Test1"
            },
            {
                "currency": {
                    "id": 4,
                    "code": "USDT_TRC20",
                    "short_code": "USDT",
                    "name": "Tether",
                    "is_email_required": false,
                    "stablecoin": true,
                    "icon_base": "https://cdn.trybit.com/img/currency/USDT.svg",
                    "icon_network": "https://cdn.trybit.com/img/currency_network/USDT_TRC.svg",
                    "icon_qr": "https://cdn.trybit.com/img/stroke/USDT_STROKE.svg",
                    "order": 1,
                    "obj_network": {
                        "code": "TRC20",
                        "id": 4,
                        "icon": "https://cdn.trybit.com/img/network/TRC20.svg",
                        "fullname": "Tron"
                    },
                    "enable": true
                },
                "address": "TKDyKl8F871WiPd3q1jrxgg3HE4AHPDms6",
                "uuid": "KW2WWTTVNBHM97AGFUJ1SDNFQVS4ER0X",
                "active": true,
                "created": "2026-01-01 09:13:57.599180",
                "identify": "Test1"
            }
        ],
        "all_count": 2
    }
}

Parâmetros de resposta

O resultado objeto contém:

Nome

Tipo

Exemplo

Descrição

staticWallets

array

Lista de carteiras estáticas

currency

dict

"currency": {

"id": 4,

"code": "USDT_TRC20",

"short_code": "USDT",

"name": "Tether", "is_email_required": false,

"stablecoin": true,

"icon_base": "https://cdn.trybit.com/img/currency/USDT.svg", "icon_network": "https://cdn.trybit.com/img/currency_network/USDT_TRC.svg",

"icon_qr": "https://cdn.trybit.com/img/stroke/USDT_STROKE.svg",

"order": 1, "obj_network": {

"code": "TRC20",

"id": 4,

"icon": "https://cdn.trybit.com/img/network/TRC20.svg", "fullname": "Tron"

}

Informações da moeda

enable

booleano

true

Estado da carteira

address

string

“TT2T17K<...>79zdkEWkU9N”

Endereço gerado da carteira estática

uuid

string

“KW2WW<...>JPSDNFQVS4ER0X”

Identificador da carteira estática

created

string

"2026-01-01 09:13:57.599180"

Data de criação

identify

string

test_static_wallet

Nome da carteira estática

all_count

int

Número de carteiras estáticas

Gestão da subscrição de endereços

O que o método permite fazer

Ativa uma carteira estática criada anteriormente
Desativa uma carteira estática criada anteriormente

Endpoint

POST https://api.trybit.com/v2/invoice/static/subscribe

POST https://api.trybit.com/v2/invoice/static/unsubscribe

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

uuid*

string

"J9JFJN085D922I394UL1P8EELYSE0P87"

Identificador da carteira estática

Exemplo de pedido de ativação

Estes exemplos mostram como ativar ou desativar uma carteira estática criada anteriormente.

cURL
curl --location 'https://api.trybit.com/v2/invoice/static/subscribe  ' \\
--header 'Content-Type: application/json' \\
--header 'Authorization: Token <API KEY>' \\
--data '{
"uuid": "J9JFJN085D922I394UL1P8EELYSE0P87"
}'

import requests

url = "https://api.trybit.com/v2/invoice/static/subscribe"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <API KEY>"
}
data = {
    "uuid": "J9JFJN085D922I394UL1P8EELYSE0P87"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const url = 'https://api.trybit.com/v2/invoice/static/subscribe';
const headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Token <API KEY>'
};
const body = JSON.stringify({
  uuid: 'J9JFJN085D922I394UL1P8EELYSE0P87'
});

fetch(url, {
  method: 'POST',
  headers: headers,
  body: body
})
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error('Erro:', err));

<?php

$url = 'https://api.trybit.com/v2/invoice/static/subscribe';

$headers = [
    'Content-Type: application/json',
    'Authorization: Token <API KEY>'
];

$data = json_encode([
    'uuid' => 'J9JFJN085D922I394UL1P8EELYSE0P87'
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Exemplo de resposta

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

{
    "status": "success",
    "result": {
        "currency": {
            "id": 23,
            "code": "SOL",
            "short_code": "SOL",
            "name": "Solana",
            "is_email_required": false,
            "stablecoin": false,
            "icon_base": "https://cdn.trybit.com/img/currency/SOL.svg",
            "icon_network": "https://cdn.trybit.com/img/currency/SOL.svg",
            "icon_qr": "https://cdn.trybit.com/img/stroke/SOL_STROKE.svg",
            "order": 19,
            "obj_network": {
                "code": "SOL",
                "id": 23,
                "icon": "https://cdn.trybit.com/img/currency/SOL.svg",
                "fullname": "Solana"
            },
            "enable": true
        },
        "address": "BZeZochHaCVNtyS1vLAzavd5vJEV5tiFJBkGiXFLw6XA",
        "active": false
    }
}

Parâmetros de resposta

O resultado objeto contém:

Nome

Tipo

Exemplo

Descrição

currency

dict

"currency": {

"id": 23,

"code": "SOL",

"short_code": "SOL",

"name": "Solana", "is_email_required": false,

"stablecoin": false,

"icon_base": "https://cdn.trybit.com/img/currency/SOL.svg", "icon_network": "https://cdn.trybit.com/img/currency/SOL.svg",

"icon_qr": "https://cdn.trybit.com/img/stroke/SOL_STROKE.svg",

"order": 19, "obj_network": {

"code": "SOL",

"id": 23,

"icon": "https://cdn.trybit.com/img/currency/SOL.svg",

"fullname": "Solana"

Informações da moeda

enable

booleano

true

Estado da carteira

address

string

BZeZochH<...>vJEV5tiFJBkGiXFLw6XA

Endereço gerado da carteira estática

active

booleano

true

Estado da subscrição

AnteriorPOSTBACK automático SeguinteIntegração H2H (White Label)

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

Isto foi útil?