Transactions

post https://api.cryptomus.com/v2/user-api/transaction/list Copie

Demande

Paramètres de requête

NomType de paramètreDéfinition
date_fromstringfiltrage par date de création, à partir de (format : "AAAA-MM-JJ H:mm:ss")
date_tostringfiltrage par date de création, au (format : "AAAA-MM-JJ H:mm:ss")
typestringType d'opération

Type de paramètre

string

Définition

filtrage par date de création, à partir de (format : "AAAA-MM-JJ H:mm:ss")

Type de paramètre

string

Définition

filtrage par date de création, au (format : "AAAA-MM-JJ H:mm:ss")

Type de paramètre

string

Définition

Type d'opération

Demander un exemple


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"
  }'
Copie

Espèces

Types de demandes

NomDéfinition
paymentOpérations de paiement
payoutOpérations de paiement
transferTransfert depuis/vers les transactions du portefeuille Business

Définition

Opérations de paiement

Définition

Opérations de paiement

Définition

Transfert depuis/vers les transactions du portefeuille Business

Réponse

Paramètres de réponse

NomType de paramètreDéfinition
itemsarray Structure
paginateobject Structure

Type de paramètre

array

Définition

Structure

Type de paramètre

object

Définition

Structure

Paramètres de réponse aux éléments

NomType de paramètreDéfinition
uuidstringUUID de la transaction
typestringType d'opération
statusstring|null Structure
created_atstringTemps de transaction
amountstringMontant
amount_equivalentstring|nullMontant en équivalent
currency_equivalentstring|nullMontant équivalent en devise (devise définie dans votre compte personnel)
currencystringCode de devise
networkstring|nullCode réseau blockchain
txidstring|nullHachage des transactions
addressstring|nullAdresse du portefeuille pour le paiement
commentstring|nullCommentaire

Type de paramètre

string

Définition

UUID de la transaction

Type de paramètre

string

Définition

Type d'opération

Type de paramètre

string|null

Définition

Structure

Type de paramètre

string

Définition

Temps de transaction

Type de paramètre

string

Définition

Montant

Type de paramètre

string|null

Définition

Montant en équivalent

Type de paramètre

string|null

Définition

Montant équivalent en devise (devise définie dans votre compte personnel)

Type de paramètre

string

Définition

Code de devise

Type de paramètre

string|null

Définition

Code réseau blockchain

Type de paramètre

string|null

Définition

Hachage des transactions

Type de paramètre

string|null

Définition

Adresse du portefeuille pour le paiement

Type de paramètre

string|null

Définition

Commentaire

Paginer les paramètres de réponse

NomType de paramètreDéfinition
countintegerNombre d'éléments sur la page actuelle
hasPagesbooleanS'il y a suffisamment d'éléments pour se diviser en plusieurs pages (vrai / faux)
nextCursorstring|nullCurseur à la page suivante
previousCursorstring|nullCurseur à la page précédente
perPageintegerNombre maximum d'éléments par page

Type de paramètre

integer

Définition

Nombre d'éléments sur la page actuelle

Type de paramètre

boolean

Définition

S'il y a suffisamment d'éléments pour se diviser en plusieurs pages (vrai / faux)

Type de paramètre

string|null

Définition

Curseur à la page suivante

Type de paramètre

string|null

Définition

Curseur à la page précédente

Type de paramètre

integer

Définition

Nombre maximum d'éléments par page

Paramètres de réponse d'état

NomDéfinition
checkEn attente que la transaction apparaisse sur la blockchain
paidLa transaction a réussi
failErreur de transaction
cancelTransaction annulée
lockedLes fonds sont verrouillés en raison du programme AML

Définition

En attente que la transaction apparaisse sur la blockchain

Définition

La transaction a réussi

Définition

Erreur de transaction

Définition

Transaction annulée

Définition

Les fonds sont verrouillés en raison du programme AML

Pour obtenir les enregistrements de la page suivante/précédente, spécifiez le hachage du curseur suivant/précédent dans les paramètres de la requête (?cursor=<nextCursorHash>)

Exemple:


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 '{}'
Copie

Exemple de réponse


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      
Copie