المعاملات

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