اتصال Stripe

پذیرش پرداخت‌های آنلاین از طریق Stripe: کارت‌ها، Apple Pay، Google Pay.

۱. مرور کلی#

Stripe یک پلتفرم پرداخت جهانی است. در فهرست Cenaly، Stripe در ۴۶ کشور قابل اتصال است. یکپارچه‌سازی Cenaly + Stripe امکان موارد زیر را می‌دهد:

• 💳 پذیرش پرداخت با کارت‌ها (Visa، Mastercard، AmEx)
• 📱 Apple Pay / Google Pay — پرداخت با یک لمس
• 💰 دریافت واریزها به حساب بانکی شما
• 🔄 پردازش بازگشت وجه از پنل مدیریت
• 💵 انعام — مهمان هنگام پرداخت انعام اضافه می‌کند
• 📊 گزارش‌ها — تحلیل مالی کامل

۲. پیش‌نیازها#

• ✅ حساب Cenaly (پرداخت آنلاین در هر طرحی، از جمله طرح رایگان، در دسترس است)
• ✅ حساب Stripe (ثبت‌نام رایگان در stripe.com)
• ✅ حساب بانکی برای دریافت واریزها (به ارز کشور شما)
• ✅ مدارک برای احراز هویت (گذرنامه / کارت شناسایی، مدارک شرکت)

کشورهای پشتیبانی‌شده#

Stripe در ۴۶ کشور برای اتصال ارائه می‌شود:

۳. ساخت حساب Stripe#

گام ۱. ثبت‌نام#

1. به stripe.com بروید → Start now
2. ایمیل را وارد کنید و رمز عبور بسازید
3. ایمیل را تأیید کنید

گام ۲. احراز هویت کسب‌وکار#

Stripe موارد زیر را درخواست می‌کند:

احراز هویت معمولاً ۱ تا ۳ روز کاری طول می‌کشد.

گام ۳. دریافت کلیدهای API#

1. در داشبورد Stripe: Developers → API keys
2. کپی کنید:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

۴. اتصال به Cenaly#

حساب Stripe خودتان متصل می‌شود: پول مهمان مستقیماً به موجودی Stripe شما می‌رود و Cenaly آن را نگه نمی‌دارد.

فروشگاه برنامه‌ها → دستهٔ «مالی» → کارت Stripe → «تنظیم» را باز کنید — بلوک اتصال به‌صورت مودال مستقیماً در فروشگاه باز می‌شود. مسیر همیشگی هم کار می‌کند: شعبه‌ها → کارت شعبه → زبانهٔ «پرداخت‌ها» (بخش «پرداخت مهمان»)، دکمهٔ «اتصال» روی کارت Stripe.

جادوگر اتصال (توصیه‌شده)#

جادوگر گام‌به‌گام (حدود ۱۰ دقیقه) شما را در کل فرایند همراهی می‌کند و نشان می‌دهد در داشبورد Stripe کجا را بزنید:

1. حالت را انتخاب کنید — آزمایشی یا عملیاتی. حالت در Stripe و کلید «آزمایشی / عملیاتی» در Cenaly باید یکسان باشند.
2. کلیدها را کپی کنید — Developers → API keys: Secret key (sk_test_… / sk_live_…) الزامی است، Publishable key (pk_…) اختیاری است.
3. وب‌هوک اضافه کنید — Developers → Webhooks → Add endpoint، و در فیلد Endpoint URL نشانی وب‌هوک Cenaly را که جادوگر با دکمهٔ «کپی» می‌دهد بچسبانید. بدون وب‌هوک، Stripe اطلاع نمی‌دهد که سفارش پرداخت شده و سفارش ممکن است در وضعیت «در انتظار» بماند.
4. رویدادها را انتخاب کنید — در بلوک «Select events» حتماً checkout.session.completed را اضافه کنید (همین رویداد پرداخت سفارش را تأیید می‌کند)، و برای روش‌های پرداخت معوق نیز checkout.session.async_payment_succeeded و checkout.session.async_payment_failed را. سپس «Add endpoint» را بزنید. بدون این رویدادها، وب‌هوک ساخته می‌شود اما دربارهٔ پرداخت اطلاعی نمی‌دهد.
5. Webhook signing secret را کپی کنید (whsec_…) — فیلدی اختیاری است، اما با آن بررسی امضای اعلان‌ها فعال می‌شود.
6. اتصال — مقادیر واردشده به بک‌اند امن فرستاده می‌شوند.

