การสร้างกระเป๋าสตางค์แบบคงที่
post
https://api.cryptomus.com/v1/wallet
ขอ
พารามิเตอร์การค้นหา
| ชื่อ | ประเภทพารามิเตอร์ | ค่าเริ่มต้น | คำนิยาม |
|---|---|---|---|
| currency* | string | รหัสสกุลเงิน | |
| network* | string | รหัสเครือข่ายบล็อคเชน | |
| order_id* | stringmin: 1max: 100alpha_dash | รหัสคำสั่งซื้อในระบบของคุณพารามิเตอร์ควรเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายขีดกลาง ไม่ควรมีช่องว่างหรืออักขระพิเศษใดๆorder_id จะต้องไม่ซ้ำกันภายในใบแจ้งหนี้ของผู้ค้า/กระเป๋าสตางค์คงที่/การชำระเงินซ้ำเมื่อเราพบใบแจ้งหนี้ที่มีอยู่ซึ่งมี order_id เราจะส่งคืนรายละเอียดของใบแจ้งหนี้ดังกล่าว และจะไม่สร้างใบแจ้งหนี้ใหม่ | |
| url_callback | stringmin: 6max: 255url | null | URL ที่เว็บฮุกจะถูกส่งไปหลังจากการเติมเงินในกระเป๋าสตางค์แต่ละครั้ง |
| from_referral_code | string | null | ผู้ค้าที่ทำการร้องขอจะเชื่อมต่อกับผู้อ้างอิงด้วยรหัสตัวอย่างเช่น คุณเป็นแอปพลิเคชันที่สร้างใบแจ้งหนี้ผ่าน Cryptomus API และลูกค้าของคุณคือร้านค้าอื่นๆ พวกเขาป้อนรหัส API และรหัสร้านค้าในแอปพลิเคชันของคุณ และคุณส่งคำขอพร้อมข้อมูลประจำตัวของพวกเขาและส่งรหัสอ้างอิงของคุณดังนั้นลูกค้าของคุณจะกลายเป็นผู้อ้างอิงจากบัญชี Cryptomus ของคุณ และคุณจะได้รับรายได้จากยอดขายของพวกเขา |
ประเภทพารามิเตอร์
stringคำนิยาม
รหัสสกุลเงินประเภทพารามิเตอร์
stringคำนิยาม
รหัสเครือข่ายบล็อคเชนประเภทพารามิเตอร์
stringmin: 1max: 100alpha_dashคำนิยาม
รหัสคำสั่งซื้อในระบบของคุณพารามิเตอร์ควรเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข เครื่องหมายขีดล่าง และเครื่องหมายขีดกลาง ไม่ควรมีช่องว่างหรืออักขระพิเศษใดๆorder_id จะต้องไม่ซ้ำกันภายในใบแจ้งหนี้ของผู้ค้า/กระเป๋าสตางค์คงที่/การชำระเงินซ้ำเมื่อเราพบใบแจ้งหนี้ที่มีอยู่ซึ่งมี order_id เราจะส่งคืนรายละเอียดของใบแจ้งหนี้ดังกล่าว และจะไม่สร้างใบแจ้งหนี้ใหม่ประเภทพารามิเตอร์
stringmin: 6max: 255urlคำนิยาม
URL ที่เว็บฮุกจะถูกส่งไปหลังจากการเติมเงินในกระเป๋าสตางค์แต่ละครั้งประเภทพารามิเตอร์
stringคำนิยาม
ผู้ค้าที่ทำการร้องขอจะเชื่อมต่อกับผู้อ้างอิงด้วยรหัสตัวอย่างเช่น คุณเป็นแอปพลิเคชันที่สร้างใบแจ้งหนี้ผ่าน Cryptomus API และลูกค้าของคุณคือร้านค้าอื่นๆ
พวกเขาป้อนรหัส API และรหัสร้านค้าในแอปพลิเคชันของคุณ และคุณส่งคำขอพร้อมข้อมูลประจำตัวของพวกเขาและส่งรหัสอ้างอิงของคุณดังนั้นลูกค้าของคุณจะกลายเป็นผู้อ้างอิงจากบัญชี Cryptomus ของคุณ และคุณจะได้รับรายได้จากยอดขายของพวกเขา
* - พารามิเตอร์บังคับ
ขอตัวอย่าง
curl https://api.cryptomus.com/v1/wallet \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"currency": "USDT",
"network": "tron",
"order_id": "1",
"url_callback": "https://your.site/callback"
}'การตอบสนอง
พารามิเตอร์การตอบสนอง
| ชื่อ | คำนิยาม |
|---|---|
| wallet_uuid | uuid ของกระเป๋าเงินของผู้ค้า |
| uuid | uuid ของกระเป๋าสตางค์ในเครือข่ายเฉพาะ |
| address | ที่อยู่กระเป๋าเงินในเครือข่ายเฉพาะ |
| network | รหัสเครือข่ายกระเป๋าสตางค์ |
| currency | สกุลเงินเครือข่ายกระเป๋าเงิน |
| url | ลิงค์ไปยังแบบฟอร์มการชำระเงิน |
คำนิยาม
uuid ของกระเป๋าเงินของผู้ค้าคำนิยาม
uuid ของกระเป๋าสตางค์ในเครือข่ายเฉพาะคำนิยาม
ที่อยู่กระเป๋าเงินในเครือข่ายเฉพาะคำนิยาม
รหัสเครือข่ายกระเป๋าสตางค์คำนิยาม
สกุลเงินเครือข่ายกระเป๋าเงินคำนิยาม
ลิงค์ไปยังแบบฟอร์มการชำระเงิน
ตัวอย่างการตอบกลับ
1{
2 "state": 0,
3 "result": {
4 "wallet_uuid": "de15b0f6-883f-4585-b27b-73a648044a92",
5 "uuid": "87961ae5-80c5-413a-a4fe-d38199894940",
6 "address": "TTEtddVZyNtLD9wbq4PzomjBhtxenSMXbb",
7 "network": "tron",
8 "currency": "USDT",
9 "url": "https://pay.cryptomus.com/wallet/3901446a-4b74-4796-b50a-14e14dafe3ed"
10 }
11}ข้อผิดพลาดที่อาจเกิดขึ้น
ข้อผิดพลาดในการตรวจสอบ
รหัส : 422
ตัวอย่างคำตอบ:
หากจำเป็นต้องมีพารามิเตอร์บางอย่างแต่ไม่ได้ผ่าน:
1{
2 "state": 1,
3 "errors": {
4 "currency": ["validation.required"]
5 }
6}หากการชำระเงินของคุณถูกระงับ ในกรณีนี้ คุณต้องติดต่อฝ่ายสนับสนุน
1{
2 "state": 1,
3 "message": "You are forbidden"
4}
5หากเราไม่พบบริการชำระเงินด้วยสกุลเงินและเครือข่าย:
1{
2 "state": 1,
3 "message": "The service was not found"
4}หากเกิดงานทางเทคนิคและไม่สามารถชำระเงินได้ชั่วคราว คุณอาจได้รับข้อความแสดงข้อผิดพลาดดังต่อไปนี้:
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}
1{
2 "state": 1,
3 "message": "Server error"
4}
1{
2 "state": 1,
3 "message": "Wallet not found"
4}