دامنه اختصاصی پرداخت
اتصال دامنه برند شما به پرداخت اینپی فای؛ ثبت زیردامنه، رکوردهای CNAME و TXT، تأیید DNS و فعال‌سازی HTTPS
دامنه اختصاصی پرداخت، آدرسی از برند شما مانند pay.example.com است که برای صفحات واسط انتقال به بانک و دریافت پاسخ بانک در پرداخت‌های درگاه اختصاصی پروژه استفاده می‌شود. این تنظیم در سطح پروژه است و پرداخت‌های برنامه‌های آن پروژه را پوشش می‌دهد؛ برای هر برنامه دامنه جدا ثبت نمی‌کنید.
این قابلیت، دامنه خود بانک را تغییر نمی‌دهد و به معنای انتقال لندینگ یا همه لینک‌های پرداخت شما به این دامنه نیست. پرداخت‌های درگاه اینپی فای همچنان از دامنه پرداخت اینپی فای استفاده می‌کنند.
پیش‌نیازها و مسیر پنل
به تنظیمات DNS دامنه خود دسترسی داشته باشید، یک زیردامنه مجزا برای پرداخت انتخاب کنید و مجوز مدیریت درگاه‌های پروژه را داشته باشید. سپس پروژه را انتخاب و وارد تنظیمات پروژه ← دامنه اختصاصی درگاه شوید. از اعلان تنظیم دامنه در صفحه درگاه‌های بانکی نیز می‌توانید وارد این بخش شوید.
در هر پروژه یک دامنه پرداخت ثبت می‌شود و یک دامنه نمی‌تواند هم‌زمان به پروژه دیگری اختصاص داشته باشد. دامنه‌های رزروشده اینپی فای قابل ثبت نیستند.
۱. ثبت زیردامنه
در کادر زیردامنه پرداخت فقط نام میزبان را وارد کنید، مانند pay.example.com، و اتصال دامنه را بزنید. https://، شماره پورت، مسیر و پارامتر به آن اضافه نکنید.
پس از ثبت، پنل اطلاعات رکوردهای DNS را نمایش می‌دهد. مقادیر همان پنل را کپی کنید؛ مثال‌های این راهنما جایگزین اطلاعات پروژه شما نیستند.
۲. افزودن رکوردهای DNS
در پنل شرکت مدیریت DNS، دو رکورد زیر را مطابق اطلاعات نمایش‌داده‌شده در اینپی فای بسازید:
| نوع رکورد | نام نمونه | مقدار |
|---|---|---|
| CNAME | pay.example.com | مقصد دقیق نمایش‌داده‌شده در پنل اینپی فای |
| TXT | _inappify-payment.pay.example.com | مقدار تأیید اختصاصی نمایش‌داده‌شده پس از ثبت دامنه |
رکورد CNAME مسیر اتصال زیردامنه به سرویس پرداخت را مشخص می‌کند؛ TXT برای تأیید مالکیت همان دامنه است. هر دو رکورد باید صحیح باشند.
برخی پنل‌های DNS نام دامنه اصلی را خودکار اضافه می‌کنند؛ در این حالت برای دامنه نمونه example.com، نام‌ها ممکن است به‌شکل pay و _inappify-payment.pay وارد شوند. پیش از ذخیره بررسی کنید نام نهایی دقیقاً مطابق جدول پنل اینپی فای باشد و دامنه دوبار تکرار نشود.
مقدار TXT با inappify-verification= شروع می‌شود. کل مقدار را بدون تغییر کپی کنید؛ کلید API یا کلید درگاه را در TXT قرار ندهید. برای مقصد CNAME نیز مقدار ساختگی یا IP دلخواه وارد نکنید.
۳. بررسی DNS
پس از ثبت رکوردها و قابل مشاهده‌شدن تغییرات DNS، به پنل اینپی فای برگردید و بررسی را بزنید. تأیید DNS فقط زمانی انجام می‌شود که TXT مالکیت و CNAME مقصد هر دو معتبر باشند.
اگر پس از بارگذاری دوباره صفحه مقدار TXT در دسترس نیست، از گزینه ساخت مقدار تأیید جدید در همان صفحه استفاده کنید و مقدار TXT قبلی را در DNS جایگزین کنید. ساخت مقدار جدید، تأیید و فعال‌سازی قبلی را بازنشانی می‌کند؛ روی دامنه فعال بدون نیاز این کار را انجام ندهید.
۴. فعال‌شدن HTTPS
تأیید DNS پایان کار نیست. دامنه باید گواهی معتبر HTTPS و مسیر پرداخت فعال داشته باشد. در وضعیت «در انتظار فعال‌سازی HTTPS»، تنظیمات DNS تأیید شده‌اند اما دامنه هنوز برای استفاده نهایی آماده نیست.
از به‌روزرسانی وضعیت برای بررسی نتیجه استفاده کنید. اگر این وضعیت باقی ماند، با پشتیبانی برای تکمیل فعال‌سازی هماهنگ کنید. زمان ثابت یا فعال‌سازی فوری را فرض نکنید؛ تا نمایش وضعیت فعال و امن، درگاه اختصاصی را آماده خرید واقعی ندانید.
معنی وضعیت‌ها
- در انتظار تنظیم DNS: رکوردهای مالکیت و مقصد هنوز تأیید نشده‌اند.
- در انتظار فعال‌سازی HTTPS: DNS تأیید شده و فعال‌سازی امن دامنه باقی مانده است.
- فعال و امن: دامنه تأیید و فعال شده و برای پرداخت‌های درگاه اختصاصی پروژه قابل استفاده است.
- قطع‌شده: اتصال دامنه لغو شده و برای انتخاب مسیر پرداخت اختصاصی آماده نیست.
هماهنگی با ارائه‌دهنده درگاه
اگر ارائه‌دهنده، دامنه بازگشت پرداخت را محدود می‌کند، دامنه اختصاصی شما باید با اطلاعات ثبت‌شده نزد آن ارائه‌دهنده سازگار باشد. آدرس بازگشت را حدس نزنید؛ برای اطلاعات مورد نیاز پذیرندگی با پشتیبانی هماهنگ کنید. تنظیم DNS جایگزین تأیید پذیرندگی یا تنظیم محدودیت IP نیست.
پس از فعال‌شدن دامنه، درگاه بانکی را کنترل کنید و انتقال، بازگشت و نتیجه خرید را آزمایش کنید.
رفع خطا و قطع اتصال
- خطای نام دامنه: فقط hostname معتبر بدون پروتکل و مسیر وارد کنید.
- دامنه متعلق به پروژه دیگر است: پروژه فعلی و اتصال قبلی دامنه را بررسی کنید؛ دامنه تکراری قابل تخصیص نیست.
- DNS تأیید نمی‌شود: نام کامل TXT، مقدار جدید آن و مقصد CNAME را کنترل کنید. اگر سرویس DNS با پراکسی رکورد CNAME را پنهان می‌کند، حالت نمایش مستقیم رکورد را بررسی کنید. انتشار تغییرات DNS ممکن است فوری نباشد.
- HTTPS فعال نمی‌شود: باقی‌ماندن وضعیت را با پشتیبانی پیگیری کنید؛ تأیید DNS به‌تنهایی کافی نیست.
برای لغو، قطع اتصال را بزنید و پیام تأیید را بررسی کنید. این کار دامنه را از مسیر پرداخت خارج می‌کند؛ درگاه اختصاصی ممکن است دیگر انتخاب نشود و، در صورت وجود، مسیر جایگزین اینپی فای استفاده شود. پیش از قطع اتصال یا ثبت مجدد، وضعیت خریدهای در حال انجام و مسیر جایگزین را بررسی کنید. این اقدام رکوردهای DNS را از پنل شرکت شما حذف نمی‌کند.