المعاملات

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