كيف أربط موقعي أو البوت عبر الـ API؟

استخدم الـ API إذا أردت أن تُدفع الطلبات وتُسلَّم تلقائياً. خادمك ينشئ فاتورة، يحوّل العميل إلى صفحة الدفع، ويستلم Webhook موقّعاً عند وصول الدفعة.

1. احصل على المفاتيح

افتح مشروعك ثم تبويب المطورين. تحصل على مفتاح حقيقي للدفعات الحقيقية ومفتاح تجريبي للاختبار.

2. أضف الـ Webhook

1. أدخل الرابط على موقعك أو خادم البوت الذي سيستقبل الأحداث، واضغط حفظ.
2. انسخ سر التوقيع واحفظه على خادمك.
3. اضغط إرسال حدث تجريبي وتأكد أن خادمك يردّ بالحالة 200.

3. أنشئ الفواتير

أرسل طلب إنشاء فاتورة بالمبلغ ورقم طلبك، ثم حوّل العميل إلى رابط الدفع الذي يصلك. عند وصول الحدث invoice.paid سلّم الطلب.

العناوين الثابتة

لشحن الرصيد في البوتات يمكنك إعطاء كل عميل عنوان إيداع دائماً. كل إيداع يرسل الحدث deposit.received.

أمثلة الطلبات الكاملة بلغات PHP وNode.js وPython موجودة في توثيق الـ API.