Carteira estática
A Cobrex recomenda enviar todos os ativos que suporta na rede escolhida — por ex. em TRON use ["USDT", "TRX"]. Se o utilizador enviar o ativo errado (ex.: TRX em vez de USDT), os fundos têm mais hipótese de ser recuperados sem suporte.
Criar
POST https://api.cobrex.com/wallet
Content-Type: application/json
Cabeçalhos
| Cabeçalho | Valor |
|---|---|
x-mid | Merchant ID |
x-timestamp | Segundos |
x-signature | HMAC para URL\ntimestamp\ncorpo_JSON |
Corpo
| Campo | Tipo | Descrição |
|---|---|---|
asset | string[] | Ativos numa única rede (ver /public/assets). |
network | string | Rede (ex.: TRON). |
client | string | Id estável do seu utilizador / carteira. |
callback | string (URL) | URL de webhook para eventos neste endereço. |
Exemplo de corpo
{
"asset": ["USDT", "TRX"],
"network": "TRON",
"client": "test1",
"callback": "https://api.cobrex.com/webhook"
}
Exemplo de resposta
{
"wallets": [
{
"pid": "c-0ae60288-ebf1-11ef-b014-7cc255316480",
"asset": {
"name": "TRON",
"asset": "TRX",
"network": "TRON"
}
},
{
"pid": "c-b4ebfd16-e30f-11ef-b014-7cc255316480",
"asset": {
"name": "Tether USDT TRC-20",
"asset": "USDT",
"network": "TRON"
}
}
],
"client": "test1",
"address": "T9ySYRaEN1nsyefRBKsroJxtsCgog78zy1",
"callback": "https://api.cobrex.com/webhook"
}
wallets— ids internos de carteiras Cobrex por ativo.address— um endereço blockchain para onde o utilizador envia fundos.
Revogar carteira estática
Para deixar de usar um endereço emitido para um dado client, chame a revogação com o id da carteira da criação ou da última consulta.
POST https://api.cobrex.com/wallet/:id/revoke
Substitua :id pelo identificador (ex.: ligado a pid — confirme o caminho com o painel/suporte).
Cabeçalhos
| Cabeçalho | Valor |
|---|---|
x-mid | Merchant ID |
x-timestamp | Segundos |
x-signature | HMAC; sem corpo, URL\ntimestamp |
Após a revogação, um novo pedido de carteira para o mesmo client pode gerar um novo endereço.