فرم کوتاه#

اگر از قبل می‌دانید هر چیزی در Stripe کجاست، فرم درون‌خطی اتصال را باز کنید و همان فیلدها را پر کنید: Secret key، Webhook signing secret (اختیاری)، Publishable key (اختیاری) به‌همراه کلید تغییر حالت.

5. تنظیم روش‌های پرداخت#

کارت‌های بانکی#

هنگام اتصال Stripe به‌طور خودکار فعال می‌شوند:

• Visa / Mastercard — همه کشورها
• American Express — بیشتر کشورها
• Diners Club / Discover — به‌صورت گزینشی

Apple Pay و Google Pay#

کلید جداگانه‌ای در Cenaly برای آن‌ها وجود ندارد: پرداخت در صفحه میزبانی‌شده Stripe Checkout انجام می‌شود، بنابراین کیف‌پول‌ها از سمت Stripe فعال می‌شوند.

• Google Pay — بلافاصله پس از اتصال Stripe کار می‌کند (Android، Chrome).
• Apple Pay — Stripe نیاز به تأیید دامنه دارد: Settings → Payment methods → Apple Pay → Add new domain. پس از تأیید، دکمه در iOS/Safari ظاهر می‌شود.

روش‌های دیگر#

از طریق Stripe Dashboard می‌توانید فعال کنید:

روش‌های موردنظر را در Stripe Dashboard → Settings → Payment methods فعال کنید.

6. انعام#

تنظیم#

1. شعبه‌ها → کارت شعبه → زبانه «عمومی» → کلید «انعام».
2. نحوه کار:

مهمان این را چگونه می‌بیند#

هنگام پرداخت پس از انتخاب غذاها:

سفارش شما: 45₾

انعام اضافه کنید؟
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ مبلغ دیگر ]
[ بدون انعام ]

مجموع: 49.50₾   [پرداخت →]

گزارش‌های انعام#

بخش مالی:

• زبانه «نمای کلی» — مجموع انعام در دوره با مقایسه با دوره قبل؛
• زبانه «فروش» — انعام به تفکیک پیشخدمت‌ها.

7. واریز به حساب شما#

Stripe چگونه پول را واریز می‌کند#

مهمان پرداخت می‌کند → Stripe کسر می‌کند → پس از T+2 روز → پول در حساب شما

تنظیم زمان‌بندی#

در Stripe Dashboard → Settings → Payouts:

• روزانه (توصیه می‌شود)
• هفتگی (روز مشخصی از هفته)
• ماهانه

8. کارمزدهای Stripe#

9. بازپرداخت‌ها#

بازپرداخت پول از طریق Stripe از دو جا آغاز می‌شود — بسته به اینکه سفارش چگونه ارائه شده است.

بازپرداخت‌های فروشگاه اینترنتی (RMA)#

1. بخش بازپرداخت‌ها → کارت درخواست.
2. حالت بازپرداخت را انتخاب کنید: به روش پرداخت اصلی (Stripe)، با کارت هدیه (store credit) یا تعویض.
3. موارد را علامت بزنید (بازپرداخت کامل یا جزئی) و تصمیم بگیرید که آیا کالا به انبار برگردد.
4. پول مستقیماً از همان صفحه ارسال می‌شود؛ معمولاً ظرف 5–10 روز کاری به کارت مهمان می‌رسد.

بازپرداخت‌ها در صندوق#

در POS بازپرداخت بر اساس رسید انجام می‌شود — کامل یا جزئی، تعویض با فروش مجدد نیز وجود دارد. شیفت صندوق در این هنگام باید باز باشد.

در کارت سفارش در بخش سفارش‌ها نشان‌های بازپرداخت‌های انجام‌شده با پیوند به درخواست دیده می‌شود.

10. امنیت#

PCI DSS#

• Cenaly داده‌های کارت را ذخیره نمی‌کند — همه را Stripe پردازش می‌کند
• Stripe به‌عنوان PCI Level 1 (بالاترین سطح) گواهی شده است
• داده‌های کارت رمزنگاری و توکن‌سازی می‌شوند

3D Secure#

