سابقه پرداخت
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 |
| currency | string | کد ارزی برای پرداخت |
| network | string|null | کد شبکه blockchain که در آن پرداخت می شود |
| payer_currency | string|null | کد cryptocurrency که در آن پرداخت در واقع انجام می شود. آدرس پرداخت پول پرداخت را دریافت می کند. |
| 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 | مبلغ کمیسیون رمزنگاری |
| 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تعریف
مبلغ پرداخت در currencyنوع پارامتری
stringتعریف
کد ارزی برای پرداختنوع پارامتری
string|nullتعریف
کد شبکه blockchain که در آن پرداخت می شودنوع پارامتری
string|nullتعریف
کد cryptocurrency که در آن پرداخت در واقع انجام می شود. آدرس پرداخت پول پرداخت را دریافت می کند.نوع پارامتری
string|nullتعریف
مبلغ در payer_currency پرداخت.نوع پارامتری
stringتعریف
آدرس کیف پولی که پرداخت آن انجام شده استنوع پارامتری
string|nullتعریف
شناسه معامله در blockchainنوع پارامتری
stringنوع پارامتری
stringتعریف
وضعیت پرداختنوع پارامتری
booleanتعریف
آیا پرداخت نهایی استپس از پرداخت موفقیت آمیز یا عدم موفقیت ، روند پرداخت نهایی نهایی می شود. در صورت خرابی پرداخت ، وجوه به تراز شما بازگردانده می شود و از شما خواسته می شود دوباره روند پرداخت را آغاز کنید.نوع پارامتری
string|nullتعریف
بودجه باقیمانده در کیف پول بازرگان.نوع پارامتری
string|nullتعریف
شناسه را در سیستم خود سفارش دهیدنوع پارامتری
string|nullتعریف
مبلغ کمیسیون رمزنگارینوع پارامتری
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}