معاملات

get
https://api.cryptomus.com/v2/user-api/transaction/list
کپی

درخواست

پارامترهای پرس و جو

نامتعریف
date_fromفیلتر کردن بر اساس تاریخ ایجاد، از (قالب: "YYYY-MM-DD H:mm:ss")
date_toفیلتر کردن بر اساس تاریخ ایجاد، به (قالب: "YYYY-MM-DD H:mm:ss")
typeنوع معامله

تعریف

فیلتر کردن بر اساس تاریخ ایجاد، از (قالب: "YYYY-MM-DD H:mm:ss")

تعریف

فیلتر کردن بر اساس تاریخ ایجاد، به (قالب: "YYYY-MM-DD H:mm:ss")

تعریف

نوع معامله

مثال


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"
  }'
کپی

انواع

انواع درخواست

نامتعریف
paymentمعاملات پرداخت
payoutمعاملات پرداخت
transferانتقال از/به تراکنش های کیف پول تجاری

تعریف

معاملات پرداخت

تعریف

معاملات پرداخت

تعریف

انتقال از/به تراکنش های کیف پول تجاری

واکنش

پارامترهای پاسخ

نامتعریف
items ساختار
paginate ساختار

تعریف

ساختار

تعریف

ساختار

پارامترهای پاسخ اقلام

نامتعریف
uuidUUID تراکنش
typeنوع معامله
status ساختار
amountمقدار
amount_equivalentمبلغ به صورت معادل
currency_equivalentمبلغ معادل ارز (ارز تعیین شده در حساب شخصی شما)
currencyکد ارز
commentتفسیر
networkکد شبکه blockchain
addressآدرس کیف پول برای پرداخت
txidهش تراکنش
created_atزمان معامله

تعریف

UUID تراکنش

تعریف

نوع معامله

تعریف

ساختار

تعریف

مقدار

تعریف

مبلغ به صورت معادل

تعریف

مبلغ معادل ارز (ارز تعیین شده در حساب شخصی شما)

تعریف

کد ارز

تعریف

تفسیر

تعریف

کد شبکه blockchain

تعریف

آدرس کیف پول برای پرداخت

تعریف

هش تراکنش

تعریف

زمان معامله

صفحه بندی پارامترهای پاسخ

نامتعریف
countتعداد موارد موجود در صفحه فعلی
hasPagesآیا عناصر کافی برای تقسیم به چندین صفحه (درست / نادرست) وجود دارد
nextCursorمکان نما به صفحه بعد
previousCursorمکان نما به صفحه قبلی
perPageحداکثر تعداد عناصر در هر صفحه

تعریف

تعداد موارد موجود در صفحه فعلی

تعریف

آیا عناصر کافی برای تقسیم به چندین صفحه (درست / نادرست) وجود دارد

تعریف

مکان نما به صفحه بعد

تعریف

مکان نما به صفحه قبلی

تعریف

حداکثر تعداد عناصر در هر صفحه

پارامترهای پاسخ وضعیت

نامتعریف
checkدر حال انتظار برای نمایش تراکنش در بلاک چین
paidمعامله با موفقیت انجام شد
failخطای معامله
cancelمعامله لغو شد
lockedبودجه به دلیل برنامه AML قفل می شود

تعریف

در حال انتظار برای نمایش تراکنش در بلاک چین

تعریف

معامله با موفقیت انجام شد

تعریف

خطای معامله

تعریف

معامله لغو شد

تعریف

بودجه به دلیل برنامه AML قفل می شود

برای به دست آوردن رکوردهای صفحه بعدی/قبلی، هش مکان نما بعدی/قبلی را در پارامترهای پرس و جو مشخص کنید. (?cursor=<nextCursorHash>)

مثال:


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 '{}'
کپی

نمونه پاسخ


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      
کپی