ประวัติการจ่ายเงิน
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 | ข้อมูลสำหรับการแบ่งหน้า โครงสร้าง |
ประเภทพารามิเตอร์
stringคำนิยาม
Uuid ของพ่อค้า
โครงสร้างของ รายการ
| ชื่อ | ประเภทพารามิเตอร์ | คำนิยาม |
|---|---|---|
| uuid | string | uuid ของการจ่ายเงิน |
| amount | string | จำนวนเงินที่จ่ายเป็นสกุลเงิน |
| currency | string | รหัสสกุลเงินสำหรับการจ่ายเงิน |
| network | string|null | รหัสของเครือข่ายบล็อคเชนที่ใช้สำหรับการจ่ายเงิน |
| payer_currency | string|null | รหัสคริปโทเคอร์เรนซีที่จะใช้ในการจ่ายเงินจริง ที่อยู่สำหรับการจ่ายเงินจะได้รับสกุลเงินที่จ่าย |
| payer_amount | string|null | จำนวนเงินใน payer_currency ของการจ่ายเงิน |
| address | string | ที่อยู่ของกระเป๋าเงินที่จะชำระเงิน |
| txid | string|null | รหัสธุรกรรมในบล็อคเชน |
| 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คำนิยาม
รหัสของเครือข่ายบล็อคเชนที่ใช้สำหรับการจ่ายเงินประเภทพารามิเตอร์
string|nullคำนิยาม
รหัสคริปโทเคอร์เรนซีที่จะใช้ในการจ่ายเงินจริง ที่อยู่สำหรับการจ่ายเงินจะได้รับสกุลเงินที่จ่ายประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินใน payer_currency ของการจ่ายเงินประเภทพารามิเตอร์
stringคำนิยาม
ที่อยู่ของกระเป๋าเงินที่จะชำระเงินประเภทพารามิเตอร์
string|nullคำนิยาม
รหัสธุรกรรมในบล็อคเชนประเภทพารามิเตอร์
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}