Docs

اعداد Tap Payments

تفعيل بوابة الدفع Tap في متجرك لقبول المدفوعات الالكترونية

Tap Payments هي بوابة الدفع الرئيسية في مُلكم. تدعم مدى، فيزا، ماستركارد، وApple Pay.

المتطلبات

  • حساب تاجر في Tap Payments
  • مفاتيح API (Secret Key + Publishable Key)

خطوات التفعيل

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

  1. سجّل الدخول الى لوحة تحكم Tap
  2. اذهب الى Developers ثم API Keys
  3. انسخ:
    • Secret Key (يبدأ بـ sk_live_)
    • Publishable Key (يبدأ بـ pk_live_)

تحذير: لا تشارك الـ Secret Key مع اي شخص. استخدم مفاتيح sk_test_ للتجربة فقط.

2. اضافة المفاتيح في مُلكم

  1. اذهب الى الاعدادات ثم المدفوعات
  2. فعّل Tap Payments
  3. ادخل Secret Key و Publishable Key
  4. اضغط "حفظ"
  5. اضغط "اختبار الاتصال" للتأكد

3. تفعيل طرق الدفع

بعد ربط Tap، يمكنك تفعيل:

الطريقةالوصف
مدىبطاقات مدى السعودية
فيزابطاقات Visa العالمية
ماستركاردبطاقات Mastercard
Apple Payالدفع عبر Apple Pay
الدفع عند الاستلامCOD (لا يحتاج Tap)

اختبار الدفع

قبل الاطلاق، اختبر عملية الدفع:

  1. استخدم مفاتيح Test (sk_test_...)
  2. استخدم بطاقة الاختبار:
    • رقم البطاقة: 5123450000000008
    • تاريخ الانتهاء: اي تاريخ مستقبلي
    • CVV: 100
  3. اجرِ عملية شراء تجريبية
  4. تأكد من وصول Webhook بنجاح

Webhooks

مُلكم تستقبل اشعارات الدفع تلقائيًا عبر Webhook. تأكد من ان الـ Webhook URL مضبوط في لوحة Tap:

https://[PROJECT_REF].supabase.co/functions/v1/tap-webhook

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

المشكلةالحل
فشل الاتصالتأكد من صحة الـ Secret Key
الدفع مرفوضتأكد من تفعيل الحساب في Tap
لم يصل Webhookتحقق من URL الـ Webhook في Tap
Apple Pay لا يعمليحتاج شهادة خاصة من Tap

On this page