سابقه پرداخت
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"
}'واکنش
پارامترهای پاسخ
| نام | تعریف |
|---|---|
| merchant_uuid | uuid بازرگان |
| items | مجموعه پرداخت ها. ساختار |
| paginate | داده ها برای صفحه بندی. ساختار |
ساختار قسمت
| نام | تعریف |
|---|---|
| uuid | UUID پرداخت |
| amount | مبلغ پرداخت در currency |
| currency | کد ارزی برای پرداخت |
| network | کد شبکه blockchain که در آن پرداخت می شود |
| address | آدرس کیف پولی که پرداخت آن انجام شده است |
| txid | شناسه معامله در blockchain |
| status | وضعیت پرداخت وضعیت وضعیت |
| is_final | آیا پرداخت نهایی استپس از پرداخت موفقیت آمیز یا عدم موفقیت ، روند پرداخت نهایی نهایی می شود. در صورت خرابی پرداخت ، وجوه به تراز شما بازگردانده می شود و از شما خواسته می شود دوباره روند پرداخت را آغاز کنید. |
| balance | بودجه باقیمانده در کیف پول بازرگان. |
| created_at | تاریخ ایجاد پرداخت. منطقه زمانی UTC+3 است |
| updated_at | آخرین تاریخ به روز شده پرداخت. منطقه زمانی UTC+3 است |
تعریف
UUID پرداختتعریف
مبلغ پرداخت در currencyتعریف
کد ارزی برای پرداختتعریف
کد شبکه 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}