معاملات

post https://api.cryptomus.com/v2/user-api/transaction/list کپی کنید

درخواست

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

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

نوع معامله

مثال


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انتقال از/به تراکنش های کیف پول تجاری

تعریف

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

تعریف

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

تعریف

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

واکنش

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

نامنوع پارامتریتعریف
itemsarray ساختار
paginateobject ساختار

نوع پارامتری

array

تعریف

ساختار

نوع پارامتری

object

تعریف

ساختار

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

نامنوع پارامتریتعریف
uuidstringUUID تراکنش
typestringنوع معامله
statusstring|null ساختار
created_atstringزمان معامله
amountstringمقدار
amount_equivalentstring|nullمبلغ به صورت معادل
currency_equivalentstring|nullمبلغ معادل ارز (ارز تعیین شده در حساب شخصی شما)
currencystringکد ارز
networkstring|nullکد شبکه blockchain
txidstring|nullهش تراکنش
addressstring|nullآدرس کیف پول برای پرداخت
commentstring|nullتفسیر

نوع پارامتری

string

تعریف

UUID تراکنش

نوع پارامتری

string

تعریف

نوع معامله

نوع پارامتری

string|null

تعریف

ساختار

نوع پارامتری

string

تعریف

زمان معامله

نوع پارامتری

string

تعریف

مقدار

نوع پارامتری

string|null

تعریف

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

نوع پارامتری

string|null

تعریف

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

نوع پارامتری

string

تعریف

کد ارز

نوع پارامتری

string|null

تعریف

کد شبکه blockchain

نوع پارامتری

string|null

تعریف

هش تراکنش

نوع پارامتری

string|null

تعریف

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

نوع پارامتری

string|null

تعریف

تفسیر

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

نامنوع پارامتریتعریف
countintegerتعداد موارد موجود در صفحه فعلی
hasPagesbooleanآیا عناصر کافی برای تقسیم به چندین صفحه (درست / نادرست) وجود دارد
nextCursorstring|nullمکان نما به صفحه بعد
previousCursorstring|nullمکان نما به صفحه قبلی
perPageintegerحداکثر تعداد عناصر در هر صفحه

نوع پارامتری

integer

تعریف

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

نوع پارامتری

boolean

تعریف

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

نوع پارامتری

string|null

تعریف

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

نوع پارامتری

string|null

تعریف

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

نوع پارامتری

integer

تعریف

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

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

نامتعریف
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      
کپی کنید