• بررسی خودکار 3D Secure برای کارت‌های EU (SCA/PSD2)
• کلاهبرداری و چارج‌بک‌ها را کاهش می‌دهد
• برای مهمان: تأیید در برنامه بانک

Radar (محافظت از کلاهبرداری)#

Stripe Radar تراکنش‌های مشکوک را به‌طور خودکار مسدود می‌کند:

• الگوی غیرعادی خرید
• کارت‌های در فهرست سیاه
• ناهنجاری‌های مکانی

11. آزمایش#

پیش از فعال‌سازی در محیط عملیاتی آزمایش کنید:

کارت‌های آزمایشی Stripe#

CVV: هر 3 رقم. تاریخ: هر تاریخ آینده. ZIP: هر مقدار.

نحوه آزمایش#

1. هنگام اتصال کلید «حالت آزمایشی» را انتخاب کنید (هر ارائه‌دهنده کلید خودش را دارد).
2. از کلیدهای آزمایشی (pk_test_...، sk_test_...) استفاده کنید — و وب‌هوکی که در همان حالت آزمایشی Stripe ساخته شده است.
3. یک سفارش آزمایشی ثبت کنید → با کارت آزمایشی پرداخت کنید.
4. وضعیت سفارش را در بخش سفارش‌ها بررسی کنید — باید «پرداخت‌شده» شود.
5. وقتی همه‌چیز کار کرد — ارائه‌دهنده را با کلیدهای عملیاتی در حالت «عملیاتی» دوباره متصل کنید.

12. ارائه‌دهندگان جایگزین#

برای کشورهایی که Stripe در دسترس نیست یا به‌عنوان مکمل — آماده اتصال:

۹۴ ارائه‌دهنده دیگر (Adyen، PayTR، ЮKassa، LiqPay، Mercado Pago، Razorpay و غیره) نیز در فهرست هستند، اما خاکستری نمایش داده می‌شوند — یکپارچه‌سازی هنوز در حال آزمایش است. مرور کامل — در بخش پرداخت.

اتصال هر ارائه‌دهنده: فروشگاه برنامه‌ها → دسته «مالی» → کارت ارائه‌دهنده → «پیکربندی»، یا از مسیر همیشگی شعبه‌ها → کارت شعبه → زبانه «پرداخت‌ها».

13. پرسش‌های متداول#

چه زمانی پول را دریافت می‌کنم؟#

۲ روز کاری پس از پرداخت (T+2). اولین پرداخت ممکن است ۷ تا ۱۴ روز طول بکشد (تا زمانی که Stripe حساب را تأیید کند).

مهمان می‌خواهد نقدی پرداخت کند — چه کنیم؟#

روش‌های «نقدی» و «کارت هنگام تحویل» همیشه در دسترس هستند و به ارائه‌دهنده پرداخت نیاز ندارند — مهمان آن‌ها را در تسویه انتخاب می‌کند و صندوق‌دار تسویه را انجام می‌دهد. Stripe در این حالت دخیل نمی‌شود؛ رسید در صندوق صادر می‌شود، اگر سخت‌افزار مالیاتی متصل داشته باشید (به مالی‌سازی مراجعه کنید).

آیا می‌توان هم Stripe و هم BOG iPay را متصل کرد؟#

بله. در زبانه «پرداخت‌ها» می‌توان چند ارائه‌دهنده را همزمان فعال کرد — در تسویه، مهمان برای هر کدام یک دکمه با نام ارائه‌دهنده می‌بیند.

Stripe حساب را مسدود کرده — چه کنیم؟#

1. ایمیل را بررسی کنید — Stripe دلیل را ارسال می‌کند
2. معمولاً تأیید هویت بیشتری لازم است
3. با Stripe Support تماس بگیرید: support.stripe.com
4. در زمان مسدودی می‌توانید از ارائه‌دهنده جایگزین استفاده کنید

چگونه کارمزد را به حداقل برسانیم؟#

• پرداخت با کارت‌های EU را تشویق کنید (۱.۵٪ به‌جای ۲.۹٪)
• برای مبالغ بزرگ از SEPA استفاده کنید (۰.۳۵€ ثابت)
• با گردش مالی بالا (>100K€/ماه) — از Stripe طرح اختصاصی درخواست کنید

14. پشتیبانی#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → موضوع «Stripe / پرداخت»
• Stripe Status: status.stripe.com (بررسی عملکرد)