تاريخ الدفع
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القيمة الافتراضية
nullتعريف
تصفية حسب تاريخ الخلق ، مننوع المعلمة
stringformat: YYYY-MM-DD H:mm:ssالقيمة الافتراضية
nullتعريف
تصفية حسب تاريخ الخلق ، إلى
طلب مثال
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"
}'إجابة
معلمات الاستجابة
| اسم | نوع المعلمة | تعريف |
|---|---|---|
| merchant_uuid | string | تاجر Uuid |
| items | مجموعة من الدفعات. بناء | |
| paginate | بيانات ترقيم الصفحات. بناء |
هيكل غرض
| اسم | نوع المعلمة | تعريف |
|---|---|---|
| uuid | string | uuid من الدفع |
| amount | string | مبلغ الدفع بالعملة |
| currency | string | رمز العملة للدفع |
| network | string|null | رمز شبكة blockchain التي يتم فيها إجراء الدفع |
| payer_currency | string|null | رمز العملة المشفرة التي سيتم فيها إجراء الدفع. سيحصل عنوان الدفع على عملة الدفع. |
| payer_amount | string|null | المبلغ في payer_currency من الدفع. |
| address | string | عنوان المحفظة التي يتم الدفع لها |
| txid | string|null | معرف المعاملة في blockchain |
| status | string | حالة الدفع الحالات |
| payment_status | string | حالة السداد |
| is_final | boolean | ما إذا تم الانتهاء من الدفعيتم اعتبار عملية الدفع الانتهاء بمجرد دفعها بنجاح أو إذا فشلت. في حالة فشل الدفع ، سيتم إرجاع الأموال إلى رصيدك ، مما يتطلب منك بدء عملية الدفع مرة أخرى. |
| balance | string|null | الأموال المتبقية على محفظة التاجر. |
| order_id | string|null | طلب معرف في نظامك |
| commission | string|null | مبلغ عمولة Cryptomus |
| merchant_amount | string|null | المبلغ الذي يتم خصمه من رصيد التاجر ، بما في ذلك جميع اللجان. |
| created_at | string|null | تاريخ إنشاء الدفع. المنطقة الزمنية هي UTC+3 |
| updated_at | string|null | آخر موعد تحديث الدفع. المنطقة الزمنية هي UTC+3 |
| convert | معلومات حول العملة التي سيتم تحويل الدفع إليها تلقائيًا. يتم إجراء التحويل من payer_currency إلى USDTموجود إذا تم تمرير from_currency | |
| convert.to_currency | string|null | رمز العملة الذي سيتم تحويل الدفع إليه |
| convert.from_currency | string | من العملة |
| convert.commission | string | رسوم التحويل |
| convert.rate | string|null | معدل التحويل |
| convert.from_amount | string|null | المبلغ من |
نوع المعلمة
stringتعريف
uuid من الدفعنوع المعلمة
stringتعريف
مبلغ الدفع بالعملةنوع المعلمة
stringتعريف
رمز العملة للدفعنوع المعلمة
string|nullتعريف
رمز شبكة blockchain التي يتم فيها إجراء الدفعنوع المعلمة
string|nullتعريف
رمز العملة المشفرة التي سيتم فيها إجراء الدفع. سيحصل عنوان الدفع على عملة الدفع.نوع المعلمة
string|nullتعريف
المبلغ في payer_currency من الدفع.نوع المعلمة
stringتعريف
عنوان المحفظة التي يتم الدفع لهانوع المعلمة
string|nullتعريف
معرف المعاملة في blockchainنوع المعلمة
stringنوع المعلمة
stringتعريف
حالة السدادنوع المعلمة
booleanتعريف
ما إذا تم الانتهاء من الدفعيتم اعتبار عملية الدفع الانتهاء بمجرد دفعها بنجاح أو إذا فشلت. في حالة فشل الدفع ، سيتم إرجاع الأموال إلى رصيدك ، مما يتطلب منك بدء عملية الدفع مرة أخرى.نوع المعلمة
string|nullتعريف
الأموال المتبقية على محفظة التاجر.نوع المعلمة
string|nullتعريف
طلب معرف في نظامكنوع المعلمة
string|nullتعريف
مبلغ عمولة Cryptomusنوع المعلمة
string|nullتعريف
المبلغ الذي يتم خصمه من رصيد التاجر ، بما في ذلك جميع اللجان.نوع المعلمة
string|nullتعريف
تاريخ إنشاء الدفع. المنطقة الزمنية هي UTC+3نوع المعلمة
string|nullتعريف
آخر موعد تحديث الدفع. المنطقة الزمنية هي UTC+3تعريف
معلومات حول العملة التي سيتم تحويل الدفع إليها تلقائيًا. يتم إجراء التحويل من payer_currency إلى USDTموجود إذا تم تمرير from_currencyنوع المعلمة
string|nullتعريف
رمز العملة الذي سيتم تحويل الدفع إليهنوع المعلمة
stringتعريف
من العملةنوع المعلمة
stringتعريف
رسوم التحويلنوع المعلمة
string|nullتعريف
معدل التحويلنوع المعلمة
string|nullتعريف
المبلغ من
للحصول على إدخالات الصفحة التالية/السابقة ، حدد تجزئة المؤشر التالي/السابق في معلمات الاستعلام (?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 "merchant_uuid": "8b03432e-385b-4670-8d06-064591096795",
5 "items": [{
6 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
7 "amount": "3",
8 "currency": "USDT",
9 "network": "TRON",
10 "payer_currency": "USDT",
11 "payer_amount": "3",
12 "address": "TJ...",
13 "txid": null,
14 "status": "process",
15 "payment_status": "process",
16 "is_final": false,
17 "balance": "129.00000000",
18 "order_id": "1",
19 "commission": null,
20 "merchant_amount": null,
21 "created_at": "2023-06-21T17:25:55+03:00",
22 "updated_at": "2023-06-21T17:34:38+03:00"
23 }, {
24 "uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
25 "amount": "5.40000000",
26 "currency": "DOGE",
27 "network": "doge",
28 "payer_currency": "DOGE",
29 "payer_amount": "5.40000000",
30 "address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
31 "txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
32 "status": "paid",
33 "payment_status": "paid",
34 "is_final": true,
35 "balance": "26.77966652",
36 "order_id": null,
37 "commission": "0.00000000",
38 "merchant_amount": "5.40000000",
39 "created_at": "2023-07-21T17:25:55+03:00",
40 "updated_at": "2023-07-21T17:34:38+03:00"
41 },
42 ...
43 ],
44 "paginate": {
45 "count": 15,
46 "hasPages": true,
47 "nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
48 "previousCursor": null,
49 "perPage": 15
50 }
51}
52}الأخطاء المحتملة
أخطاء التحقق من الصحة
شفرة : 422
أمثلة على الردود:
إذا تم تمرير المعلمة date_from أو date_to بالتنسيق الخاطئ.
1{
2 "state": 1,
3 "errors": {
4 "date_from": ["validation.regex"]
5 }
6}