إنشاء محفظة ثابتة

post
https://api.cryptomus.com/v1/wallet
ينسخ

طلب

معلمات الاستعلام

اسمنوع المعلمةالقيمة الافتراضيةتعريف
currency*stringرمز العملة
network*stringرمز شبكة blockchain
order_id*stringmin: 1max: 100alpha_dashطلب معرف في نظامكيجب أن تكون المعلمة عبارة عن سلسلة تتكون من الأحرف الأبجدية والأرقام والرسومات الساحرة والشرطات. لا ينبغي أن تحتوي على أي مسافات أو أحرف خاصة.يجب أن يكون order_id فريدًا داخل فواتير التاجر/محافظ ثابتة/مدفوعات تكرارعندما نجد فاتورة موجودة مع order_id ، نعيد تفاصيلها ، ولن يتم إنشاء فاتورة جديدة.
url_callbackstringmin: 6max: 255urlnullعنوان URL ، الذي سيتم إرسال webhook بعد كل توب من المحفظة
from_referral_codestringnullالتاجر الذي يقوم بتوصيل الطلب يتصل إلى إحالة حسب الرمز.على سبيل المثال ، أنت تطبيق يقوم بإنشاء فواتير عبر واجهة برمجة تطبيقات 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_uuiduuid من محفظة التاجر
uuiduuid من المحفظة في شبكة معينة
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}
ينسخ