Transações

get
https://api.cryptomus.com/v2/user-api/transaction/list
CÓPIA DE

Solicitar

Parâmetros de consulta

NomeDefinição
date_fromfiltragem por data de criação, de (formato: "AAAA-MM-DD H:mm:ss")
date_tofiltragem por data de criação, até (formato: "AAAA-MM-DD H:mm:ss")
typeTipo de transação

Definição

filtragem por data de criação, de (formato: "AAAA-MM-DD H:mm:ss")

Definição

filtragem por data de criação, até (formato: "AAAA-MM-DD H:mm:ss")

Definição

Tipo de transação

Exemplo de solicitação


curl https://api.cryptomus.com/v2/user-api/transaction/list \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
    "date_from": "2023-05-16 00:00:00"
    "date_to": "2023-05-16 23:59:59"
    "type": "payment"
  }'
CÓPIA DE

Tipos

Tipos de solicitação

NomeDefinição
paymentTransações de pagamento
payoutTransações de pagamento
transferTransferência de/para transações de carteira comercial

Definição

Transações de pagamento

Definição

Transações de pagamento

Definição

Transferência de/para transações de carteira comercial

Resposta

Parâmetros de resposta

NomeDefinição
items Estrutura
paginate Estrutura

Definição

Estrutura

Definição

Estrutura

Parâmetros de resposta de itens

NomeDefinição
uuidUUID da transação
typeTipo de transação
status Estrutura
amountQuantia
amount_equivalentValor em equivalente
currency_equivalentValor equivalente em moeda (moeda definida em sua conta pessoal)
currencyCódigo da moeda
commentComentário
networkCódigo de rede blockchain
addressEndereço da carteira para pagamento
txidHash de transação
created_atTempo de transação

Definição

UUID da transação

Definição

Tipo de transação

Definição

Estrutura

Definição

Quantia

Definição

Valor em equivalente

Definição

Valor equivalente em moeda (moeda definida em sua conta pessoal)

Definição

Código da moeda

Definição

Comentário

Definição

Código de rede blockchain

Definição

Endereço da carteira para pagamento

Definição

Hash de transação

Definição

Tempo de transação

Parâmetros de resposta de paginação

NomeDefinição
countNúmero de itens na página atual
hasPagesSe existem elementos suficientes para dividir em várias páginas (verdadeiro / false)
nextCursorCursor para a próxima página
previousCursorCursor para a página anterior
perPageNúmero máximo de elementos por página

Definição

Número de itens na página atual

Definição

Se existem elementos suficientes para dividir em várias páginas (verdadeiro / false)

Definição

Cursor para a próxima página

Definição

Cursor para a página anterior

Definição

Número máximo de elementos por página

Parâmetros de resposta de status

NomeDefinição
checkEsperando que a transação apareça no blockchain
paidA transação foi bem-sucedida
failErro de transação
cancelTransação cancelada
lockedOs fundos estão bloqueados devido ao programa AML

Definição

Esperando que a transação apareça no blockchain

Definição

A transação foi bem-sucedida

Definição

Erro de transação

Definição

Transação cancelada

Definição

Os fundos estão bloqueados devido ao programa AML

Para obter os registros da página seguinte/anterior, especifique o hash do cursor seguinte/anterior nos parâmetros de consulta (?cursor=<nextCursorHash>)

Exemplo:


curl https://api.cryptomus.com/v2/user-api/transaction/list?cursor=eyJpZCI6MjEyLCJ fcG9pbnRzVzVG9OZhXh0SXRlbXMiOnRydWV9 \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: f80fa426a89eb62bd53997326865d850' \
    -H 'Content-Type: application/json' \
    -d '{}'
CÓPIA DE

Exemplo de resposta


1{
2  "state": 0,
3  "result": {
4    "items": [
5      {
6        "uuid": "3a3efbe5-4835-48f3-95c0-7b63e2c8a0b6",
7        "type": "transfer",
8        "status": "paid",
9        "created_at": "2022-07-22T15:11:46.000000Z",
10        "amount": "10.00",
11        "amount_equivalent": "10.1679",
12        "currency_equivalent": "USD",
13        "currency": "USDT",
14        "network": null,
15        "txid": null,
16        "address": null,
17        "comment": null
18      },
19      {
20        "uuid": "d4953ea1-6f55-46f1-b1c9-f72c04badc45",
21        "type": "payout",
22        "status": "paid",
23        "created_at": "2022-09-01T14:46:44.000000Z",
24        "amount": "10.00",
25        "amount_equivalent": "10.1679",
26        "currency_equivalent": "USD",
27        "currency": "USDT",
28        "network": "tron",
29        "txid": null,
30        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
31        "comment": null
32      },
33      {
34        "uuid": "690f745a-6b0c-42e1-a6ee-0de34485cab7",
35        "type": "payment",
36        "status": "fail",
37        "created_at": "2022-09-02T08:32:03.000000Z",
38        "amount": "2.00",
39        "amount_equivalent": "10.63359",
40        "currency_equivalent": "USD",
41        "currency": "USDT",
42        "network": "tron",
43        "txid": null,
44        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
45        "comment": null
46      }
47    ],
48    "paginate": {
49      "count": 3,
50      "hasPages": true,
51      "nextCursor": "eyJpdiI6IlFIZnd5Lzd0VUN3TGtUNUF6ckV5TEE9PSIsInZhbHVlIjoiUHcvZm1rWmRqdDVKL25NMW5EVEQ1OW9JS0NiSjhJcHd1byt5SGhmVG95UjhGaUlCa3djT1ZSOU5Lc29Id3B3bC80T0VBSnhhZEZBWk1yZUN5RTByN2pKK0dNVUZ0QnFlcThwMU93d0NSR2pXMHJOQWZIa3N6cStmT0YxOG9VVDJyT1Q2NmVhbU9JU1N6cTJsM3JLTitRPT0iLCJtYWMiOiI2M2E4OWVmZTk3MDNjYzUwNjY0ZWY4ZjcxMjUyOGUzMmI4NzNkNWU4YzNlYmUxNmNmMThhM2JhN2RjNTkyYjgxIiwidGFnIjoiIn0=",
52      "previousCursor": null,
53      "perPage": 15
54    }
55  }
56}
57
CÓPIA DE