Transações
post https://api.cryptomus.com/v2/user-api/transaction/list Cópia
Solicitar
Parâmetros de consulta
| Nome | Tipo de parâmetro | Definição |
|---|---|---|
| date_from | string | filtragem por data de criação, de (formato: "AAAA-MM-DD H:mm:ss") |
| date_to | string | filtragem por data de criação, até (formato: "AAAA-MM-DD H:mm:ss") |
| type | string | Tipo de transação |
Tipo de parâmetro
stringDefinição
filtragem por data de criação, de (formato: "AAAA-MM-DD H:mm:ss")Tipo de parâmetro
stringDefinição
filtragem por data de criação, até (formato: "AAAA-MM-DD H:mm:ss")Tipo de parâmetro
stringDefiniçã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ópiaTipos
Tipos de solicitação
| Nome | Definição |
|---|---|
| payment | Transações de pagamento |
| payout | Transações de pagamento |
| transfer | Transferência de/para transações de carteira comercial |
Definição
Transações de pagamentoDefinição
Transações de pagamentoDefinição
Transferência de/para transações de carteira comercial
Resposta
Parâmetros de resposta
Parâmetros de resposta de itens
| Nome | Tipo de parâmetro | Definição |
|---|---|---|
| uuid | string | UUID da transação |
| type | string | Tipo de transação |
| status | string|null | Estrutura |
| created_at | string | Tempo de transação |
| amount | string | Quantia |
| amount_equivalent | string|null | Valor em equivalente |
| currency_equivalent | string|null | Valor equivalente em moeda (moeda definida em sua conta pessoal) |
| currency | string | Código da moeda |
| network | string|null | Código de rede blockchain |
| txid | string|null | Hash de transação |
| address | string|null | Endereço da carteira para pagamento |
| comment | string|null | Comentário |
Tipo de parâmetro
stringDefinição
UUID da transaçãoTipo de parâmetro
stringDefinição
Tipo de transaçãoTipo de parâmetro
string|nullDefinição
EstruturaTipo de parâmetro
stringDefinição
Tempo de transaçãoTipo de parâmetro
stringDefinição
QuantiaTipo de parâmetro
string|nullDefinição
Valor em equivalenteTipo de parâmetro
string|nullDefinição
Valor equivalente em moeda (moeda definida em sua conta pessoal)Tipo de parâmetro
stringDefinição
Código da moedaTipo de parâmetro
string|nullDefinição
Código de rede blockchainTipo de parâmetro
string|nullDefinição
Hash de transaçãoTipo de parâmetro
string|nullDefinição
Endereço da carteira para pagamentoTipo de parâmetro
string|nullDefinição
Comentário
Parâmetros de resposta de paginação
| Nome | Tipo de parâmetro | Definição |
|---|---|---|
| count | integer | Número de itens na página atual |
| hasPages | boolean | Se existem elementos suficientes para dividir em várias páginas (verdadeiro / false) |
| nextCursor | string|null | Cursor para a próxima página |
| previousCursor | string|null | Cursor para a página anterior |
| perPage | integer | Número máximo de elementos por página |
Tipo de parâmetro
integerDefinição
Número de itens na página atualTipo de parâmetro
booleanDefinição
Se existem elementos suficientes para dividir em várias páginas (verdadeiro / false)Tipo de parâmetro
string|nullDefinição
Cursor para a próxima páginaTipo de parâmetro
string|nullDefinição
Cursor para a página anteriorTipo de parâmetro
integerDefinição
Número máximo de elementos por página
Parâmetros de resposta de status
| Nome | Definição |
|---|---|
| check | Esperando que a transação apareça no blockchain |
| paid | A transação foi bem-sucedida |
| fail | Erro de transação |
| cancel | Transação cancelada |
| locked | Os fundos estão bloqueados devido ao programa AML |
Definição
Esperando que a transação apareça no blockchainDefinição
A transação foi bem-sucedidaDefinição
Erro de transaçãoDefinição
Transação canceladaDefiniçã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ópiaExemplo 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