تنظیم درگاه و روشهای پرداخت فروشگاه
زرینپال، اسنپپی و دیجیپی را با اعتبارنامهٔ درست پیکربندی کنید و روش هماهنگی یا واریز بانکی را با راهنمای روشن برای مشتری آماده سازید.
صفحهٔ روشهای پرداخت
در /panel/payments روشهایی را که مشتری هنگام ثبت سفارش میتواند انتخاب کند پیکربندی میکنید. صفحه پنج زبانه دارد: زرینپال، اسنپپی، دیجیپی، «هماهنگی پرداخت» و «واریز بانکی». برای ذخیرهٔ تنظیمات، دسترسی مدیریت پرداخت لازم است. اعتبارنامهٔ هر درگاه را از حساب رسمی پذیرنده بگیرید و آن را با کلید یا رمز ورود پنل اشتباه نگیرید.
فعالکردن یک روش پرداخت باعث میشود گزینهٔ مربوط برای مشتری در دسترس قرار گیرد، اگر پیکربندی و شرایط درگاه هم آماده باشد. پیش از فعالکردن در فروش واقعی، همهٔ فیلدهای لازم را تکمیل، اطلاعات اتصال را ذخیره و مسیر پرداخت مشتری را با حساب آزمایشی یا روش مورد تأیید ارائهدهنده بررسی کنید.
زرینپال
در زبانهٔ «زرینپال»، شناسهٔ پذیرنده را از حساب پذیرندگی وارد و گزینهٔ «فعال» را روشن کنید. وضعیت کنار نام نشان میدهد کد پذیرندهٔ اختصاصی همین فروشگاه فعال است، تنظیمات سرور بهکار میرود یا شناسهای برای این فروشگاه وجود ندارد. اگر شناسه را خالی بگذارید و سرویس سرور پیکربندی نشده باشد، روشنکردن گزینه به تنهایی پرداخت را آماده نمیکند.
شناسهٔ پذیرنده را بدون فاصله و دقیق وارد کنید و پس از ذخیره، صفحهٔ پرداخت فروشگاه را بررسی کنید. در این صفحه دکمهٔ تست احراز هویت جداگانه برای زرینپال وجود ندارد؛ وضعیت سفارش یا تراکنش را در پنل خود آن درگاه و جزئیات پرداخت آناما بررسی کنید. برای آزمایش، از دستورالعمل جاری پذیرنده و حساب آزمایشی استفاده کنید؛ تراکنش واقعی مشتری را برای تست انجام ندهید.
اسنپپی
اسنپپی امکان خرید اقساطی را فراهم میکند و برای فعالسازی، قرارداد پذیرندگی و اطلاعات اتصال لازم است. در زبانهٔ «اسنپپی» وضعیت فعالبودن، آمادهبودن دسترسی و تکمیل اعتبارنامهها را از برچسب سرویس بخوانید. مقدارهای Client ID، کلید محرمانه، نام کاربری پذیرنده و رمز عبور را از اطلاعات قرارداد خود بردارید. اگر اعتبارنامهای پیشتر ذخیره شده، صفحه آن را بهصورت محرمانه نگه میدارد؛ برای حفظ مقدار فعلی فیلد را خالی بگذارید و فقط برای تعویض مقدار تازه بنویسید.
نشانی سرویس را مطابق قرارداد رسمی وارد کنید. از واردکردن دامنهٔ غیررسمی خودداری کنید؛ پنل دامنهٔ رسمی snapppay.ir را میپذیرد و اگر قرارداد شما نشانی متفاوتی ارائه کرده، آن را از مسیر پشتیبانی پذیرنده تأیید کنید. از پیوند «ثبتنام پذیرنده» برای آغاز فرایند رسمی استفاده کنید.
پس از تکمیل اطلاعات، روش را فعال و کل صفحه را با دکمهٔ «ذخیره روشهای پرداخت» ذخیره کنید. سپس «تست احراز هویت» را بزنید؛ این تست اتصال اعتبارنامه را بررسی میکند و بهتنهایی پرداخت آزمایشی کامل یا تأیید نهایی سفارش نیست. اگر اتصال را عمداً قطع میکنید، گزینهٔ «حذف اطلاعات اتصال» را فعال کنید و دوباره ذخیره کنید؛ فقط خاموشکردن روش، کلیدهای ذخیرهشده را پاک نمیکند.
دیجیپی
در زبانهٔ «دیجیپی»، Client ID، کلید محرمانه، نام کاربری و رمز را از پنل پذیرنده تنظیم کنید. سپس ابزار پرداخت را انتخاب کنید: BNPL، اعتباری، کیف پول، درگاه اینترنتی یا کارت اعتباری. انتخاب ابزار روی فیلدهای بعدی اثر دارد. برای BNPL یا روش اعتباری، Seller ID و Supplier ID قراردادی و نوع محصول پیشفرض را تکمیل کنید. برای Wallet میتوانید درگاه ترجیحی را مشخص کنید یا بگذارید انتخاب ابزار نمایش داده شود.
محیط را با اعتبارنامه هماهنگ کنید: UAT / Sandbox برای محیط آزمایشی و Production برای پرداخت واقعی است. اعتبارنامهٔ آزمایشی را در محیط تولید یا برعکس استفاده نکنید. نشانی سرویس را میتوانید خالی بگذارید تا آدرس رسمی همان محیط استفاده شود؛ اگر مقدار مینویسید، دامنه باید از دامنههای رسمی دیجیپی باشد. پیوند «مستند رسمی API» برای بررسی قرارداد فنی و «پنل پذیرندگان» برای مدیریت حساب بیرونی است.
دکمهٔ «تست احراز هویت» اتصال را برای وضعیت فعلی میآزماید. پس از آن تنظیمات را با «ذخیره روشهای پرداخت» ثبت کنید و برچسب دسترسی و تکمیل اعتبارنامه را دوباره بخوانید. حذف اطلاعات اتصال هم نیازمند انتخاب جداگانه و ذخیرهٔ فرم است؛ خاموشکردن روش به معنی پاکشدن رمزها نیست.
هماهنگی پرداخت و واریز بانکی
«هماهنگی پرداخت» یک درگاه آنلاین نیست. وقتی مشتری آن را انتخاب میکند، سفارش ثبت میشود اما تا تأیید فروشگاه پرداختنشده میماند. در زبانهٔ «هماهنگی»، روش را روشن کنید، عنوان قابلفهم برای مشتری بنویسید، توضیح کوتاه و راهنمای پس از ثبت سفارش را تنظیم کنید. دقیق بگویید مشتری چگونه با فروشگاه تماس بگیرد و چه چیزی را پس از ثبت سفارش آماده کند؛ زمان پاسخ یا قطعیشدن سفارش را وعده ندهید مگر اینکه واقعاً بتوانید انجام دهید.
«واریز بانکی» نیز مستقل از درگاه است؛ مشتری اطلاعات حساب را میبیند و میتواند فیش واریز را ارسال کند. عنوان، توضیح، نام صاحب حساب، نام بانک، شماره کارت، شبا و راهنمای واریز را با اطلاعات حساب جاری فروشگاه تکمیل کنید. شماره کارت حداکثر ۱۶ رقم و شبا به قالبی شبیه IR... محدود میشود. مبلغ، شناسهٔ سفارش و روش فرستادن رسید را در راهنما روشن کنید. تصویر فیش بهتنهایی تأیید قطعی واریز نیست؛ تراکنش را در حساب بانکی بررسی کنید و سپس سفارش را از مسیر عملیاتی مربوط تعیین تکلیف کنید.
اطلاعات حساب بانکی در صفحهٔ مشتری نمایش داده میشود؛ قبل از ذخیره، آن را با صاحب حساب و مسئول مالی تطبیق دهید. گزینهٔ واریز را خاموش کنید اگر حساب یا راهنمای نمایشدادهشده قدیمی است. پس از تغییرات روی «ذخیره روشهای پرداخت» بزنید و متن عمومی را در فروشگاه مرور کنید.
ذخیره، آزمایش و رفع خطا
دکمهٔ ذخیره پایین همهٔ زبانههاست و تغییرات روشها را با هم ثبت میکند. اگر خطا دیدید، متن بالای صفحه را بخوانید، فیلدهای همان روش را اصلاح کنید و دوباره ذخیره کنید. کلیدهای محرمانه بعد از ذخیره دوباره نمایش داده نمیشوند؛ خالیبودن کادر رمز الزاماً به معنی پاکشدن آن نیست. برای پاککردن اتصال، گزینهٔ حذف را صریحاً فعال کنید.
پس از ذخیره، صفحهٔ عمومی فروشگاه را در حالت مشتری باز کنید و مطمئن شوید فقط روشهای لازم نمایش داده میشوند. برای روش آنلاین، شروع تراکنش و نتیجهٔ آن را در سفارش آزمایشی و حساب درگاه بررسی کنید. اگر مشتری از صفحهٔ نتیجه خارج شد، وضعیت ثبتشدهٔ تراکنش و پرداخت را در پنل ملاک بگیرید؛ سفارش یا بازپرداخت دوم را تا روشنشدن نتیجه ایجاد نکنید.
در گزارش مشکل، نام روش پرداخت، محیط آزمایشی یا واقعی، زمان، شناسهٔ سفارش/تراکنش و پیام خطا را ذکر کنید. شمارهٔ کامل کارت، رمز درگاه، کلید محرمانه، کد یکبارمصرف یا تصویر فیش حاوی اطلاعات شخصی را برای پشتیبانی نفرستید.