ادمج المدفوعات
في تطبيقاتك.
حزم SDK مفتوحة المصدر لأجهزة الدفع، وحلول عبر الإنترنت: روابط دفع وواجهة API وإضافات للتجارة الإلكترونية.
حزم SDK لجهاز الدفع
حزم SDK مفتوحة المصدر لتشغيل جهاز الدفع من نظام الكاشير، على جميع المنصات.
محاكي الجهاز
طوّر واختبر دون جهاز دفع فعلي: يحاكي هذا البرنامج جهاز الدفع على حاسوبك.
المميزات
SDK حديث ومتكامل لدمج المدفوعات عبر الشبكة البنكية الوطنية.
TypeScript
تعريفات أنواع كاملة لتجربة مطور أفضل وأخطاء أقل.
PCI-DSS
إخفاء تلقائي لأرقام البطاقات (أول 6 + آخر 4 أرقام).
الإيصالات
تحليل وتنسيق إيصالات التاجر والعميل مع علامة TKpay.
Async/Await
واجهة برمجة حديثة قائمة على Promises لكود نظيف وقابل للقراءة.
سهل التكامل
بضعة أسطر من الكود كافية لقبول المدفوعات.
- ثبّت الحزمة عبر npm أو yarn
- اضبط عنوان IP ومنفذ الجهاز
- عالج المدفوعات باستخدام processPayment()
import {
NapsPayClient,
type PaymentResult,
NapsError,
} from 'react-native-tkpay-naps';
const client = new NapsPayClient({
host: '192.168.24.214',
});
const handlePayment = async () => {
try {
const paymentResult = await client.processPayment({
amount: 100.00,
registerId: '01',
cashierId: '00001',
});
if (paymentResult.success) {
Alert.alert('Success', `Payment approved!`);
} else {
Alert.alert('Failed', paymentResult.error);
}
} catch (error) {
if (error instanceof NapsError) {
Alert.alert('Error', error.message);
}
}
};استقبل مدفوعاتك عبر الإنترنت أيضاً
روابط دفع دون برمجة، وواجهة API لمواقعك وتطبيقاتك، وإضافات للتجارة الإلكترونية قريباً.
روابط الدفع ورمز QR
أنشئ رابطاً من لوحة التحكم وأرسله عبر واتساب أو SMS أو البريد الإلكتروني — دون أي تطوير.
اكتشفإضافات التجارة الإلكترونية
WooCommerce وPrestaShop وPHP وNode.js: إضافات جاهزة للتثبيت لمتجرك.
أبلغني عند التوفرأسئلة شائعة
اعثر على إجابات للأسئلة الأكثر شيوعاً حول دمج مدفوعات TKpay في تطبيقاتك.
ما هي المتطلبات الأساسية لدمج SDK الخاص بـ TKpay؟
لدمج SDK الخاص بـ TKpay، تحتاج إلى جهاز دفع TKpay متصل بالشبكة البنكية الوطنية، وبيئة تطوير React Native (أو تطوير أصلي Android/iOS قريباً)، واتصال شبكة محلية بين تطبيقك والجهاز. الحزمة متاحة عبر npm وتُثبّت بأمر واحد. وثائقنا الشاملة على GitHub ترشدك خطوة بخطوة في الإعداد الأولي.
كيف تعمل الـ webhooks والإشعارات الفورية؟
يستخدم SDK الخاص بـ TKpay بنية غير متزامنة قائمة على Promises والـ callbacks. عند معالجة دفعة، يستقبل تطبيقك النتيجة فوراً عبر REST API، بما في ذلك رمز التفويض وحالة المعاملة وبيانات الإيصال. يمكنك تهيئة webhooks من جانب الخادم لاستقبال إشعارات فورية حول حالة المدفوعات ومزامنة لوحة التحكم تلقائياً.
هل الـ SDK متوافق مع نظام الصندوق الحالي؟
نعم، SDK الخاص بـ TKpay مصمم للتكامل بسهولة مع أي نظام صندوق أو تطبيق أعمال. واجهة REST API لا تعتمد على منصة محددة: يمكنك استدعاؤها من أي لغة برمجة (JavaScript، Python، PHP، إلخ). لتطبيقات الموبايل، يوفر SDK الخاص بـ React Native تكاملاً أصلياً. حزم SDK لـ Android (Kotlin) و iOS (Swift) ستكون متاحة قريباً للتطوير الأصلي.