Transações

post https://api.cryptomus.com/v2/user-api/transaction/list Cópia

Solicitar

Parâmetros de consulta

NomeTipo de parâmetroDefinição
date_fromstringfiltragem por data de criação, de (formato: "AAAA-MM-DD H:mm:ss")
date_tostringfiltragem por data de criação, até (formato: "AAAA-MM-DD H:mm:ss")
typestringTipo de transação

Tipo de parâmetro

string

Definição

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

Tipo de parâmetro

string

Definição

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

Tipo de parâmetro

string

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

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

NomeTipo de parâmetroDefinição
itemsarray Estrutura
paginateobject Estrutura

Tipo de parâmetro

array

Definição

Estrutura

Tipo de parâmetro

object

Definição

Estrutura

Parâmetros de resposta de itens

NomeTipo de parâmetroDefinição
uuidstringUUID da transação
typestringTipo de transação
statusstring|null Estrutura
created_atstringTempo de transação
amountstringQuantia
amount_equivalentstring|nullValor em equivalente
currency_equivalentstring|nullValor equivalente em moeda (moeda definida em sua conta pessoal)
currencystringCódigo da moeda
networkstring|nullCódigo de rede blockchain
txidstring|nullHash de transação
addressstring|nullEndereço da carteira para pagamento
commentstring|nullComentário

Tipo de parâmetro

string

Definição

UUID da transação

Tipo de parâmetro

string

Definição

Tipo de transação

Tipo de parâmetro

string|null

Definição

Estrutura

Tipo de parâmetro

string

Definição

Tempo de transação

Tipo de parâmetro

string

Definição

Quantia

Tipo de parâmetro

string|null

Definição

Valor em equivalente

Tipo de parâmetro

string|null

Definição

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

Tipo de parâmetro

string

Definição

Código da moeda

Tipo de parâmetro

string|null

Definição

Código de rede blockchain

Tipo de parâmetro

string|null

Definição

Hash de transação

Tipo de parâmetro

string|null

Definição

Endereço da carteira para pagamento

Tipo de parâmetro

string|null

Definição

Comentário

Parâmetros de resposta de paginação

NomeTipo de parâmetroDefinição
countintegerNúmero de itens na página atual
hasPagesbooleanSe existem elementos suficientes para dividir em várias páginas (verdadeiro / false)
nextCursorstring|nullCursor para a próxima página
previousCursorstring|nullCursor para a página anterior
perPageintegerNúmero máximo de elementos por página

Tipo de parâmetro

integer

Definição

Número de itens na página atual

Tipo de parâmetro

boolean

Definição

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

Tipo de parâmetro

string|null

Definição

Cursor para a próxima página

Tipo de parâmetro

string|null

Definição

Cursor para a página anterior

Tipo de parâmetro

integer

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

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