การสร้างการจ่ายเงิน
การจ่ายเงินผ่าน API จะทำจากยอดเงินในกระเป๋าเงินธุรกิจของคุณเท่านั้น
การจ่ายเงินสามารถทำได้หลายวิธี:
- คุณสามารถเลือกรับเงินเป็นสกุลเงินดิจิทัลเฉพาะเจาะจงได้ และเงินจะถูกประมวลผลเป็นสกุลเงินดิจิทัลเฉพาะเจาะจงนั้นโดยอัตโนมัติ โปรดตรวจสอบให้แน่ใจว่าคุณมีเงินคงเหลือในสกุลเงินนั้นเพียงพอสำหรับชำระค่าธรรมเนียมที่เกี่ยวข้องทั้งหมด
- อีกทางเลือกหนึ่งคือ คุณสามารถเลือกระบุจำนวนเงินที่จะจ่ายเป็นสกุลเงิน fiat ได้ ในกรณีนี้ จำนวนเงินจะถูกแปลงเป็นสกุลเงินดิจิทัลเฉพาะจากยอดคงเหลือของคุณโดยอัตโนมัติ ตัวอย่างเช่น หากคุณขอจ่ายเป็น LTC จำนวน 20 ดอลลาร์สหรัฐ มูลค่าที่เทียบเท่าจะถูกหักออกจากยอดคงเหลือ LTC ของคุณ สิ่งสำคัญคือต้องมีเงินในสกุลเงินดิจิทัลที่เกี่ยวข้องเพียงพอสำหรับค่าธรรมเนียมที่เกี่ยวข้องทั้งหมด
- อีกทางเลือกหนึ่งคือการระบุจำนวนเงินที่จะจ่ายเป็นสกุลเงิน fiat ซึ่งจะถูกแปลงเป็นสกุลเงินดิจิทัลเฉพาะโดยอัตโนมัติโดยใช้ยอดคงเหลือ USDT ของคุณ ตัวเลือกนี้มีประโยชน์อย่างยิ่งเมื่อคุณเปิดใช้งานการแปลงอัตโนมัติ เนื่องจากเงินจากใบแจ้งหนี้ของคุณจะถูกแปลงเป็น USDT โดยอัตโนมัติ ตัวอย่างเช่น หากคุณต้องการจ่าย 20 USD เป็น LTC แต่มียอดคงเหลือเป็น USDT เท่านั้น โปรดตรวจสอบให้แน่ใจว่าคุณมีเงิน USDT เพียงพอที่จะครอบคลุมค่าธรรมเนียมทั้งหมด
- นอกจากนี้ คุณยังสามารถเลือกกำหนดจำนวนเงินที่จะจ่ายเป็นสกุลเงินดิจิทัลใดๆ ก็ได้ที่คุณต้องการ การจ่ายเงินจะดำเนินการโดยอัตโนมัติในสกุลเงินดิจิทัลนั้นๆ โดยใช้ยอดคงเหลือ USDT ที่มีอยู่ของคุณ การมียอดคงเหลือ USDT เพียงพอสำหรับค่าธรรมเนียมที่เกี่ยวข้องทั้งหมดจึงเป็นสิ่งสำคัญ
ขอ
พารามิเตอร์การค้นหา
| ชื่อ | ประเภทพารามิเตอร์ | ค่าเริ่มต้น | คำนิยาม |
|---|---|---|---|
| amount* | string | จำนวนเงินที่จ่าย | |
| currency* | string | รหัสสกุลเงินสำหรับการจ่ายเงินหากสกุลเงินเป็น fiat จำเป็นต้องมีพารามิเตอร์ to_currency | |
| order_id* | stringmin:1max:100alpha_dash | รหัสคำสั่งซื้อในระบบของคุณพารามิเตอร์ควรเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายขีดกลาง ไม่ควรมีช่องว่างหรืออักขระพิเศษใดๆorder_id จะต้องไม่ซ้ำกันภายในรายการจ่ายเงินของผู้ค้าเมื่อเราพบการจ่ายเงินที่มีอยู่ด้วย order_id เราจะส่งคืนรายละเอียดของการจ่ายเงินนั้น และจะไม่มีการสร้างการจ่ายเงินใหม่ | |
| address* | string | ที่อยู่ของกระเป๋าเงินที่จะทำการถอนเงิน | |
| is_subtract* | boolean | กำหนดว่าจะหักค่าธรรมเนียมการถอนเงินที่ไหนจริง - จากความสมดุลของคุณเท็จ - จากจำนวนเงินที่จ่าย จำนวนเงินที่จ่ายจะลดลง | |
| network* | string | รหัสเครือข่ายบล็อคเชนไม่จำเป็นเมื่อ currency/to_currency เป็นสกุลเงินดิจิทัลและมีเครือข่ายเพียงเครือข่ายเดียว เช่น BTC | |
| url_callback | URL ที่จะส่งเว็บฮุกพร้อมสถานะการจ่ายเงิน | ||
| to_currency | รหัสคริปโทเคอร์เรนซีที่จะใช้ในการจ่ายเงิน จะใช้เมื่อพารามิเตอร์ currency เป็น fiat ดูตัวอย่างด้านล่าง | ||
| course_source | stringค่าที่มีอยู่• Binance• BinanceP2p• Exmo• Kucoin | ค่าจากการตั้งค่าของผู้ค้า | บริการที่นำอัตราแลกเปลี่ยนมาแปลงในใบแจ้งหนี้พารามิเตอร์จะถูกใช้เฉพาะในกรณีที่สกุลเงินเป็น fiat มิฉะนั้นค่าเริ่มต้นจะถูกนำมาจากการตั้งค่าของผู้ค้า |
| from_currency | string | null | ช่วยให้สามารถแปลงจำนวนเงินที่ถอนได้โดยอัตโนมัติและใช้ยอดคงเหลือ from_currency ได้ ใช้ได้เฉพาะ USDT เท่านั้น |
| priority | stringmin: 4max: 11ค่าที่มีอยู่• recommended• economy• high• highest | recommended | พารามิเตอร์สำหรับเลือกลำดับความสำคัญในการถอนเงิน ค่าธรรมเนียมการถอนเงินขึ้นอยู่กับพารามิเตอร์ที่เลือกพารามิเตอร์นี้ใช้ได้เฉพาะในกรณีที่ใช้เครือข่าย BTC, ETH, POLYGON และ BSC เท่านั้น |
| memo | stringmin: 1max: 30 | ตัวระบุเพิ่มเติมสำหรับ TON ใช้เพื่อระบุผู้รับหรือเป้าหมายที่เฉพาะเจาะจง |
ประเภทพารามิเตอร์
stringคำนิยาม
จำนวนเงินที่จ่ายประเภทพารามิเตอร์
stringคำนิยาม
รหัสสกุลเงินสำหรับการจ่ายเงินหากสกุลเงินเป็น fiat จำเป็นต้องมีพารามิเตอร์ to_currencyประเภทพารามิเตอร์
stringmin:1max:100alpha_dashคำนิยาม
รหัสคำสั่งซื้อในระบบของคุณพารามิเตอร์ควรเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายขีดกลาง ไม่ควรมีช่องว่างหรืออักขระพิเศษใดๆorder_id จะต้องไม่ซ้ำกันภายในรายการจ่ายเงินของผู้ค้าเมื่อเราพบการจ่ายเงินที่มีอยู่ด้วย order_id เราจะส่งคืนรายละเอียดของการจ่ายเงินนั้น และจะไม่มีการสร้างการจ่ายเงินใหม่ประเภทพารามิเตอร์
stringคำนิยาม
ที่อยู่ของกระเป๋าเงินที่จะทำการถอนเงินประเภทพารามิเตอร์
booleanคำนิยาม
กำหนดว่าจะหักค่าธรรมเนียมการถอนเงินที่ไหนจริง - จากความสมดุลของคุณเท็จ - จากจำนวนเงินที่จ่าย จำนวนเงินที่จ่ายจะลดลงประเภทพารามิเตอร์
stringคำนิยาม
รหัสเครือข่ายบล็อคเชนไม่จำเป็นเมื่อ currency/to_currency เป็นสกุลเงินดิจิทัลและมีเครือข่ายเพียงเครือข่ายเดียว เช่น BTCคำนิยาม
URL ที่จะส่งเว็บฮุกพร้อมสถานะการจ่ายเงินคำนิยาม
รหัสคริปโทเคอร์เรนซีที่จะใช้ในการจ่ายเงิน จะใช้เมื่อพารามิเตอร์ currency เป็น fiat ดูตัวอย่างด้านล่างประเภทพารามิเตอร์
string
ค่าที่มีอยู่- Binance- BinanceP2p- Exmo- Kucoinคำนิยาม
บริการที่นำอัตราแลกเปลี่ยนมาแปลงในใบแจ้งหนี้พารามิเตอร์จะถูกใช้เฉพาะในกรณีที่สกุลเงินเป็น fiat มิฉะนั้นค่าเริ่มต้นจะถูกนำมาจากการตั้งค่าของผู้ค้าประเภทพารามิเตอร์
stringคำนิยาม
ช่วยให้สามารถแปลงจำนวนเงินที่ถอนได้โดยอัตโนมัติและใช้ยอดคงเหลือ from_currency ได้ ใช้ได้เฉพาะ USDT เท่านั้นประเภทพารามิเตอร์
stringmin: 4max: 11
ค่าที่มีอยู่- recommended- economy- high- highestคำนิยาม
พารามิเตอร์สำหรับเลือกลำดับความสำคัญในการถอนเงิน ค่าธรรมเนียมการถอนเงินขึ้นอยู่กับพารามิเตอร์ที่เลือกพารามิเตอร์นี้ใช้ได้เฉพาะในกรณีที่ใช้เครือข่าย BTC, ETH, POLYGON และ BSC เท่านั้นประเภทพารามิเตอร์
stringmin: 1max: 30คำนิยาม
ตัวระบุเพิ่มเติมสำหรับ TON ใช้เพื่อระบุผู้รับหรือเป้าหมายที่เฉพาะเจาะจง
* - พารามิเตอร์บังคับ
ขอตัวอย่าง
curl https://api.cryptomus.com/v1/payout \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"amount": "5",
"currency": "USDT",
"network": "TRON",
"order_id": "1",
"address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
"url_callback": "https://your.site/callback",
"is_subtract": "1",
}'
การตอบสนอง
พารามิเตอร์การตอบสนอง
| ชื่อ | คำนิยาม |
|---|---|
| uuid | uuid ของการจ่ายเงิน |
| amount | จำนวนเงินที่จ่ายเป็นสกุลเงิน |
| currency | รหัสสกุลเงินสำหรับการจ่ายเงิน |
| network | รหัสของเครือข่ายบล็อคเชนที่ใช้ทำการชำระเงิน |
| address | ที่อยู่ของกระเป๋าเงินที่จะชำระเงิน |
| txid | รหัสธุรกรรมในบล็อคเชน |
| status | สถานะการจ่ายเงิน ดูสถานะทั้งหมดที่มีอยู่ |
| is_final | ว่าการจ่ายเงินจะเสร็จสิ้นหรือไม่กระบวนการจ่ายเงินจะถือว่าเสร็จสิ้นเมื่อชำระเงินสำเร็จหรือล้มเหลว ในกรณีที่การจ่ายเงินล้มเหลว เงินจะถูกส่งคืนไปยังยอดคงเหลือของคุณ ซึ่งคุณจะต้องเริ่มกระบวนการจ่ายเงินใหม่อีกครั้ง |
| balance | เงินที่เหลืออยู่ในยอดคงเหลือของผู้ค้า |
| payer_currency | รหัสคริปโทเคอร์เรนซีที่จะใช้ในการจ่ายเงินจริง ที่อยู่สำหรับการจ่ายเงินจะได้รับสกุลเงินที่จ่าย |
| payer_amount | จำนวนเงินใน payer_currency ของการจ่ายเงิน |
คำนิยาม
uuid ของการจ่ายเงินคำนิยาม
จำนวนเงินที่จ่ายเป็นสกุลเงินคำนิยาม
รหัสสกุลเงินสำหรับการจ่ายเงินคำนิยาม
รหัสของเครือข่ายบล็อคเชนที่ใช้ทำการชำระเงินคำนิยาม
ที่อยู่ของกระเป๋าเงินที่จะชำระเงินคำนิยาม
รหัสธุรกรรมในบล็อคเชนคำนิยาม
สถานะการจ่ายเงิน ดูสถานะทั้งหมดที่มีอยู่คำนิยาม
ว่าการจ่ายเงินจะเสร็จสิ้นหรือไม่กระบวนการจ่ายเงินจะถือว่าเสร็จสิ้นเมื่อชำระเงินสำเร็จหรือล้มเหลว ในกรณีที่การจ่ายเงินล้มเหลว เงินจะถูกส่งคืนไปยังยอดคงเหลือของคุณ ซึ่งคุณจะต้องเริ่มกระบวนการจ่ายเงินใหม่อีกครั้งคำนิยาม
เงินที่เหลืออยู่ในยอดคงเหลือของผู้ค้าคำนิยาม
รหัสคริปโทเคอร์เรนซีที่จะใช้ในการจ่ายเงินจริง ที่อยู่สำหรับการจ่ายเงินจะได้รับสกุลเงินที่จ่ายคำนิยาม
จำนวนเงินใน payer_currency ของการจ่ายเงิน
ตัวอย่างการตอบกลับ
1{
2 "state": 0,
3 "result": {
4 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
5 "amount": "3",
6 "currency": "USDT",
7 "network": "TRON",
8 "address": "TJ...",
9 "txid": null,
10 "status": "process",
11 "is_final": false,
12 "balance": 129,
13 "payer_currency": "USD",
14 "payer_amount": 3
15 }
16}
17ข้อผิดพลาดที่อาจเกิดขึ้น
ข้อผิดพลาดในการตรวจสอบ
รหัส : 422
ตัวอย่างคำตอบ:
1{
2 "state": 1,
3 "errors": {
4 "amount": ["validation.required"]
5 }
6}หากการชำระเงินถูกบล็อกจากร้านค้าหรือผู้ใช้ของคุณ คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้ ซึ่งจะเกิดขึ้นเมื่อคุณเปลี่ยนรหัสผ่านและการชำระเงินถูกบล็อกเป็นเวลา 24 ชั่วโมง
1{
2 "state": 1,
3 "message": "You are forbidden"
4}หากเราไม่สนับสนุนรหัสสกุลเงินที่คุณให้ไว้ในพารามิเตอร์สกุลเงิน คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "The currency was not found"
4}หากเราไม่พบบริการสำหรับการดำเนินการจ่ายเงิน คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้ คุณต้องตรวจสอบให้แน่ใจว่าสกุลเงินดิจิทัลนั้นได้รับการรองรับ ตรวจสอบความถูกต้องของค่าที่ป้อนใน currency, network, from_currency, to_currency:
1{
2 "state": 1,
3 "message": "The service was not found"
4}หากจำนวนเงินถอนมีน้อยเกินไป คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "The withdrawal amount is too small"
4}หากคุณไม่มีกระเป๋าเงินผู้ค้าที่ใช้งานอยู่พร้อมสกุลเงินดิจิทัลของการจ่ายเงิน คุณจะได้รับข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Wallet not found"
4}หากจำนวนเงินที่จ่ายรวมค่าคอมมิชชั่นทั้งหมดมากกว่ายอดคงเหลือของคุณ คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Not enough funds"
4}หากเราไม่พบบริการการจ่ายเงินของสกุลเงินที่ส่งผ่านในพารามิเตอร์ to_currency คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Not found service to_currency"
4}หากเกิดเหตุการณ์ไม่คาดฝันขึ้นเมื่อทำการแปลงเป็น to_currency คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Error convert to_currency"
4}หากจำนวนเงินที่จ่ายน้อยกว่าจำนวนเงินขั้นต่ำที่รองรับสำหรับสกุลเงินดิจิทัล คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Minimum amount 0.5 USDT"
4}หากจำนวนเงินที่จ่ายมากกว่าจำนวนเงินสูงสุดที่รองรับสำหรับสกุลเงินดิจิทัล คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Maximum amount 10000000 USDT"
4}หากคุณมีเงินไม่เพียงพอที่จะจ่ายเงิน คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Not enough funds"
4}หากคุณไม่มีเงินเพียงพอที่จะแปลงจำนวนเงินที่จ่ายจาก from_currency คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้:
1{
2 "state": 1,
3 "message": "Not enough balance for convert USDT to LTC"
4}หากเกิดการทำงานทางเทคนิคและการจ่ายเงินไม่สามารถใช้งานได้ชั่วคราว คุณจะได้รับข้อความแสดงข้อผิดพลาดนี้
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}ข้อผิดพลาดเซิร์ฟเวอร์ภายใน
รหัส : 500
ตัวอย่างคำตอบ:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}