المعاملات
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 | في انتظار ظهور المعاملة على 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 ينسخ