برای اتصال وب‌سایت یا اپلیکیشن خود به سرویس‌های پی‌پینگ، به توکن پی‌پینگ (Access Token) نیاز دارید. در این راهنما می‌توانید مراحل ایجاد و ویرایش توکن را مشاهده کنید.
ایجاد توکن پی‌پینگ
مراحل ایجاد توکن
برای اتصال وب‌سایت یا اپلیکیشن خود به سرویس‌های پی‌پینگ، وارد حساب کاربری خود شده، از منوی اتصالات وارد بخش توسعه‌دهندگان شوید و گزینه ایجاد توکن را انتخاب کنید.
در فرم ایجاد توکن، اطلاعات زیر را تکمیل کنید:
- نام توکن: نامی برای شناسایی توکن در پنل شماست. اگر برای چند وب‌سایت یا اپلیکیشن توکن جداگانه ایجاد می‌کنید، بهتر است نامی انتخاب کنید که تشخیص هر توکن را آسان کند.
- آی‌پی مجاز: آی‌پی سرورهایی را وارد کنید که مجاز به ارسال درخواست به API پی‌پینگ هستند. درخواست‌های ارسالی از سایر آی‌پی‌ها پذیرفته نمی‌شود.
- دسترسی‌ها: فقط دسترسی‌هایی را فعال کنید که وب‌سایت یا اپلیکیشن شما به آن‌ها نیاز دارد. در صورت نیاز به استفاده از چند سرویس پی‌پینگ، می‌توانید دسترسی‌های مرتبط را هم‌زمان فعال کنید.
- تاریخ انقضا: مشخص می‌کند توکن تا چه زمانی معتبر باشد. امکان تعیین تاریخ انقضا تا ۵۰ سال آینده وجود دارد.
استفاده از توکن تستی
اگر فقط قصد تست اتصال و پیاده‌سازی درگاه را دارید، می‌توانید از توکن تستی پی‌پینگ استفاده کنید.
در استفاده از توکن تستی این محدودیت‌ها را در نظر داشته باشید:
- مبلغ هر پرداخت حداکثر ۲٬۰۰۰ تومان و مجموع مبالغ کل تراکنش‌ها حداکثر ۵۰،۰۰۰ تومان است.
- آدرس بازگشت در تراکنش می‌تواند با آدرس واقعی پذیرنده متفاوت باشد؛ مثلا localhost
توکن تستی برای بررسی صحت پیاده‌سازی و اتصال اولیه مناسب است. برای استفاده عملیاتی و دریافت پرداخت‌های واقعی، توکن اختصاصی خود را ایجاد و استفاده کنید.
تاریخ انقضای توکن
تا زمانی که تاریخ انقضای توکن نرسیده باشد، اتصال وب‌سایت یا اپلیکیشن شما به پی‌پینگ فعال باقی می‌ماند.
پس از رسیدن تاریخ انقضا، توکن به‌صورت خودکار غیرفعال می‌شود. در صورت نیاز می‌توانید پیش از پایان اعتبار، تاریخ انقضا را از پنل پی‌پینگ ویرایش کنید.
اگر دیگر به توکن نیاز ندارید، لازم نیست منتظر پایان تاریخ اعتبار بمانید و می‌توانید آن را از پنل حذف کنید.
دریافت و نگهداری توکن
پس از تکمیل اطلاعات و ثبت درخواست، رمز پیامکی را وارد کنید تا توکن ایجاد شود.
ارسال رمز پیامکی دارای محدودیت زمانی است؛ اگر طی ۱۵ دقیقه گذشته رمز دریافت کرده باشید، برای دریافت رمز جدید باید تا پایان این بازه منتظر بمانید.
پس از ایجاد موفق، مقدار توکن به شما نمایش داده می‌شود.
مهم: کد توکن به دلایل امنیتی فقط یک‌بار نمایش داده می‌شود. آن را همان زمان کپی و در محل امنی نگهداری کنید.
ویرایش توکن
برای تغییر تنظیمات یک توکن، از بخش اتصالات ← توسعه‌دهندگان وارد قسمت توکن‌ها شوید و مقابل توکن موردنظر گزینه ویرایش را انتخاب کنید.
با انتخاب این گزینه، همان تنظیماتی که هنگام ایجاد توکن در اختیار شما بوده نمایش داده می‌شود. می‌توانید اطلاعاتی مانند نام توکن، آی‌پی‌های مجاز، تاریخ انقضا، دسترسی‌ها و توضیحات را تغییر دهید.
پس از انجام تغییرات، رمز پیامکی را دریافت و در قسمت مربوط وارد کنید و گزینه ویرایش توکن را انتخاب کنید.
توجه: ارسال رمز پیامکی دارای محدودیت زمانی است؛ اگر طی ۱۵ دقیقه گذشته رمز دریافت کرده باشید، برای دریافت رمز جدید باید تا پایان این بازه منتظر بمانید.
در صورت داشتن هرگونه سوال و نیاز به راهنمایی ، با پشتیبانی آنلاین سایت پی‌پینگ در ارتباط باشید.
به روز شده در: 1405/07/25