دفعة بيتكوين واجهة برمجة التطبيقات

تم تصميم Bitwallet من الألف إلى الياء ليكون نظام الدفع Bitcoin الأكثر سهولة الاستخدام ممكن. لدينا الدفع API بيتكوين هو أول بوابة الدفع بيتكوين مجهول دون KYC / AML

توفر لك بوابة دفع BitWallet طريقة آمنة لقبول Bitcoin كمجهول وتبيع البضائع والخدمات. نحن نوفر واجهة REST قائمة على المعايير والتي تمكن مطوري التطبيقات من التفاعل بطريقة قوية وآمنة مع حساب BitWallet الخاص بهم. باستخدام BitWallet API ، يمكن للعملاء إنشاء وإدارة الفواتير ، وإدارة الفواتير ، واسترداد معلومات الأسعار في الوقت الفعلي ، وعرض إدخالات دفتر الأستاذ التجاري ، وغير ذلك الكثير. يمكن للمطورين الاتصال بواجهة برمجة التطبيقات مباشرة عبر HTTPS باستخدام اللغة التي يختارونها.

يمكن لتجار BitWallet تحديد الأسعار بأي عملة محلية أو بيتكوين. مع حلنا ، يمكن لكل صاحب عمل بدء قبول عملات التشفير كوسيلة للدفع باستخدام واجهة برمجة تطبيقات التجارة الإلكترونية API أو API. توفر بوابتنا أتمتة كاملة لقبول Bitcoin بشكل مجهول ، وعناوين فريدة لكل طلب ، وأسعار صرف شفافة في الوقت الفعلي للعملاء ، ومنصة للتجار لتتبع وإدارة سجل الدفعات والدفعات الخاصة بهم.

نظرة عامة على واجهة برمجة التطبيقات

يجب أن يكون نص الرسالة مشفرًا JSON وأن يتم ضبط نوع المحتوى على التطبيق / json. عند الإنشاء الناجح ، سيتم تقديم تفاصيل الفاتورة في استجابة تشفير JSON.

كل فاتورة صالحة للدفع فقط 15 دقيقة.

ملحوظة: يقتصر التاجر على إنشاء ما لا يزيد عن 50 فاتورة يوميًا كإعداد افتراضي. إذا كنت بحاجة إلى مزيد من الفاتورة ، فيرجى الاتصال بالدعم للزيادة.

ملحوظة: يجب أن يظل مفتاح البوابة وكلمة المرور خاصين ويجب أن يكونا قابلين للوصول فقط من قبل مطور التطبيق / المالك.

المتطلبات

شرط أن يقوم موقعك بتوصيل نظام دفع BitWallet هو فقط تنشيط وظيفة CURL. للتأكد من أن هذه الميزة نشطة ، اتصل بدعم الاستضافة الخاص بك.

الخطوة 1 - إنشاء فاتورة

يتم إنشاء فاتورة عن طريق إرسال رسالة HTTP POST إلى عنوان URL الخاص بـ API مع تفاصيل الفاتورة التي تم تمريرها في نص الطلب.

API URL:
https://bitwallet.zone/service/invoice
حقول POST المطلوبة
وصف اكتب حقل
Gateway key (تسجيل الدخول إلى حسابك والنقر على زر تحرير في صفحة مواقع الويب الخاصة بي) string gateway_key
Password (تسجيل الدخول إلى حسابك والنقر على زر تحرير في صفحة مواقع الويب الخاصة بي) string password

كمية

يجب أن يشتمل المبلغ الذي تم إدخاله على الشرطين التاليين:

في نوع Bitcoin ، لا يقل عن 0.000006 btc.

في نوع العملة ، لا يقل عن 0.10 دولار.

double amount

معاهدات التسعير المدعومة:

btc , usd , eur , gbp , cny , jpy , sgd , hkd , cad , nzd , aud , chf , rub

string type
وصف الفاتورة (اختياري) - الحد الأقصى 50 حرف. string description
يرى العميل زر "العودة إلى متجر البائع" بعد الانتهاء من الدفع. بالنقر على هذا الزر ، يمكنك العثور على عنوان URL لمراجع الاتصال ، كما يجب عليك التحقق من الفاتورة بواسطة واجهة برمجة التطبيقات على عنوان URL هذا. string callbackURL
القيمة: create string action
استجابة:

إذا كانت المعلومات المقدمة صحيحة:

	
// referenceNo = رقم الفاتورة للمتابعة
	
// invoice = رقم الفاتورة لعرض الزبون أو استخدامه في حالات مماثلة
	
