การสร้างใบแจ้งหนี้
ขอ
พารามิเตอร์การค้นหา
| ชื่อ | ประเภทพารามิเตอร์ | ค่าเริ่มต้น | คำนิยาม |
|---|---|---|---|
| amount* | string | - | จำนวนเงินที่ต้องชำระหากมีเงินเป็นเพนนี ให้ส่งโดยใช้เครื่องหมายคั่น '.' ตัวอย่าง: 10.28 |
| currency* | string | - | รหัสสกุลเงิน |
| order_id* | stringmin: 1max: 100alpha_dash | - | รหัสคำสั่งซื้อในระบบของคุณพารามิเตอร์ควรเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายขีดกลาง ไม่ควรมีช่องว่างหรืออักขระพิเศษใดๆorder_id จะต้องไม่ซ้ำกันภายในใบแจ้งหนี้ของผู้ค้า/กระเป๋าสตางค์คงที่/การชำระเงินซ้ำเมื่อเราพบใบแจ้งหนี้ที่มีอยู่ซึ่งมี order_id เราจะส่งคืนรายละเอียดของใบแจ้งหนี้ดังกล่าว และจะไม่สร้างใบแจ้งหนี้ใหม่ |
| network | string | null | รหัสเครือข่ายบล็อคเชน |
| url_return | stringmin: 6max: 255url | null | ก่อนชำระเงินผู้ใช้สามารถคลิกปุ่มบนแบบฟอร์มชำระเงินและกลับสู่หน้าร้านค้าได้ที่ URL นี้ |
| url_success | stringmin: 6max: 255url | null | หลังจากชำระเงินสำเร็จแล้ว ผู้ใช้สามารถคลิกที่ปุ่มบนแบบฟอร์มชำระเงินและกลับมาที่ URL นี้ได้ |
| url_callback | stringmin: 6max: 255url | null | URL ที่จะส่งเว็บฮุกพร้อมสถานะการชำระเงิน |
| is_payment_multiple | boolean | true | ผู้ใช้มีสิทธิ์ชำระเงินส่วนที่เหลือหรือไม่ ฟังก์ชันนี้มีประโยชน์เมื่อผู้ใช้ยังไม่ได้ชำระเงินเต็มจำนวนตามใบแจ้งหนี้สำหรับธุรกรรมหนึ่ง และคุณต้องการให้ผู้ใช้ชำระเงินเต็มจำนวน หากคุณปิดใช้งานฟีเจอร์นี้ ใบแจ้งหนี้จะเสร็จสมบูรณ์หลังจากได้รับการชำระเงินครั้งแรก และคุณจะได้รับเงินเข้าบัญชี |
| lifetime | integermin: 300max: 43200 | 3600 | อายุการใช้งานของใบแจ้งหนี้ที่ออก (วินาที) |
| to_currency | string | - | พารามิเตอร์นี้ใช้เพื่อระบุสกุลเงินเป้าหมายสำหรับการแปลงจำนวนเงินในใบแจ้งหนี้ เมื่อสร้างใบแจ้งหนี้ คุณจะระบุจำนวนเงินและสกุลเงิน จากนั้น API จะแปลงจำนวนเงินดังกล่าวเป็นค่าเทียบเท่าใน to_currencyตัวอย่างเช่น การสร้างใบแจ้งหนี้มูลค่า 20 USD ใน bitcoin: จำนวนเงิน: 20 สกุลเงิน: USD to_currency: BTCAPI จะแปลงจำนวนเงิน 20 USD เป็น BTC ที่เทียบเท่าตามอัตราแลกเปลี่ยนปัจจุบัน และผู้ใช้จะชำระเงินเป็น BTCto_currency ควรเป็นรหัสสกุลเงินดิจิทัลเสมอ ไม่ใช่รหัสสกุลเงินทั่วไป |
| subtract | integermin: 0max: 100 | 0 | เปอร์เซ็นต์ของค่าคอมมิชชั่นการชำระเงินที่เรียกเก็บจากลูกค้าหากอัตราของคุณอยู่ที่ 1% ดังนั้นหากคุณสร้างใบแจ้งหนี้มูลค่า 100 USDT โดยลบออก = 100 (ลูกค้าจ่ายค่าคอมมิชชัน 100%) ลูกค้าจะต้องจ่าย 101 USDT |
| accuracy_payment_percent | numericmin: 0max: 5 | 0 | ความไม่ถูกต้องในการชำระเงินที่ยอมรับได้เช่น หากคุณผ่านค่า 5 ใบแจ้งหนี้จะถูกทำเครื่องหมายว่าชำระแล้ว แม้ว่าลูกค้าจะชำระเพียง 95% ของจำนวนเงินก็ตามยอดเงินที่ชำระจริงจะถูกเครดิตเข้าในยอดคงเหลือ |
| additional_data | stringmax: 255 | null | ข้อมูลเพิ่มเติมสำหรับคุณ (ไม่แสดงให้ลูกค้าเห็น) |
| currencies | array | มีการใช้สกุลเงินที่หลากหลายจากการตั้งค่าของผู้ค้าของคุณ (หากไม่ได้ตั้งค่าพารามิเตอร์ ระบบจะใช้สกุลเงินดิจิทัลที่รองรับทั้งหมดตามค่าเริ่มต้น)สกุลเงินที่ใช้ได้จะถูกตั้งค่าในส่วนการตั้งค่าผู้ค้า | รายการสกุลเงินที่อนุญาตสำหรับการชำระเงิน รายการนี้มีประโยชน์หากคุณต้องการจำกัดรายการเหรียญที่ลูกค้าของคุณสามารถใช้ชำระใบแจ้งหนี้ได้ โครงสร้าง |
| except_currencies | array | null | รายชื่อสกุลเงินที่ไม่รองรับการชำระเงิน โครงสร้าง |
| from_referral_code | string | null | ผู้ค้าที่ทำการร้องขอจะเชื่อมต่อกับผู้อ้างอิงด้วยรหัสตัวอย่างเช่น คุณเป็นแอปพลิเคชันที่สร้างใบแจ้งหนี้ผ่าน Cryptomus API และลูกค้าของคุณคือร้านค้าอื่นๆ พวกเขาป้อนรหัส API และรหัสร้านค้าในแอปพลิเคชันของคุณ และคุณส่งคำขอพร้อมข้อมูลประจำตัวของพวกเขาและส่งรหัสอ้างอิงของคุณดังนั้นลูกค้าของคุณจะกลายเป็นผู้อ้างอิงจากบัญชี Cryptomus ของคุณ และคุณจะได้รับรายได้จากยอดขายของพวกเขา |
| discount_percent | integermin: -99max: 90 | null | ตัวเลขบวก: ช่วยให้คุณกำหนดส่วนลดได้ หากต้องการกำหนดส่วนลด 5% สำหรับการชำระเงิน คุณควรส่งค่า: 5ตัวเลขติดลบ: ช่วยให้คุณตั้งค่าคอมมิชชันเพิ่มเติมที่กำหนดเองได้หากต้องการตั้งค่าคอมมิชชั่นเพิ่มเติม 10% สำหรับการชำระเงิน คุณควรส่งค่าดังนี้: -10เปอร์เซ็นต์ส่วนลดเมื่อสร้างใบแจ้งหนี้จะถูกนำมาพิจารณาเฉพาะในกรณีที่ใบแจ้งหนี้มีสกุลเงินดิจิทัลเฉพาะเท่านั้น |
| is_refresh | boolean | false | เมื่อใช้พารามิเตอร์นี้ คุณสามารถอัปเดตอายุการใช้งานและรับที่อยู่ใหม่สำหรับใบแจ้งหนี้หากอายุการใช้งานหมดอายุแล้วในการดำเนินการดังกล่าว คุณต้องส่งพารามิเตอร์ที่จำเป็นทั้งหมด และใบแจ้งหนี้ที่มี order_id ที่ส่งผ่านจะได้รับการรีเฟรชมีการเปลี่ยนแปลงเฉพาะ address, payment_status และ expired_at เท่านั้น ไม่มีการเปลี่ยนแปลงข้อมูลอื่นๆ ไม่ว่าจะส่งพารามิเตอร์อะไรก็ตาม |
ประเภทพารามิเตอร์
stringคำนิยาม
จำนวนเงินที่ต้องชำระหากมีเงินเป็นเพนนี ให้ส่งโดยใช้เครื่องหมายคั่น '.'
ตัวอย่าง: 10.28ประเภทพารามิเตอร์
stringคำนิยาม
รหัสสกุลเงินประเภทพารามิเตอร์
stringmin: 1max: 100alpha_dashคำนิยาม
รหัสคำสั่งซื้อในระบบของคุณพารามิเตอร์ควรเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายขีดกลาง ไม่ควรมีช่องว่างหรืออักขระพิเศษใดๆorder_id จะต้องไม่ซ้ำกันภายในใบแจ้งหนี้ของผู้ค้า/กระเป๋าสตางค์คงที่/การชำระเงินซ้ำเมื่อเราพบใบแจ้งหนี้ที่มีอยู่ซึ่งมี order_id เราจะส่งคืนรายละเอียดของใบแจ้งหนี้ดังกล่าว และจะไม่สร้างใบแจ้งหนี้ใหม่ประเภทพารามิเตอร์
stringค่าเริ่มต้น
nullคำนิยาม
รหัสเครือข่ายบล็อคเชนประเภทพารามิเตอร์
stringmin: 6max: 255urlค่าเริ่มต้น
nullคำนิยาม
ก่อนชำระเงินผู้ใช้สามารถคลิกปุ่มบนแบบฟอร์มชำระเงินและกลับสู่หน้าร้านค้าได้ที่ URL นี้ประเภทพารามิเตอร์
stringmin: 6max: 255urlค่าเริ่มต้น
nullคำนิยาม
หลังจากชำระเงินสำเร็จแล้ว ผู้ใช้สามารถคลิกที่ปุ่มบนแบบฟอร์มชำระเงินและกลับมาที่ URL นี้ได้ประเภทพารามิเตอร์
stringmin: 6max: 255urlค่าเริ่มต้น
nullคำนิยาม
URL ที่จะส่งเว็บฮุกพร้อมสถานะการชำระเงินประเภทพารามิเตอร์
booleanค่าเริ่มต้น
trueคำนิยาม
ผู้ใช้มีสิทธิ์ชำระเงินส่วนที่เหลือหรือไม่ ฟังก์ชันนี้มีประโยชน์เมื่อผู้ใช้ยังไม่ได้ชำระเงินเต็มจำนวนตามใบแจ้งหนี้สำหรับธุรกรรมหนึ่ง และคุณต้องการให้ผู้ใช้ชำระเงินเต็มจำนวน หากคุณปิดใช้งานฟีเจอร์นี้ ใบแจ้งหนี้จะเสร็จสมบูรณ์หลังจากได้รับการชำระเงินครั้งแรก และคุณจะได้รับเงินเข้าบัญชีประเภทพารามิเตอร์
integermin: 300max: 43200ค่าเริ่มต้น
3600คำนิยาม
อายุการใช้งานของใบแจ้งหนี้ที่ออก (วินาที)ประเภทพารามิเตอร์
stringคำนิยาม
พารามิเตอร์นี้ใช้เพื่อระบุสกุลเงินเป้าหมายสำหรับการแปลงจำนวนเงินในใบแจ้งหนี้ เมื่อสร้างใบแจ้งหนี้ คุณจะระบุจำนวนเงินและสกุลเงิน จากนั้น API จะแปลงจำนวนเงินดังกล่าวเป็นค่าเทียบเท่าใน to_currencyตัวอย่างเช่น การสร้างใบแจ้งหนี้มูลค่า 20 USD ใน bitcoin:
จำนวนเงิน: 20
สกุลเงิน: USD
to_currency: BTCAPI จะแปลงจำนวนเงิน 20 USD เป็น BTC ที่เทียบเท่าตามอัตราแลกเปลี่ยนปัจจุบัน และผู้ใช้จะชำระเงินเป็น BTCto_currency ควรเป็นรหัสสกุลเงินดิจิทัลเสมอ ไม่ใช่รหัสสกุลเงินทั่วไปประเภทพารามิเตอร์
integermin: 0max: 100ค่าเริ่มต้น
0คำนิยาม
เปอร์เซ็นต์ของค่าคอมมิชชั่นการชำระเงินที่เรียกเก็บจากลูกค้าหากอัตราของคุณอยู่ที่ 1% ดังนั้นหากคุณสร้างใบแจ้งหนี้มูลค่า 100 USDT โดยลบออก = 100 (ลูกค้าจ่ายค่าคอมมิชชัน 100%) ลูกค้าจะต้องจ่าย 101 USDTประเภทพารามิเตอร์
numericmin: 0max: 5ค่าเริ่มต้น
0คำนิยาม
ความไม่ถูกต้องในการชำระเงินที่ยอมรับได้เช่น หากคุณผ่านค่า 5 ใบแจ้งหนี้จะถูกทำเครื่องหมายว่าชำระแล้ว แม้ว่าลูกค้าจะชำระเพียง 95% ของจำนวนเงินก็ตามยอดเงินที่ชำระจริงจะถูกเครดิตเข้าในยอดคงเหลือประเภทพารามิเตอร์
stringmax: 255ค่าเริ่มต้น
nullคำนิยาม
ข้อมูลเพิ่มเติมสำหรับคุณ (ไม่แสดงให้ลูกค้าเห็น)ประเภทพารามิเตอร์
arrayค่าเริ่มต้น
มีการใช้สกุลเงินที่หลากหลายจากการตั้งค่าของผู้ค้าของคุณ (หากไม่ได้ตั้งค่าพารามิเตอร์ ระบบจะใช้สกุลเงินดิจิทัลที่รองรับทั้งหมดตามค่าเริ่มต้น)สกุลเงินที่ใช้ได้จะถูกตั้งค่าในส่วนการตั้งค่าผู้ค้าคำนิยาม
รายการสกุลเงินที่อนุญาตสำหรับการชำระเงิน รายการนี้มีประโยชน์หากคุณต้องการจำกัดรายการเหรียญที่ลูกค้าของคุณสามารถใช้ชำระใบแจ้งหนี้ได้ โครงสร้างประเภทพารามิเตอร์
stringค่าเริ่มต้น
nullคำนิยาม
ผู้ค้าที่ทำการร้องขอจะเชื่อมต่อกับผู้อ้างอิงด้วยรหัสตัวอย่างเช่น คุณเป็นแอปพลิเคชันที่สร้างใบแจ้งหนี้ผ่าน Cryptomus API และลูกค้าของคุณคือร้านค้าอื่นๆ
พวกเขาป้อนรหัส API และรหัสร้านค้าในแอปพลิเคชันของคุณ และคุณส่งคำขอพร้อมข้อมูลประจำตัวของพวกเขาและส่งรหัสอ้างอิงของคุณดังนั้นลูกค้าของคุณจะกลายเป็นผู้อ้างอิงจากบัญชี Cryptomus ของคุณ และคุณจะได้รับรายได้จากยอดขายของพวกเขาประเภทพารามิเตอร์
integermin: -99max: 90ค่าเริ่มต้น
nullคำนิยาม
ตัวเลขบวก:
ช่วยให้คุณกำหนดส่วนลดได้
หากต้องการกำหนดส่วนลด 5% สำหรับการชำระเงิน คุณควรส่งค่า: 5ตัวเลขติดลบ:
ช่วยให้คุณตั้งค่าคอมมิชชันเพิ่มเติมที่กำหนดเองได้หากต้องการตั้งค่าคอมมิชชั่นเพิ่มเติม 10% สำหรับการชำระเงิน คุณควรส่งค่าดังนี้: -10เปอร์เซ็นต์ส่วนลดเมื่อสร้างใบแจ้งหนี้จะถูกนำมาพิจารณาเฉพาะในกรณีที่ใบแจ้งหนี้มีสกุลเงินดิจิทัลเฉพาะเท่านั้นประเภทพารามิเตอร์
booleanค่าเริ่มต้น
falseคำนิยาม
เมื่อใช้พารามิเตอร์นี้ คุณสามารถอัปเดตอายุการใช้งานและรับที่อยู่ใหม่สำหรับใบแจ้งหนี้หากอายุการใช้งานหมดอายุแล้วในการดำเนินการดังกล่าว คุณต้องส่งพารามิเตอร์ที่จำเป็นทั้งหมด และใบแจ้งหนี้ที่มี order_id ที่ส่งผ่านจะได้รับการรีเฟรชมีการเปลี่ยนแปลงเฉพาะ address, payment_status และ expired_at เท่านั้น ไม่มีการเปลี่ยนแปลงข้อมูลอื่นๆ ไม่ว่าจะส่งพารามิเตอร์อะไรก็ตาม
* - พารามิเตอร์บังคับ
โครงสร้างของ สกุลเงิน
| ชื่อ | คำนิยาม |
|---|---|
| currency* | รหัสสกุลเงิน |
| network | รหัสเครือข่ายบล็อคเชน |
คำนิยาม
รหัสสกุลเงินคำนิยาม
รหัสเครือข่ายบล็อคเชน
* - พารามิเตอร์บังคับ
โครงสร้างของ except_currencies
| ชื่อ | คำนิยาม |
|---|---|
| currency* | รหัสสกุลเงิน |
| network | รหัสเครือข่ายบล็อคเชน |
คำนิยาม
รหัสสกุลเงินคำนิยาม
รหัสเครือข่ายบล็อคเชน
* - พารามิเตอร์บังคับ
ขอตัวอย่าง
ด้านล่างนี้คือตัวอย่างพร้อมจำนวนพารามิเตอร์ขั้นต่ำที่จำเป็น ในกรณีนี้ ระบบจะสร้างใบแจ้งหนี้โดยใช้สกุลเงินเฟียต USD ในหน้าการชำระเงิน ผู้ใช้จะสามารถเลือกสกุลเงินดิจิทัลและเครือข่ายสำหรับชำระบิลนี้ได้
curl https://api.cryptomus.com/v1/payment \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"amount": "15",
"currency": "USD",
"order_id": "1"
}'สำเนาการตอบสนอง
พารามิเตอร์การตอบสนอง
| ชื่อ | ประเภทพารามิเตอร์ | คำนิยาม |
|---|---|---|
| uuid | string | ใบแจ้งหนี้ uuid |
| order_id | string|null | รหัสคำสั่งซื้อในระบบของคุณ |
| amount | string | จำนวนเงินในใบแจ้งหนี้ |
| payment_amount | string|null | จำนวนเงินที่ลูกค้าชำระ |
| payment_amount_usd | string|null | จำนวนเงินที่ลูกค้าชำระจริงเป็นดอลลาร์สหรัฐ |
| payer_amount | string|null | จำนวนเงินในpayer_currencyที่ลูกค้าจะต้องชำระ รวมถึงส่วนลดหรือคอมมิชชั่นเพิ่มเติม |
| payer_amount_exchange_rate | string|null | อัตราแลกเปลี่ยนที่ใช้เมื่อดำเนินการชำระเงิน |
| discount_percent | integer|null | เปอร์เซ็นต์ของส่วนลดหรือคอมมิชชั่นเพิ่มเติมที่ส่งผ่านในพารามิเตอร์คำขอ |
| discount | string | จำนวนส่วนลดจริงหรือค่าคอมมิชชั่นเพิ่มเติมในสกุลเงินดิจิทัลตัวอย่างเช่น หากจำนวนเงินในใบแจ้งหนี้คือ 15 USDT และ discount_percent คือ -5 ค่าส่วนลดจะเท่ากับ -0.75นั่นคือ จำนวนเงิน + ส่วนลด = จำนวนเงินของผู้จ่าย |
| payer_currency | string|null | สกุลเงินที่ลูกค้าจะต้องใช้ชำระเงิน |
| currency | string | รหัสสกุลเงินใบแจ้งหนี้ |
| comments | string|null | บทวิจารณ์ |
| merchant_amount | string|null | จำนวนเงินคริปโตที่จะโอนเข้ายอดคงเหลือของคุณ หากไม่ได้ระบุใบแจ้งหนี้ payer_currency ค่าจะเป็นค่าว่าง |
| network | string|null | รหัสเครือข่ายบล็อคเชน |
| address | string|null | ที่อยู่กระเป๋าเงินสำหรับการชำระเงิน |
| from | string|null | ที่อยู่ของกระเป๋าเงินที่ใช้ชำระเงิน |
| txid | string|null | แฮชธุรกรรม |
| payment_status | string | สถานะการชำระเงิน สถานะการชำระเงินทั้งหมด |
| url | string | หน้าชำระเงิน URL |
| expired_at | integer|null | ประทับเวลาวันหมดอายุของใบแจ้งหนี้ |
| status | string | สถานะการชำระเงิน สถานะการชำระเงินทั้งหมด |
| is_final | boolean | ว่าใบแจ้งหนี้จะเสร็จสิ้นหรือยังเมื่อใบแจ้งหนี้เสร็จสิ้นแล้ว จะไม่สามารถชำระเงินตามใบแจ้งหนี้ได้ (ทั้งที่ชำระแล้วและหมดอายุแล้ว) |
| additional_data | string|null | ข้อมูลเพิ่มเติม |
| created_at | string|null | วันที่สร้างใบแจ้งหนี้ โซนเวลา UTC+3 |
| updated_at | string|null | วันที่อัปเดตใบแจ้งหนี้ล่าสุด โซนเวลาคือ UTC+3 |
| commission | string|null | ค่าคอมมิชชั่น Cryptomus |
| address_qr_code | string|null | รหัส QR ที่อยู่ |
| convert | ข้อมูลเกี่ยวกับสกุลเงินที่จะแปลงการชำระเงินโดยอัตโนมัติ การแปลงจะดำเนินการจาก payer_currency เป็น USDTมีอยู่หากมีการส่งค่า convert_currency_code มา | |
| convert.to_currency | string | รหัสสกุลเงินที่จะแปลงการชำระเงิน |
| convert.commission | string | ค่าธรรมเนียมการแปลง |
| convert.rate | string|null | อัตราการแปลง |
| convert.amount | string|null | จำนวนเงินแปลงเป็น to_currency ที่ถูกเพิ่มเข้าในยอดคงเหลือของผู้ค้า โดยหักค่าคอมมิชชันทั้งหมดออกไปแล้ว |
| convert_from | ข้อมูลเกี่ยวกับสกุลเงินที่ใช้ในการชำระเงินผิดพลาดแสดงหลักฐานหากการชำระเงินไม่ถูกต้อง | |
| convert_from.from_currency | string | จากสกุลเงิน |
| convert_from.from_amount | string|null | จำนวนเงินจาก |
| convert_from.from_network | string|null | รหัสเครือข่ายบล็อคเชน |
ประเภทพารามิเตอร์
stringคำนิยาม
ใบแจ้งหนี้ uuidประเภทพารามิเตอร์
string|nullคำนิยาม
รหัสคำสั่งซื้อในระบบของคุณประเภทพารามิเตอร์
stringคำนิยาม
จำนวนเงินในใบแจ้งหนี้ประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินที่ลูกค้าชำระประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินที่ลูกค้าชำระจริงเป็นดอลลาร์สหรัฐประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินในpayer_currencyที่ลูกค้าจะต้องชำระ รวมถึงส่วนลดหรือคอมมิชชั่นเพิ่มเติมประเภทพารามิเตอร์
string|nullคำนิยาม
อัตราแลกเปลี่ยนที่ใช้เมื่อดำเนินการชำระเงินประเภทพารามิเตอร์
integer|nullคำนิยาม
เปอร์เซ็นต์ของส่วนลดหรือคอมมิชชั่นเพิ่มเติมที่ส่งผ่านในพารามิเตอร์คำขอประเภทพารามิเตอร์
stringคำนิยาม
จำนวนส่วนลดจริงหรือค่าคอมมิชชั่นเพิ่มเติมในสกุลเงินดิจิทัลตัวอย่างเช่น หากจำนวนเงินในใบแจ้งหนี้คือ 15 USDT และ discount_percent คือ -5 ค่าส่วนลดจะเท่ากับ -0.75นั่นคือ จำนวนเงิน + ส่วนลด = จำนวนเงินของผู้จ่ายประเภทพารามิเตอร์
string|nullคำนิยาม
สกุลเงินที่ลูกค้าจะต้องใช้ชำระเงินประเภทพารามิเตอร์
stringคำนิยาม
รหัสสกุลเงินใบแจ้งหนี้ประเภทพารามิเตอร์
string|nullคำนิยาม
บทวิจารณ์ประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินคริปโตที่จะโอนเข้ายอดคงเหลือของคุณ หากไม่ได้ระบุใบแจ้งหนี้ payer_currency ค่าจะเป็นค่าว่างประเภทพารามิเตอร์
string|nullคำนิยาม
รหัสเครือข่ายบล็อคเชนประเภทพารามิเตอร์
string|nullคำนิยาม
ที่อยู่กระเป๋าเงินสำหรับการชำระเงินประเภทพารามิเตอร์
string|nullคำนิยาม
ที่อยู่ของกระเป๋าเงินที่ใช้ชำระเงินประเภทพารามิเตอร์
string|nullคำนิยาม
แฮชธุรกรรมประเภทพารามิเตอร์
stringประเภทพารามิเตอร์
stringคำนิยาม
หน้าชำระเงิน URLประเภทพารามิเตอร์
integer|nullคำนิยาม
ประทับเวลาวันหมดอายุของใบแจ้งหนี้ประเภทพารามิเตอร์
stringประเภทพารามิเตอร์
booleanคำนิยาม
ว่าใบแจ้งหนี้จะเสร็จสิ้นหรือยังเมื่อใบแจ้งหนี้เสร็จสิ้นแล้ว จะไม่สามารถชำระเงินตามใบแจ้งหนี้ได้ (ทั้งที่ชำระแล้วและหมดอายุแล้ว)ประเภทพารามิเตอร์
string|nullคำนิยาม
ข้อมูลเพิ่มเติมประเภทพารามิเตอร์
string|nullคำนิยาม
วันที่สร้างใบแจ้งหนี้ โซนเวลา UTC+3ประเภทพารามิเตอร์
string|nullคำนิยาม
วันที่อัปเดตใบแจ้งหนี้ล่าสุด โซนเวลาคือ UTC+3ประเภทพารามิเตอร์
string|nullคำนิยาม
ค่าคอมมิชชั่น Cryptomusประเภทพารามิเตอร์
string|nullคำนิยาม
รหัส QR ที่อยู่คำนิยาม
ข้อมูลเกี่ยวกับสกุลเงินที่จะแปลงการชำระเงินโดยอัตโนมัติ การแปลงจะดำเนินการจาก payer_currency เป็น USDTมีอยู่หากมีการส่งค่า convert_currency_code มาประเภทพารามิเตอร์
stringคำนิยาม
รหัสสกุลเงินที่จะแปลงการชำระเงินประเภทพารามิเตอร์
stringคำนิยาม
ค่าธรรมเนียมการแปลงประเภทพารามิเตอร์
string|nullคำนิยาม
อัตราการแปลงประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินแปลงเป็น to_currency ที่ถูกเพิ่มเข้าในยอดคงเหลือของผู้ค้า โดยหักค่าคอมมิชชันทั้งหมดออกไปแล้วคำนิยาม
ข้อมูลเกี่ยวกับสกุลเงินที่ใช้ในการชำระเงินผิดพลาดแสดงหลักฐานหากการชำระเงินไม่ถูกต้องประเภทพารามิเตอร์
stringคำนิยาม
จากสกุลเงินประเภทพารามิเตอร์
string|nullคำนิยาม
จำนวนเงินจากประเภทพารามิเตอร์
string|nullคำนิยาม
รหัสเครือข่ายบล็อคเชน
ตัวอย่างการตอบกลับ
1{
2 "state": 0,
3 "result": {
4 "uuid": "26109ba0-b05b-4ee0-93d1-fd62c822ce95",
5 "order_id": "1",
6 "amount": "15.00",
7 "payment_amount": null,
8 "payment_amount_usd": null,
9 "payer_amount": null,
10 "payer_amount_exchange_rate": null,
11 "discount_percent": null,
12 "discount": "0.00000000",
13 "payer_currency": null,
14 "currency": "USD",
15 "comments": null,
16 "merchant_amount": null,
17 "network": null,
18 "address": null,
19 "from": null,
20 "txid": null,
21 "payment_status": "check",
22 "url": "https://pay.cryptomus.com/pay/26109ba0-b05b-4ee0-93d1-fd62c822ce95",
23 "expired_at": 1689098133,
24 "status": "check",
25 "is_final": false,
26 "additional_data": null,
27 "created_at": "2023-07-11T20:23:52+03:00",
28 "updated_at": "2023-07-11T21:24:17+03:00",
29 "commission": null,
30 "address_qr_code": null
31 }
32}สำเนาตัวอย่างเพิ่มเติม
ขอข้อมูลเพื่อสร้างใบแจ้งหนี้มูลค่า 20 USDT ในเครือข่าย TRON ใบแจ้งหนี้จะมีที่อยู่ ณ เวลาที่สร้าง
1{
2 "amount": "20",
3 "currency": "USDT",
4 "order_id": "1",
5 "network": "tron"
6}สำเนาขอข้อมูลเพื่อสร้างใบแจ้งหนี้ 25 USD และให้ลูกค้าชำระเงินด้วย USDT เท่านั้นในเครือข่ายใดก็ได้
1{
2 "amount": "25",
3 "currency": "USD",
4 "order_id": "1",
5 "to_currency": "USDT"
6}สำเนาขอข้อมูลเพื่อสร้างใบแจ้งหนี้มูลค่า 25 ดอลลาร์สหรัฐ และอนุญาตให้ลูกค้าชำระเงินด้วย USDT เท่านั้นในเครือข่าย TRON ใบแจ้งหนี้จะมีที่อยู่ ณ เวลาที่สร้าง
1{
2 "amount": "25",
3 "currency": "USD",
4 "order_id": "1",
5 "to_currency": "USDT",
6 "network": "tron"
7}สำเนาขอข้อมูลเพื่อสร้างใบแจ้งหนี้ 20 USDT และอนุญาตให้ลูกค้าชำระเงินในเครือข่ายที่มีอยู่ทั้งหมด
1{
2 "amount": "20",
3 "currency": "USDT",
4 "order_id": "1"
5}สำเนาขอข้อมูลเพื่อสร้างใบแจ้งหนี้มูลค่า 20 ดอลลาร์สหรัฐ และอนุญาตให้ลูกค้าชำระเงินด้วย Bitcoin เท่านั้น ใบแจ้งหนี้จะมีที่อยู่ ณ เวลาที่สร้าง
1{
2 "amount": "20",
3 "currency": "USD",
4 "order_id": "1",
5 "to_currency": "BTC"
6}สำเนาขอข้อมูลเพื่อสร้างใบแจ้งหนี้มูลค่า 0.5 BTC และอนุญาตให้ลูกค้าชำระเงินด้วย Bitcoin เท่านั้น ใบแจ้งหนี้จะมีที่อยู่ ณ เวลาที่สร้าง
1{
2 "amount": "0.5",
3 "currency": "BTC",
4 "order_id": "1"
5}สำเนาข้อผิดพลาดที่อาจเกิดขึ้น
ข้อผิดพลาดในการตรวจสอบ
รหัส : 422
ตัวอย่างคำตอบ:
หากจำเป็นต้องมีพารามิเตอร์บางอย่างแต่ไม่ได้ผ่าน:
1{
2 "state": 1,
3 "errors": {
4 "amount": ["validation.required"]
5 }
6}สำเนาหากคุณระบุรหัสเครือข่ายที่ไม่ได้รับการรองรับ
1{
2 "state": 1,
3 "message": "The network was not found"
4}สำเนาหากเราไม่รองรับรหัสสกุลเงินที่คุณให้ไว้ในพารามิเตอร์ currency:
1{
2 "state": 1,
3 "message": "The currency was not found"
4}สำเนาหากการชำระเงินของคุณถูกระงับ ในกรณีนี้ คุณต้องติดต่อฝ่ายสนับสนุน
1{
2 "state": 1,
3 "message": "You are forbidden"
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": "Wallet not found"
4}สำเนาหากเกิดงานทางเทคนิคและไม่สามารถชำระเงินได้ชั่วคราว คุณอาจได้รับข้อความแสดงข้อผิดพลาดดังต่อไปนี้:
1{
2 "state": 1,
3 "message": "Gateway error"
4}สำเนา
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}สำเนา
1{
2 "state": 1,
3 "message": "Server error"
4}สำเนาข้อผิดพลาดเซิร์ฟเวอร์ภายใน
รหัส : 500
ตัวอย่างคำตอบ:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}สำเนา