المعاملات
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 | التحويل من/إلى معاملات محفظة الأعمال |
تعريف
معاملات الدفعتعريف
معاملات الدفعتعريف
التحويل من/إلى معاملات محفظة الأعمال
إجابة
معلمات الاستجابة
معلمات استجابة العناصر
اسم | تعريف |
---|---|
uuid | UUID للمعاملة |
type | نوع المعاملة |
status | بناء |
amount | كمية |
amount_equivalent | المبلغ يعادل |
currency_equivalent | المبلغ المعادل للعملة (العملة المحددة في حسابك الشخصي) |
currency | رمز العملة |
comment | التعليق |
network | رمز شبكة blockchain |
address | عنوان محفظة للدفع |
txid | تجزئة الصفقة |
created_at | وقت الصفقة |
تعريف
UUID للمعاملةتعريف
نوع المعاملةتعريف
بناءتعريف
كميةتعريف
المبلغ يعادلتعريف
المبلغ المعادل للعملة (العملة المحددة في حسابك الشخصي)تعريف
رمز العملةتعريف
التعليقتعريف
رمز شبكة blockchainتعريف
عنوان محفظة للدفعتعريف
تجزئة الصفقةتعريف
وقت الصفقة
معلمات الاستجابة لصفحات الصفحات
اسم | تعريف |
---|---|
count | عدد العناصر في الصفحة الحالية |
hasPages | ما إذا كانت هناك عناصر كافية للانقسام إلى صفحات متعددة (صواب / خطأ) |
nextCursor | المؤشر إلى الصفحة التالية |
previousCursor | المؤشر إلى الصفحة السابقة |
perPage | الحد الأقصى لعدد العناصر لكل صفحة |
تعريف
عدد العناصر في الصفحة الحاليةتعريف
ما إذا كانت هناك عناصر كافية للانقسام إلى صفحات متعددة (صواب / خطأ)تعريف
المؤشر إلى الصفحة التاليةتعريف
المؤشر إلى الصفحة السابقةتعريف
الحد الأقصى لعدد العناصر لكل صفحة
معلمات استجابة الحالة
اسم | تعريف |
---|---|
check | في انتظار ظهور المعاملة على blockchain |
paid | كانت الصفقة ناجحة |
fail | خطأ في المعاملة |
cancel | تم إلغاء المعاملة |
locked | تم تأمين الأموال بسبب برنامج AML |
تعريف
في انتظار ظهور المعاملة على blockchainتعريف
كانت الصفقة ناجحةتعريف
خطأ في المعاملةتعريف
تم إلغاء المعاملةتعريف
تم تأمين الأموال بسبب برنامج 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
ينسخ