معاملات
post https://api.cryptomus.com/v2/user-api/transaction/list کپی کنید
درخواست
پارامترهای پرس و جو
| نام | نوع پارامتری | تعریف |
|---|---|---|
| date_from | string | فیلتر کردن بر اساس تاریخ ایجاد، از (قالب: "YYYY-MM-DD H:mm:ss") |
| date_to | string | فیلتر کردن بر اساس تاریخ ایجاد، به (قالب: "YYYY-MM-DD H:mm:ss") |
| type | string | نوع معامله |
نوع پارامتری
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 | انتقال از/به تراکنش های کیف پول تجاری |
تعریف
معاملات پرداختتعریف
معاملات پرداختتعریف
انتقال از/به تراکنش های کیف پول تجاری
واکنش
پارامترهای پاسخ
پارامترهای پاسخ اقلام
| نام | نوع پارامتری | تعریف |
|---|---|---|
| uuid | string | UUID تراکنش |
| type | string | نوع معامله |
| status | string|null | ساختار |
| created_at | string | زمان معامله |
| amount | string | مقدار |
| amount_equivalent | string|null | مبلغ به صورت معادل |
| currency_equivalent | string|null | مبلغ معادل ارز (ارز تعیین شده در حساب شخصی شما) |
| currency | string | کد ارز |
| network | string|null | کد شبکه blockchain |
| txid | string|null | هش تراکنش |
| address | string|null | آدرس کیف پول برای پرداخت |
| comment | string|null | تفسیر |
نوع پارامتری
stringتعریف
UUID تراکنشنوع پارامتری
stringتعریف
نوع معاملهنوع پارامتری
string|nullتعریف
ساختارنوع پارامتری
stringتعریف
زمان معاملهنوع پارامتری
stringتعریف
مقدارنوع پارامتری
string|nullتعریف
مبلغ به صورت معادلنوع پارامتری
string|nullتعریف
مبلغ معادل ارز (ارز تعیین شده در حساب شخصی شما)نوع پارامتری
stringتعریف
کد ارزنوع پارامتری
string|nullتعریف
کد شبکه blockchainنوع پارامتری
string|nullتعریف
هش تراکنشنوع پارامتری
string|nullتعریف
آدرس کیف پول برای پرداختنوع پارامتری
string|nullتعریف
تفسیر
صفحه بندی پارامترهای پاسخ
| نام | نوع پارامتری | تعریف |
|---|---|---|
| count | integer | تعداد موارد موجود در صفحه فعلی |
| hasPages | boolean | آیا عناصر کافی برای تقسیم به چندین صفحه (درست / نادرست) وجود دارد |
| nextCursor | string|null | مکان نما به صفحه بعد |
| previousCursor | string|null | مکان نما به صفحه قبلی |
| perPage | integer | حداکثر تعداد عناصر در هر صفحه |
نوع پارامتری
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 کپی کنید