ربط YooKassa (ياندكس كاسا)

ما تحتاجه للربط

• حساب في YooKassa (yookassa.ru)
• صفة رجل أعمال فردي (ИП) أو شركة (ООО/АО) أو عامل حر (لا يمكن للأفراد بدون صفة قانونية استقبال المدفوعات)
• حساب بنكي مربوط بـ YooKassa

YooKassa متاحة على جميع خطط tikento، بما في ذلك Free.

الخطوة 1. التسجيل في YooKassa

انتقل إلى yookassa.ru وأنشئ حساباً. للحصول على إمكانية المدفوعات الحقيقية ستحتاج إلى اجتياز التحقق: تحميل المستندات (لرجل الأعمال الفردي — جواز السفر والشهادة، للشركة — النظام الأساسي وقرار التعيين).

الوضع الاختباري (مدفوعات اختبارية بدون أموال حقيقية) متاح فوراً بعد التسجيل بدون تحقق.

الخطوة 2. إنشاء متجر

في لوحة تحكم YooKassa:

1. انتقل إلى قسم المتاجر.
2. اضغط «إنشاء متجر».
3. املأ البيانات: الاسم، عنوان URL للموقع (أدخل app.tikento.com)، وصف النشاط.
4. في قسم «طريقة الاتصال» اختر إشعارات HTTP (وليس الودجت).
5. احفظ الإعدادات.

الخطوة 3. الحصول على مفاتيح API

في إعدادات المتجر الذي أنشأته:

1. افتح علامة التبويب «مفاتيح API».
2. انسخ shopId — المعرّف الرقمي للمتجر (مثلاً 123456).
3. اضغط «إنشاء مفتاح سري»، أدخل التأكيد. انسخ secretKey بالصيغة test_XXXX... (اختباري) أو live_XXXX... (حقيقي).

المفتاح السري يُعرض مرة واحدة فقط. إذا فقدته — أنشئ واحداً جديداً، وسيصبح القديم غير فعّال.

الخطوة 4. الإعداد في tikento

1. افتح إعدادات مؤسستك في tikento.
2. انتقل إلى قسم المدفوعات ← YooKassa.
3. أدخل shopId وsecretKey.
4. اضغط «التحقق من الاتصال» — سيُجري tikento طلب اختبار إلى API الخاص بـ YooKassa.

عند نجاح التحقق ستظهر حالة خضراء «متصل».

الخطوة 5. إعداد الويب هوك

بعد التحقق الناجح سيعرض tikento عنوان URL للويب هوك لمتجرك (بالصيغة https://app.tikento.com/webhooks/yookassa/{shopId}).

في إعدادات متجر YooKassa:

1. افتح «إشعارات HTTP».
2. أضف عنوان URL للويب هوك.
3. اختر الأحداث للإرسال:
   • payment.succeeded — تم الدفع بنجاح
   • payment.canceled — تم إلغاء الدفع
   • refund.succeeded — تم الاسترداد

الخطوة 6. الاختبار

للاختبار استخدم المفتاح الاختباري (يبدأ بـ test_). بطاقات YooKassa الاختبارية:

تاريخ الانتهاء — أي تاريخ مستقبلي، CVV — أي 3 أرقام.

الخطوة 7. التحويل إلى الوضع الحقيقي

عندما يتم اجتياز الاختبار بنجاح:

1. في YooKassa قدّم طلباً للتحويل إلى الوضع الحقيقي (زر في لوحة تحكم المتجر).
2. حمّل المستندات المطلوبة.
3. بعد الموافقة سترسل YooKassa إشعاراً.
4. استبدل secretKey الاختباري بالحقيقي في إعدادات tikento.

تستغرق الموافقة عادةً 1-3 أيام عمل لرجال الأعمال الأفراد و3-5 أيام للشركات.