التوثيق

اعداد المدفوعات مع Tap

دليل تفصيلي لاعداد بوابة الدفع Tap Payments في متجرك

في هذا الدليل، ستتعلم كيفية اعداد Tap Payments لقبول الدفع الالكتروني (مدى، فيزا، ماستركارد، Apple Pay).

المتطلبات

  • متجر مُلكم فعّال
  • سجل تجاري ساري المفعول
  • حساب بنكي تجاري

الخطوة 1: انشاء حساب Tap

  1. اذهب الى tap.company
  2. اضغط "سجّل كتاجر"
  3. ادخل بياناتك:
    • اسم المنشأة
    • رقم السجل التجاري
    • البريد الالكتروني
    • رقم الجوال
  4. ارفع المستندات المطلوبة:
    • صورة السجل التجاري
    • صورة الهوية / الاقامة
    • بيانات الحساب البنكي (IBAN)
  5. انتظر مراجعة Tap (1-3 ايام عمل)

الخطوة 2: الحصول على مفاتيح API

بعد تفعيل حسابك في Tap:

  1. سجّل الدخول في goSell Dashboard
  2. اذهب الى Developers ثم API Keys
  3. انسخ:
    • Public Key (يبدأ بـ pk_live_)
    • Secret Key (يبدأ بـ sk_live_)

تحذير: لا تشارك Secret Key ابدًا ولا تضعه في كود الواجهة الامامية.

الخطوة 3: ربط Tap بمُلكم

  1. في مُلكم، اذهب الى الاعدادات ثم المدفوعات
  2. فعّل Tap Payments
  3. الصق Public Key و Secret Key
  4. اضغط "اختبار الاتصال"
  5. يجب ان يظهر "الاتصال ناجح"

الخطوة 4: تفعيل طرق الدفع

بعد ربط Tap، فعّل الطرق المطلوبة:

  • مدى -- تُفعّل تلقائيًا
  • فيزا -- تُفعّل تلقائيًا
  • ماستركارد -- تُفعّل تلقائيًا
  • Apple Pay -- يحتاج طلب تفعيل من Tap
  • الدفع عند الاستلام -- لا يحتاج Tap

الخطوة 5: اعداد عملة الدفع

  1. في اعدادات المدفوعات، اختر العملة الرئيسية
  2. الافتراضي: الريال السعودي (SAR)
  3. يمكنك اضافة عملات اخرى (AED، KWD)

الخطوة 6: اختبار الدفع

  1. انشئ طلب تجريبي في متجرك
  2. اختر الدفع ببطاقة
  3. استخدم بطاقة Tap التجريبية:
    • الرقم: 4508 7500 1527 4455
    • الصلاحية: اي تاريخ مستقبلي
    • CVV: 100
  4. أكّد الدفع
  5. تحقق من ظهور الطلب كـ "مدفوع"

الخطوة 7: اعداد التسويات

التسويات هي تحويل الاموال من Tap لحسابك البنكي:

  • الدورة الافتراضية: اسبوعية
  • يمكنك طلب تسوية يومية من Tap
  • تصل المبالغ خلال 1-2 يوم عمل

استكشاف الاخطاء

المشكلةالحل
"Invalid API Key"تأكد من نسخ المفتاح كاملاً بدون مسافات
الدفع يفشل دائمًاتأكد من استخدام مفاتيح Live (وليس Test)
لا تظهر مدىتواصل مع Tap لتفعيل مدى
Apple Pay لا يظهريحتاج تفعيل منفصل من Tap