مكتبات الربط البرمجي (SDKs)
المكتبات الرسمية لربط بوابات دفع SofizPay والبطاقات البنكية CIB والذهبية والخدمات الرقمية في تطبيقاتك.
الحزم الرسمية
5 بيئات برمجية مدعومةJavaScript / TypeScript
v1.3.0لتطبيقات Node.js و Next.js و React والمتصفحات.
Node.jsReactNext.jsBrowser
npm i sofizpay-js-sdk
عرض التوثيق
Python
v1.1.0حزمة غير متزامنة مع دعم الأنواع لـ FastAPI و Django و Flask.
FastAPIDjangoFlaskAsyncIO
pip install sofizpay-python-sdk
عرض التوثيق
PHP
v1.1.0حزمة Composer لتطبيقات Laravel ومواقع PHP الحديثة.
LaravelWooCommercePHP 8+
composer require sofizpay/sofizpay-php-sdk
عرض التوثيق
Dart / Flutter
v1.2.0حزمة Flutter لتطبيقات الهواتف الذكية (Android و iOS) والويب.
FlutteriOSAndroidWeb
flutter pub add sofizpay_dart_sdk
عرض التوثيق
Java / Kotlin
v1.1.0لخدمات Spring Boot وتطبيقات أندرويد.
Spring BootAndroidMavenJitPack
com.github.SofizPay:sofizpay-java-sdk:v1.1.0
عرض التوثيق
بيئة المحاكاة (CIB Sandbox)
اختبر دورة دفع CIB والذهبية ببطاقات فحص تجريبية ورمز OTP موحد قبل إطلاق الإنتاج.
إشعارات الـ Webhooks الموقعة
استقبل إشعارات المعاملات اللحظية وتحقق من التوقيع الرقمي RSA SHA-256 برمجيًا.
دليل الدوال المشتركة
تعتمد جميع حزم الـ SDK نفس أسماء الدوال المشتركة بنمط camelCase (للغات JS و PHP و Dart و Java) ونمط snake_case (لـ Python).
| الوظيفة | JS / Dart / Java / PHP (camelCase) | Python (snake_case) | الاسم البديل للتوافق (Alias) |
|---|---|---|---|
| جلب إصدار الحزمة | getVersion() | get_version() | — |
| استخراج المفتاح العام من المفتاح السري | getPublicKey(secretKey) | get_public_key(secret_key) | getPublicKeyFromSecret() |
| الاستعلام عن رصيد DZT | getBalance(publicKey) | get_balance(public_key) | getDzdBalance() (PHP) |
| إرسال دفعة مالية DZT على ستيلار | submit(paymentData) | submit(payment_data) | sendPayment() / send_payment() |
| جلب سجل العمليات والمعاملات الشامل | getTransactions(publicKey, limit) | get_transactions(public_key, limit) | getPaymentHistory() / get_all_transactions() |
| البحث عن المعاملات بواسطة Memo | searchTransactionsByMemo(key, memo, limit) | search_transactions_by_memo(...) | getTransactionsByMemo() |
| فحص المعاملة على البلوكشين بالـ Hash | getTransactionByHash(hash) | get_transaction_by_hash(hash) | — |
| بدء الاستماع اللحظي للمعاملات | startTransactionStream(key, callback, ...) | start_transaction_stream(...) | setupTransactionStream() |
| إيقاف الاستماع المباشر للمعاملات | stopTransactionStream(keyOrId) | stop_transaction_stream(key_or_id) | — |
| التحقق من حالة اتصال الـ Stream | getStreamStatus(keyOrId) | get_stream_status(key_or_id) | — |
| إنشاء معاملة CIB حقيقية (Production) | makeCIBTransaction(data) | make_cib_transaction(data) | Supports is_sandbox flag |
| إنشاء معاملة تجريبية في بيئة المحاكاة (Sandbox) | makeSandboxCIBTransaction(data) | make_sandbox_cib_transaction(data) | Dedicated simulation gateway |
| التحقق من حالة معاملة CIB في الإنتاج | checkCIBStatus(cibTxId, isSandbox?) | check_cib_status(cib_tx_id, is_sandbox?) | Uses cib_transaction_id |
| التحقق من حالة معاملة CIB في الساندبوكس | checkSandboxCIBStatus(cibTxId) | check_sandbox_cib_status(cib_tx_id) | Dedicated sandbox check |
| التحقق التلقائي من توقيع حمولة الـ Webhook | verifyWebhookSignature(payload) | verify_webhook_signature(payload) | Verifies cib.payment.updated |
| التحقق من توقيع رقمي خام (RSA SHA-256) | verifySignature(message, signature) | verify_signature(message, signature) | verify_sofizpay_signature() |
| جلب قائمة المنتجات والأسعار المتاحة | getProducts(encryptedKey?) | get_products(encrypted_sk?) | — |
| شحن رصيد الهاتف (Mobilis, Djezzy, Ooredoo) | rechargePhone(data) | recharge_phone(data) | Requires encrypted_sk |
| شحن اشتراكات الإنترنت (Idoom 4G / ADSL) | rechargeInternet(data) | recharge_internet(data) | Requires encrypted_sk |
| شحن رصيد وبطاقات الألعاب (FreeFire, PUBG) | rechargeGame(data) | recharge_game(data) | Requires encrypted_sk |
| دفع فواتير الكهرباء والغاز والمياه (Sonelgaz, ADE) | payBill(data) | pay_bill(data) | Requires encrypted_sk |
| جلب سجل العمليات الرقمية السابقة | getOperationHistory(key, limit, offset) | get_operation_history(key, limit, offset) | — |
| جلب تفاصيل عملية رقمية محددة | getOperationDetails(id, key) | get_operation_details(id, key) | — |