اعداد Tap Payments
تفعيل بوابة الدفع Tap في متجرك لقبول المدفوعات الالكترونية
Tap Payments هي بوابة الدفع الرئيسية في مُلكم. تدعم مدى، فيزا، ماستركارد، وApple Pay.
المتطلبات
- حساب تاجر في Tap Payments
- مفاتيح API (Secret Key + Publishable Key)
خطوات التفعيل
1. الحصول على مفاتيح API
- سجّل الدخول الى لوحة تحكم Tap
- اذهب الى Developers ثم API Keys
- انسخ:
- Secret Key (يبدأ بـ
sk_live_) - Publishable Key (يبدأ بـ
pk_live_)
- Secret Key (يبدأ بـ
تحذير: لا تشارك الـ Secret Key مع اي شخص. استخدم مفاتيح
sk_test_للتجربة فقط.
2. اضافة المفاتيح في مُلكم
- اذهب الى الاعدادات ثم المدفوعات
- فعّل Tap Payments
- ادخل Secret Key و Publishable Key
- اضغط "حفظ"
- اضغط "اختبار الاتصال" للتأكد
3. تفعيل طرق الدفع
بعد ربط Tap، يمكنك تفعيل:
| الطريقة | الوصف |
|---|---|
| مدى | بطاقات مدى السعودية |
| فيزا | بطاقات Visa العالمية |
| ماستركارد | بطاقات Mastercard |
| Apple Pay | الدفع عبر Apple Pay |
| الدفع عند الاستلام | COD (لا يحتاج Tap) |
اختبار الدفع
قبل الاطلاق، اختبر عملية الدفع:
- استخدم مفاتيح Test (
sk_test_...) - استخدم بطاقة الاختبار:
- رقم البطاقة:
5123450000000008 - تاريخ الانتهاء: اي تاريخ مستقبلي
- CVV:
100
- رقم البطاقة:
- اجرِ عملية شراء تجريبية
- تأكد من وصول Webhook بنجاح
Webhooks
مُلكم تستقبل اشعارات الدفع تلقائيًا عبر Webhook. تأكد من ان الـ Webhook URL مضبوط في لوحة Tap:
استكشاف الاخطاء
| المشكلة | الحل |
|---|---|
| فشل الاتصال | تأكد من صحة الـ Secret Key |
| الدفع مرفوض | تأكد من تفعيل الحساب في Tap |
| لم يصل Webhook | تحقق من URL الـ Webhook في Tap |
| Apple Pay لا يعمل | يحتاج شهادة خاصة من Tap |