انتقل إلى المحتوى الرئيسي
TKpayTKpay
SDK والتكاملات

ادمج المدفوعات
في تطبيقاتك.

يتيح لك SDK الخاص بنا لـ React Native قبول مدفوعات البطاقات مباشرة من تطبيقاتك المحمولة بأمان تام.

عرض على GitHubتواصل معنا
API

حزم SDK الخاصة بنا

اختر SDK المناسب لمنصة التطوير الخاصة بك.

متاح

React Native

SDK متعدد المنصات لـ iOS و Android بقاعدة كود واحدة.

GitHub
قريباً

Android

SDK أصلي بـ Kotlin لتطبيقات Android.

قريباً

iOS

SDK أصلي بـ Swift لتطبيقات iPhone و iPad.

المميزات

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

TypeScript

تعريفات أنواع كاملة لتجربة مطور أفضل وأخطاء أقل.

PCI-DSS

إخفاء تلقائي لأرقام البطاقات (أول 6 + آخر 4 أرقام).

الإيصالات

تحليل وتنسيق إيصالات التاجر والعميل مع علامة TKpay.

Async/Await

واجهة برمجة حديثة قائمة على Promises لكود نظيف وقابل للقراءة.

سهل التكامل

بضعة أسطر من الكود كافية لقبول المدفوعات.

  • ثبّت الحزمة عبر npm أو yarn
  • اضبط عنوان IP ومنفذ الجهاز
  • عالج المدفوعات باستخدام processPayment()
عرض التوثيق
PaymentScreen.tsx
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);
    }
  }
};

أسئلة شائعة

اعثر على إجابات للأسئلة الأكثر شيوعاً حول دمج مدفوعات 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) ستكون متاحة قريباً للتطوير الأصلي.

مستعد للتكامل؟

ابدأ بقبول المدفوعات في تطبيقك اليوم.

عرض على GitHubتواصل معنا