إنشاء محفظة ثابتة
post
https://api.cryptomus.com/v1/wallet
طلب
معلمات الاستعلام
| اسم | نوع المعلمة | القيمة الافتراضية | تعريف |
|---|---|---|---|
| currency* | string | رمز العملة | |
| network* | string | رمز شبكة blockchain | |
| order_id* | stringmin: 1max: 100alpha_dash | طلب معرف في نظامكيجب أن تكون المعلمة عبارة عن سلسلة تتكون من الأحرف الأبجدية والأرقام والرسومات الساحرة والشرطات. لا ينبغي أن تحتوي على أي مسافات أو أحرف خاصة.يجب أن يكون order_id فريدًا داخل فواتير التاجر/محافظ ثابتة/مدفوعات تكرارعندما نجد فاتورة موجودة مع order_id ، نعيد تفاصيلها ، ولن يتم إنشاء فاتورة جديدة. | |
| url_callback | stringmin: 6max: 255url | null | عنوان URL ، الذي سيتم إرسال webhook بعد كل توب من المحفظة |
| from_referral_code | string | null | التاجر الذي يقوم بتوصيل الطلب يتصل إلى إحالة حسب الرمز.على سبيل المثال ، أنت تطبيق يقوم بإنشاء فواتير عبر واجهة برمجة تطبيقات Cryptomus وعملائك متاجر أخرى. كود الإحالة.وبالتالي ، يصبح عملاؤك إحالات على حساب Cryptomus الخاص بك وسوف تتلقى دخلًا من معدل دورانهم. |
نوع المعلمة
stringتعريف
رمز العملةنوع المعلمة
stringتعريف
رمز شبكة blockchainنوع المعلمة
stringmin: 1max: 100alpha_dashتعريف
طلب معرف في نظامكيجب أن تكون المعلمة عبارة عن سلسلة تتكون من الأحرف الأبجدية والأرقام والرسومات الساحرة والشرطات. لا ينبغي أن تحتوي على أي مسافات أو أحرف خاصة.يجب أن يكون order_id فريدًا داخل فواتير التاجر/محافظ ثابتة/مدفوعات تكرارعندما نجد فاتورة موجودة مع order_id ، نعيد تفاصيلها ، ولن يتم إنشاء فاتورة جديدة.نوع المعلمة
stringmin: 6max: 255urlتعريف
عنوان URL ، الذي سيتم إرسال webhook بعد كل توب من المحفظةنوع المعلمة
stringتعريف
التاجر الذي يقوم بتوصيل الطلب يتصل إلى إحالة حسب الرمز.على سبيل المثال ، أنت تطبيق يقوم بإنشاء فواتير عبر واجهة برمجة تطبيقات Cryptomus وعملائك متاجر أخرى. كود الإحالة.وبالتالي ، يصبح عملاؤك إحالات على حساب 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إذا لم نعثر على خدمة الدفع باستخدام currency و network:
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}