// redirectURL = عنوان url للفاتورة


{
  "status": 0,
  "data": {
    "referenceNo": "ZGePPYh8x",
    "invoice": "100017906",
    "redirectURL": "https://bitwallet.zone/invoice/ZGePPYh8x"
  }
}
            

في حالة حدوث خطأ:

{
  "status": 1,
  "data": []
}
            
خطا بالكود وصف
-1 بيانات الطلب غير صحيحة.
1 Gateway_key أو كلمة المرور خاطئة.
2 المبلغ الذي تم إدخاله غير صحيح.
3 العملة المدخلة غير صحيحة.
4 إن callbackURL غير صحيح.
5 خطأ في الخادم.
6 لقد وصلت إلى حد الفواتير اليومية.
7 وصف الفاتورة (أكثر من 50 حرفًا)
الخطوة الثانية - إعادة التوجيه إلى صفحة السداد

إذا كانت المعلومات المرسلة صحيحة في الخطوة السابقة (إنشاء فاتورة) وكنت قد تلقيت قيمة redirectURL من api ، فيجب على المستخدم إعادة توجيه العنوان إلى redirectURL.

الخطوة 3 - العودة بعد السداد الكامل

يرى العميل زر "العودة إلى متجر البائع" بعد الانتهاء من الدفع ، عن طريق النقر على هذا الزر BitWallet إرسال القيم التالية بواسطة POST إلى عنوان المرسل (callbackURL) الذي قمت بإدخاله في الخطوة الأولى.

وصف اكتب حقل
رقم الفاتورة للمتابعة string referenceNo
حالة الفاتورة string status

قيم معلمات الحالة

القيمة وصف
expire تشير هذه الحالة إلى أن الدفعة لم تتم خلال 15 دقيقة.
confirm تشير هذه الحالة إلى أنه تم سداد الفاتورة ، ولكن يلزمك التحقق من تأكيدها على blockchain أو لا.
الخطوة 4 - احصل على تفاصيل الصفقة

باستخدام واجهة برمجة التطبيقات أدناه ، يمكنك تلقي تفاصيل المعاملة في أي وقت. هذه الوظيفة لها حدود لعدد الطلبات لذا من الأفضل استخدامها على صفحة callbackURL وبعد الانتهاء من الخطوة الثالثة استخدمها لضمان حالة حسابك النهائية. بعد تغيير حالة الطلب بأمان على موقعك على الويب وتسليم السلعة أو الخدمة إلى العميل.

API URL :
https://bitwallet.zone/service/invoice
حقول POST المطلوبة
وصف اكتب حقل
Gateway key (تسجيل الدخول إلى حسابك والنقر على زر تحرير في صفحة مواقع الويب الخاصة بي) string gateway_key
Password (تسجيل الدخول إلى حسابك والنقر على زر تحرير في صفحة مواقع الويب الخاصة بي) string password
رقم الفاتورة للمتابعة string referenceNo
القيمة: detail string action
استجابة:

إذا كانت المعلومات المقدمة صحيحة:

	
// invoice = رقم الفاتورة لعرض الزبون أو استخدامه في حالات مماثلة
// btc = فقط لمعرفتك أو استخدامها في بعض الحالات
// rial = فقط لمعرفتك أو استخدامها في بعض الحالات
// usd = فقط لمعرفتك أو استخدامها في بعض الحالات

{
  "status": 0,
  "data": {
    "invoice": "100017906",
    "btc": "0.00001326",
    "rial": "0",
    "usd": "0.10",
    "status": "confirm"
  }
}

قيم معلمات الحالة

القيمة وصف
wait يتم استخدام هذه الحالة للمدفوعات المنشأة حديثًا.
pay تشير هذه الحالة إلى أنه تم دفع الفاتورة ، ولكن لم يتم تأكيد الدفع بعد على blockchain. ملاحظة: لحالة الدفع المؤكدة النهائية ، انظر: confirm.
expire تشير هذه الحالة إلى أن الدفعة لم تتم خلال 15 دقيقة.
confirm تشير هذه الحالة إلى أن الفاتورة تم دفعها بالكامل وتأكيدها على blockchain.

في حالة حدوث خطأ:

{
  "status": 1,
  "data": []
}
            
خطا بالكود وصف
-1 بيانات الطلب غير صحيحة.
1 Gateway_key أو كلمة المرور خاطئة.
2 لم يتم العثور على الفاتورة.

نحن نحافظ على بياناتك آمنة ومأمونة

قم بإنشاء حسابك الآن واستمتع بالخصوصية والحرية!

سجل في 10 ثوان