ربط Tochka Bank

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

• حساب جاري في Tochka Bank (tochka.com)
• صفة رائد أعمال فردي أو شركة أو عامل لحسابه الخاص (الأفراد بدون صفة لا يمكنهم قبول المدفوعات)
• تحصيل عبر الإنترنت مفعّل في لوحة تحكم Tochka

Tochka متاح على جميع خطط tikento بما فيها Free.

الخطوة 1. حساب جاري في Tochka

إذا لم يكن لديك حساب في Tochka، افتحه على tochka.com. ستحتاج:

• لرائد أعمال فردي: جواز السفر، رقم الضريبة، رقم السجل
• لشركة: النظام الأساسي، أمر تعيين المدير، رقم ضريبة الشركة
• للعامل لحسابه الخاص: جواز السفر، شهادة التسجيل كعامل لحسابه الخاص

فتح الحساب عادة يستغرق يوم عمل واحد.

الخطوة 2. تفعيل التحصيل عبر الإنترنت

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

1. انتقل إلى قسم «التحصيل» ← «التحصيل عبر الإنترنت».
2. اضغط «تقديم طلب».
3. حدد عنوان الموقع: app.tikento.com.
4. صِف النشاط: «بيع التذاكر والتسجيل في الفعاليات».
5. انتظر الموافقة (عادة 1-2 يوم عمل).

بعد الموافقة ستتوفر مفاتيح API للتكامل.

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

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

1. افتح «التكامل» ← «API».
2. انسخ merchantId — معرف المرچنت.
3. اضغط «إنشاء مفتاح» وانسخ apiKey.

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

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

1. افتح إعدادات مؤسستك في tikento.
2. انتقل إلى قسم المدفوعات ← Tochka.
3. أدخل merchantId وapiKey.
4. اضغط «التحقق من الاتصال».

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

طرق الدفع المتاحة

بعد ربط Tochka تصبح متاحة تلقائياً:

• البطاقات المصرفية — Visa، Mastercard، MIR
• SBP — الدفع عبر تطبيق البنك برمز QR أو رابط
• Apple Pay / Google Pay — إذا كانت مضبوطة من جانب Tochka

فعّل أو عطّل كل طريقة بالمفاتيح في قسم المدفوعات ← Tochka ← الطرق.

الخطوة 5. إعداد webhook

بعد التحقق الناجح سيعرض tikento عنوان webhook URL بالشكل:

https://app.tikento.com/webhooks/tochka/{merchantId}

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

1. افتح «التكامل» ← «الإشعارات» (أو «Webhooks»).
2. أضف webhook URL من tikento.
3. اختر الأحداث للإشعار:
   • payment.success — دفع ناجح
   • payment.fail — دفع غير ناجح
   • refund.success — استرداد ناجح

بدون webhook مضبوط لن يتمكن tikento من تحديث حالات المدفوعات تلقائياً.

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

يوفر Tochka وضعاً تجريبياً. للتحقق:

1. تأكد من تفعيل الوضع التجريبي في إعدادات Tochka.
2. أنشئ فعالية تجريبية في tikento بتذكرة مدفوعة.
3. افتح نموذج التسجيل واختر الدفع بالبطاقة.
4. استخدم البطاقة التجريبية: 4111 1111 1111 1111 (التاريخ — أي مستقبلي، CVV — أي 3 أرقام).
5. بعد الدفع تحقق من تحديث حالة المشارك في tikento إلى «مدفوع».

إذا لم يصل webhook — تحقق من عنوان URL وفلاتر الأحداث في إعدادات Tochka. لمزيد من التفاصيل عن التشخيص — Webhook لم يصل: التشخيص.

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

عند اكتمال الاختبار:

1. في لوحة تحكم Tochka بدّل التحصيل عبر الإنترنت إلى الوضع الفعلي.
2. استبدل apiKey التجريبي بالفعلي في إعدادات tikento (الإعدادات ← المدفوعات ← Tochka).
3. اضغط «التحقق من الاتصال» مرة أخرى.

بعد ذلك سيبدأ tikento بقبول المدفوعات الحقيقية عبر Tochka.

العمولات

لا يضيف tikento هامشاً على عمولة التحصيل — تمر pass-through من البنك. تدفع:

• عمولة Tochka للتحصيل (السعر يعتمد على تعرفتك في البنك، عادة ~2-2.5%)
• عمولة tikento من كل تذكرة مدفوعة — تعتمد على خطتك

لمزيد من التفاصيل — العمولات والحسابات.