تاريخ الدفع
post
https://api.cryptomus.com/v1/payout/list
طلب
معلمات الاستعلام
| اسم | نوع المعلمة | القيمة الافتراضية | تعريف |
|---|---|---|---|
| date_from | stringformat: YYYY-MM-DD H:mm:ss | null | تصفية حسب تاريخ الخلق ، من |
| date_to | stringformat: YYYY-MM-DD H:mm:ss | null | تصفية حسب تاريخ الخلق ، إلى |
نوع المعلمة
stringformat: YYYY-MM-DD H:mm:ssتعريف
تصفية حسب تاريخ الخلق ، مننوع المعلمة
stringformat: YYYY-MM-DD H:mm:ssتعريف
تصفية حسب تاريخ الخلق ، إلى
طلب مثال
curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json'
لتصفية المدفوعات حسب تاريخ الخلق من 4 مايو إلى 16 مايو.
curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
"date_from": "2023-05-04 00:00:00"
"date_to": "2023-05-16 23:59:59"
}'إجابة
معلمات الاستجابة
هيكل غرض
| اسم | تعريف |
|---|---|
| uuid | uuid من الدفع |
| amount | مبلغ الدفع بالعملة |
| currency | رمز العملة للدفع |
| network | رمز شبكة blockchain التي يتم فيها إجراء الدفع |
| address | عنوان المحفظة التي يتم الدفع لها |
| txid | معرف المعاملة في blockchain |
| status | حالة الدفع الحالات |
| is_final | ما إذا تم الانتهاء من الدفعيتم اعتبار عملية الدفع الانتهاء بمجرد دفعها بنجاح أو إذا فشلت. في حالة فشل الدفع ، سيتم إرجاع الأموال إلى رصيدك ، مما يتطلب منك بدء عملية الدفع مرة أخرى. |
| balance | الأموال المتبقية على محفظة التاجر. |
| created_at | تاريخ إنشاء الدفع. المنطقة الزمنية هي UTC+3 |
| updated_at | آخر موعد تحديث الدفع. المنطقة الزمنية هي UTC+3 |
تعريف
uuid من الدفعتعريف
مبلغ الدفع بالعملةتعريف
رمز العملة للدفعتعريف
رمز شبكة blockchain التي يتم فيها إجراء الدفعتعريف
عنوان المحفظة التي يتم الدفع لهاتعريف
معرف المعاملة في blockchainتعريف
حالة الدفع الحالاتتعريف
ما إذا تم الانتهاء من الدفعيتم اعتبار عملية الدفع الانتهاء بمجرد دفعها بنجاح أو إذا فشلت. في حالة فشل الدفع ، سيتم إرجاع الأموال إلى رصيدك ، مما يتطلب منك بدء عملية الدفع مرة أخرى.تعريف
الأموال المتبقية على محفظة التاجر.تعريف
تاريخ إنشاء الدفع. المنطقة الزمنية هي UTC+3تعريف
آخر موعد تحديث الدفع. المنطقة الزمنية هي UTC+3
للحصول على إدخالات الصفحة التالية/السابقة ، حدد تجزئة المؤشر التالي/السابق في معلمات الاستعلام (?cursor=nextCursorHash)
مثال:
1curl https://api.cryptomus.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6مثال على الاستجابة
1{
2"state": 0,
3"result": {
4 "items": [{
5 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
6 "amount": "3",
7 "currency": "USDT",
8 "network": "TRON",
9 "address": "TJ...",
10 "txid": null,
11 "status": "process",
12 "is_final": false,
13 "balance": "129.00000000",
14 "created_at": "2023-06-21T17:25:55+03:00",
15 "updated_at": "2023-06-21T17:34:38+03:00"
16 }, {
17 "uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
18 "amount": "5.40000000",
19 "currency": "DOGE",
20 "network": "doge",
21 "address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
22 "txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
23 "order_id": null,
24 "payment_status": null,
25 "status": "paid",
26 "is_final": true,
27 "balance": "26.77966652",
28 "created_at": "2023-07-21T17:25:55+03:00",
29 "updated_at": "2023-07-21T17:34:38+03:00"
30 },
31 ...
32 ],
33 "paginate": {
34 "count": 15,
35 "hasPages": true,
36 "nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
37 "previousCursor": null,
38 "perPage": 15
39 }
40}
41}الأخطاء المحتملة
أخطاء التحقق من الصحة
شفرة : 422
الإجابات مثال:
إذا تم تمرير المعلمة date_from أو date_to بالتنسيق الخاطئ.
1{
2 "state": 1,
3 "errors": {
4 "date_from": ["validation.regex"]
5 }
6}