التحصيل بالبطاقة عبر Stripe في متجرك

يصلح Stripe لمتاجر يلا سوق التي عملتها اليورو أو الدولار الأمريكي أو الجنيه الإسترليني أو الدولار الكندي أو الفرنك السويسري، بحساب Stripe تفتحه شركة مسجّلة في بلد يدعمه Stripe (وتونس ليست منها). أنشئ مفتاحًا مقيّدًا بصلاحيتين، الصقه في التكاملات › الدفع › Stripe، ثم فعّل الدفع بالبطاقة.

تم التحقق من طريقة العمل في المنتج والاطلاع على توثيق Stripe في 22 أكتوبر 2026.

Stripe في يلا سوق باختصار

من يمكنه استعمال Stripe مع يلا سوق؟

شرطان، واحد لدى Stripe وآخر لدى يلا سوق. لدى Stripe، يجب أن يعود الحساب لشركة مسجّلة في بلد يتوفّر فيه Stripe: القائمة التي ينشرها Stripe لا تتضمّن تونس، فلا يمكن لشركة تونسية فتح حساب Stripe. ولدى يلا سوق، يجب أن تكون عملة المتجر من العملات التي يحصّلها الربط: اليورو، الدولار الأمريكي، الجنيه الإسترليني، الدولار الكندي أو الفرنك السويسري.

الحالة المعتادة: علامة لديها شركة في فرنسا أو كندا أو المملكة المتحدة وتبيع عبر يلا سوق بتلك العملة. أما المتجر بالدينار، فالدفع الإلكتروني يمرّ عبر Flouci. وإذا كانت عملة متجرك غير مدعومة، تظهر بطاقة Stripe معطّلة مع السبب.

كيف أنشئ المفتاح المقيّد في Stripe؟

1. في لوحة تحكم Stripe، في الوضع الحقيقي (live)، افتح صفحة API keys.
2. أنشئ مفتاحًا مقيّدًا (restricted key) ليلا سوق.
3. امنحه صلاحيتين فقط: Checkout Sessions: Write وWebhook Endpoints: Write.
4. انسخ المفتاح الذي يبدأ بـ rk_live_. لا يعرضه Stripe مجددًا بعد مغادرة الصفحة: انسخه فورًا.

لماذا مفتاح مقيّد لا المفتاح السري؟ ينصح Stripe نفسه بالمفاتيح المقيّدة التي تحدّ من صلاحياتها، بدل المفتاح السري الذي يفتح الواجهة كلها. ولهذا يرفض يلا سوق مفاتيح sk_.

كيف أربط Stripe بيلا سوق؟

1. افتح التكاملات، فئة الدفع، وانقر على ربط على بطاقة Stripe.
2. الصق المفتاح المقيّد وأكّد.
3. يتحقق يلا سوق من المفتاح ويُنشئ بنفسه، في حسابك على Stripe، نقطة الـ webhook التي تُعلمه بالمدفوعات. تظهر في Stripe باسم «Yalla Souk order payments».
4. عندما تصبح الحالة «متصل»، فعّل قبول الدفع بالبطاقة عبر Stripe في متجري.

رسائل الخطأ تقول ما يجب إصلاحه: مفتاح سري بدل المقيّد، مفتاح محذوف أو منسوخ بشكل خاطئ، صلاحية ناقصة، أو حساب Stripe لا يستطيع التحصيل بعملة المتجر.

كيف يتمّ الدفع عبر Stripe؟

1. عند إتمام الطلب، يختار الحريف الدفع بالبطاقة ويؤكّد طلبيته.
2. يُوجَّه إلى صفحة الدفع التي يستضيفها Stripe (Stripe Checkout)، بعملة متجرك، فيُدخل بطاقته أو يستعمل محفظة يقترحها حسابك في Stripe.
3. تبقى جلسة الدفع مفتوحة 30 دقيقة على الأقل و24 ساعة على الأكثر، في حدود مدة صلاحية الطلبية.
4. يؤكّد Stripe الدفع ليلا سوق عبر الـ webhook؛ وتُعلَّم الطلبية كمدفوعة تلقائيًا.
5. تصل الأموال إلى حسابك في Stripe، ثم إلى حسابك البنكي حسب جدول التحويلات في Stripe.

ما هي الحدود والمسؤوليات؟

• الاسترجاع والنزاعات: تُدار من لوحة تحكمك في Stripe. لا يعالج يلا سوق الاسترجاع ولا النزاعات ولا عمليات الاسترداد البنكي.
• الحدّ الأدنى للمبلغ: إذا كان المجموع أقل من الحدّ الأدنى الذي يقبله Stripe لتلك العملة، لا يمكن دفع هذه الطلبية بالبطاقة؛ أما الربط فيبقى صالحًا.
• فصل الربط: فصل Stripe يحذف مفتاحك من يلا سوق ويزيل الـ webhook الذي أُنشئ في حسابك.
• الدفع نقدًا: يبقى الدفع عند الاستلام أو السحب متاحًا ما لم توقفه.

أسئلة شائعة حول Stripe ويلا سوق