در این گزارش
مکان: تنظیمات ← مخاطبان و مالی ← اتصال‌ها ← پرداخت‌ها
این صفحه را باز کنید: admin.<your-site>/settings/connections/payments (به جای <your-site> آدرس سایت خود را بگذارید)
پیش‌نیازها
- ابتدا Razorpay، Stripe یا PayPal را متصل کنید. بخش Payments را ببینید.
- باید مالک سایت باشید.
مراحل انجام کار
Stripe و PayPal: در صورت امکان، Keynate پیام‌های پرداخت را خودکار در حسابتان تنظیم میکند. کارت مربوطه می‌گوید «پیام‌های پرداخت در Stripe برای شما تنظیم شده‌اند.» اگر امکان‌پذیر نباشد، عبارت «یک مرحله دیگر» همراه با دکمه تکمیل راه‌اندازی نمایش داده میشود. مراحل زیر را دنبال کنید.
Razorpay: این کار به‌صورت خودکار ممکن نیست. کارت Razorpay یک راهنمای ۳ مرحله‌ای همراه با بررسی زنده دارد: عبارت در انتظار دریافت نخستین پیام از Razorpay… بعد از اولین پرداخت تستی یا واقعی، به نخستین پیام از Razorpay دریافت شد. تغییر میکند. برای بررسی دوباره، بررسی اکنون را بزنید. بخش Connect Razorpay را ببینید.
مراحل برای هر درگاه:
- بخش تنظیمات → خوانندگان و درآمد → اتصال‌ها → پرداخت‌ها را باز کنید.
- روی کارت درگاه خود، کادر Webhook را پیدا کنید.
- روی باز کردن وب‌هوک‌ها بزنید (نام درگاه روی دکمه نوشته شده است). داشبورد درگاه در برگه جدیدی باز میشود.
- در درگاه، روی افزودن بزنید.
- به Keynate برگردید، روی کپی در کنار URL وبهوک بزنید و آن را در درگاه جای‌گذاری کنید.
- تیک رویدادهای فهرست‌شده در کادر Keynate را بزنید.
- در Razorpay: دکمه کپی را برای کد مخفی بزنید و آن را در کادر secret جای‌گذاری کنید. برای حالت آزمایشی و زنده از کدهای مخفی متفاوتی استفاده کنید.
- آن را در درگاه ذخیره کنید.
- درگاه‌های Stripe و PayPal بعد از ذخیره کدی را نشان میدهند. Stripe به آن signing secret می‌گوید که با
whsec_شروع میشود. PayPal به آن Webhook ID می‌گوید. آن را کپی کرده و در کادر مربوطه در Keynate جای‌گذاری کنید. - روی آزمایش اتصال بزنید.
نکات مهم
- حالت آزمایشی (Test) و حالت زنده (Live) هر کدام به وبهوک جداگانه نیاز دارند.
- اگر کد مخفی را گم کردید، یک وبهوک جدید در درگاه بسازید و کد جدید را جای‌گذاری کنید.
مشکلات رایج
- «کد مخفی وبهوک که در Razorpay وارد کردید را جای‌گذاری کنید.» کادر موجود در Keynate خالی است. همان کد مخفی را که به Razorpay دادید اینجا وارد کنید.
- «برای حالت آزمایشی و زنده از کدهای مخفی متفاوتی استفاده کنید.» برای حالت دوم یک کد مخفی جدید بسازید.
- «کد signing secret وبهوک را جای‌گذاری کنید. این کد با whsec_ شروع میشود.» بعد از افزودن نقطه پایانی (endpoint)، آن را از Stripe کپی کنید.
- «Webhook ID را جای‌گذاری کنید (فقط حروف و اعداد).» این شناسه را از فهرست Webhooks در برنامه PayPal خود کپی کنید.
- در Razorpay همچنان پیام «در انتظار دریافت نخستین پیام از Razorpay…» دیده میشود. یک پرداخت آزمایشی کوچک انجام دهید. این پیام پس از نخستین تراکنش می‌رسد. سپس روی بررسی اکنون بزنید.
- سفارش بعد از پرداخت مخاطب همچنان پرداختنشده باقی مانده است. وبهوک ثبت نشده یا اشتباه است. البته Keynate هر شب وضعیت سفارش‌های شما را با درگاه بررسی کرده و موارد جاافتاده را اصلاح میکند.
پرسش‌ها
پرسش‌های متداول
آیا این همان کلید API است؟
خیر. کلیدها به Keynate امکان گفتگو با درگاه را میدهند؛ اما وبهوک به درگاه اجازه میدهد پیامها را به Keynate بفرستد.
آیا برای حالت آزمایشی و زنده به وبهوک جداگانه نیاز دارم؟
بله. حالت آزمایشی و حالت زنده هر کدام به وبهوک اختصاصی خود نیاز دارند.
اگر کد مخفی را گم کنم چه میشود؟
یک وبهوک جدید در درگاه بسازید و کد جدید را در Keynate وارد کنید.
اگر مخاطب پرداخت کند ولی سفارش پرداختنشده بماند چه کار کنیم؟
وبهوک ثبت نشده یا نادرست است. با این حال، Keynate هر شب سفارشها را با درگاه شما مطابقت میدهد و موارد باقیمانده را ثبت میکند.