آموزش اتصال و استفاده از پنل پذیرندگان دیجی‌پی (درگاه پرداخت و تسویه حساب)

برای مدیران کسب‌وکارهای اینترنتی، جذب ترافیک ورودی بدون داشتن زیرساخت پرداخت با نرخ ریزش پایین، هدررفت مطلق بودجه بازاریابی است. وب‌مسترهایی که با صرف هزینه‌های سنگین سئو و تبلیغات کلیکی، کاربر را تا مرحله پایانی قیف فروش (Checkout) هدایت می‌کنند، اغلب با نرخ رهاسازی سبد خرید فراتر از ۶۵ درصد مواجه می‌شوند. علت اصلی در فضای تجارت الکترونیک امروز ایران، ناتوانی در پوشش شیوه‌های پرداخت منعطف نظیر اعتبار خرد، سرویس‌های «الان بخر، بعداً پرداخت کن» (BNPL) و افت پایداری سوییچ‌های سنتی بانکی است.

ادغام درگاه پرداخت هوشمند و پنل پذیرندگان دیجی‌پی (DigiPay Merchant Panel) یکی از اهرم‌های راهبردی برای بازیابی سبدهای رهاشده و ارتقای میانگین ارزش هر سفارش (AOV) است. این مستند عملیاتی، نقشه راه فنی احراز هویت، پیاده‌سازی API و مدیریت چرخه‌های مالی و تسویه‌حساب در اکوسیستم دیجی‌پی را گام‌به‌گام تشریح می‌کند.

---

۱. چرخه فنی پذیرندگی: پیش‌نیازها و اعتبارسنجی حقوقی

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

• الزامات پذیرنده حقیقی: تصویر کارت ملی هوشمند، جواز کسب صنفی معتبر یا لینک اینماد فعال کسب‌وکار، و شماره شبای حساب بانکی منطبق با کد ملی متقاضی.
• الزامات پذیرنده حقوقی: روزنامه رسمی ثبت شرکت، آخرین تغییرات آگهی رسمی، شناسه ملی، کد اقتصادی، و شماره شبای متصل به حساب حقوقی شرکت.
• پیش‌نیازهای دامنه: فعال بودن پروتکل SSL، دامنه ثبت‌شده تاییدشده در مرکز اینماد، و صفحات استاندارد «قوانین بازگشت وجه» و «حریم خصوصی».

پس از ثبت درخواست اولیه در سامانه جذب پذیرندگان دیجی‌پی، اطلاعات کسب‌وکار در کمتر از ۴۸ ساعت کاری از سوی واحد تطبیق قوانین بررسی و دسترسی به پرتال اختصاصی صادر می‌شود.

---

۲. راهنمای اتصال فنی و معماری وب‌سرویس REST دیجی‌پی

ارتباط فروشگاه اینترنتی با سرورهای پردازش پرداخت دیجی‌پی بر پایه معماری RESTful و تبادل نشست از طریق پروتکل اعتبارسنجی OAuth 2.0 صورت می‌پذیرد.

الف) اندپوینت‌ها و تفکیک محیط آزمایشی از عملیاتی

دیجی‌پی برای اطمینان از عملکرد بدون نقص کدهای سمت سرور، دو محیط مجزا در اختیار توسعه‌دهنده قرار می‌دهد:

• محیط تست (Sandbox / UAT):https://uat.mydigipay.info/digipay/api
• محیط عملیاتی (Production / Live):https://api.mydigipay.com/digipay/api

ب) دریافت توکن احراز هویت (Authentication Handshake)

تراکنش‌ها بدون داشتن کلید دسترسی معتبر رد خواهند شد. برای دریافت توکن، باید درخواستی با متد POST و هدر Authorization: Basic [Base64EncodedCredentials] به اندپوینت احراز هویت ارسال شود:

                                    POST /oauth/token HTTP/1.1
Host: api.mydigipay.com
Content-Type: application/x-www-form-urlencoded

username={CLIENT_ID}&password={CLIENT_SECRET}&grant_type=password

خروجی سرور حاوی یک رشته متنی access_token و زمان انقضای expires_in (معمولاً ۳۵۹۹ ثانیه) است که باید در کش موقت سرور ذخیره و در فراخوانی‌های بعدی به عنوان Bearer Token به هدر افزوده شود.

ج) فرآیند ۳ مرحله‌ای پردازش تراکنش

1. ثبت تیکت پرداخت (Ticket Initiation): ارسال مبلغ سبد، شناسه ارجاع یکتا (invoiceNumber)، شماره همراه کاربر و آدرس بازگشت (callbackUrl). در پاسخ، پارامتر ticket یکتا صادر می‌گردد.
2. ریدایرکت کاربر (Redirect): هدایت مرورگر خریدار به آدرس درگاه پرداخت دیجی‌پی با پاس‌دادن شناسه تیکت دریافتی.
3. تایید نهایی تراکنش (Verification): مهم‌ترین لایه امنیتی وب‌سرویس؛ به محض بازگشت کاربر به آدرس سایت شما، باید بلافاصله اندپوینت وریفای صدا زده شود تا از رخداد حملات MitM و فریب وضعیت جلوگیری گردد.

نکته امنیتی در معماری بک‌اند:

وضعیت تراکنش را هرگز صرفاً بر مبنای پارامترهای ارسالی در متد GET بازگشتی از سمت مرورگر کاربر نهایی نکنید. صدور فاکتور قطعی و تغییر وضعیت سفارش به «پرداخت‌شده» فقط پس از دریافت پاسخ ۲۰۰ موفق و مقایسه شناسه پیگیری (trackingCode) و کد مرجع (rrn) در اندپوینت Verify مجاز است.

---

۳. اتصال سریع بدون کدنویسی: سناریوی وردپرس و افزونه‌های بومی

برای وب‌سایت‌های مبتنی بر ووکامرس، پیاده‌سازی نیازمند بازنویسی کدهای روتینگ نیست:

1. نصب و فعال‌سازی افزونه رسمی درگاه هوشمند دیجی‌پی (یا پلاگین‌های واسط سازگار با معماری پلتفرم نظیر پی‌زیتو).
2. ورود به مسیر ووکامرس ← پیکربندی ← تب تسویه‌حساب (پرداخت‌ها) ← درگاه دیجی‌پی.
3. جای‌گذاری متغیرهای دریافتی از پنل شامل: Client ID، Client Secret، Username و Password.
4. تنظیم وضعیت بازگشت و متن خطاهای اختصاصی متناسب با تجربه کاربری فروشگاه.
5. اجرای آزمایشی یک سناریوی خرید خرد در محیط UAT و اطمینان از سلامت Webhook برای بازگشت موجودی انبار.

---

۴. مدیریت پنل پذیرندگان دیجی‌پی و رفع مغایرت‌های مالی

پنل پذیرندگان صرفاً ابزار مشاهده وضعیت پرداختی‌ها نیست؛ بلکه یک داشبورد تصمیم‌گیری مدیریتی است. دسترسی به گزارش‌های عمیق از خطاهای پرداخت به شما نشان می‌دهد چند درصد تراکنش‌ها ناشی از افت زیرساخت بانکی (کد خطای ۹۰۰۶) و چه میزان ناشی از انقضای نشست کاربر (کد خطای ۹۰۰۳) بوده است.

---

بخش پنل	داده‌های کاربردی	کاربرد اجرایی برای فروشگاه
داشبورد تراکنش‌ها	تفکیک تراکنش‌های IPG، BNPL و اعتباری	سنجش میزان رغبت مشتریان به مدل‌های خرید اعتباری
لاگ خطای سوییچ	کدهای سیستمی ۹۰۰۴ تا ۹۰۰۸	مانیتورینگ سلامت درگاه و رفع خطاهای تکراری کلاینت
تقویم مالی (Settlement)	تاریخ‌های سررسید و واریز گروهی پایا	برنامه‌ریزی تامین موجودی انبار و پرداخت بدهی تامین‌کنندگان
گزارش مغایرت	ریز تراکنش‌های ناموفق اصلاح‌شده (Reversed)	جلوگیری از صدور فاکتور دوبل یا تسویه کالای معلق

۵. فرمولاسیون ریاضی و سازوکار تسویه‌حساب مالی

یکی از چالش‌های همیشگی مدیران مالی در کسب‌وکارهای آنلاین، محاسبه دقیق سود خالص از محل تراکنش‌های اعتباری و درگاه‌های تجمیعی است. دیجی‌پی بر مبنای مدل درآمدی عملکردمحور رفتار می‌کند؛ بدین معنی که تا زمان وقوع تراکنش موفق، هیچ‌گونه هزینه ثابت نگهداری از پذیرنده دریافت نمی‌شود.

فرمول رسمی خالص دریافتی فروشگاه:

$$\text{مبلغ خالص تسویه} = \text{فروش ناخالص} – (\text{مبالغ مرجوعی} + \text{کارمزد توسعه فروش} + \text{مالیات بر ارزش افزوده کارمزد})$$مبلغ خالص تسویه=فروش ناخالص−(مبالغ مرجوعی+کارمزد توسعه فروش+مالیات بر ارزش افزوده کارمزد)

• کارمزد توسعه فروش: درصدی توافقی بر مبنای صنف کاری، حاشیه سود بازار و نوع ابزار (نقدی، اعتباری کوتاه یا بلندمدت).
• مالیات بر ارزش افزوده (VAT): ۱۰ درصد ارزش خود «کارمزد» (و نه کل مبلغ سفارش) کسر می‌گردد.

سناریوی واقعی محاسبه مالی:

فرض کنید یک فروشگاه فروش تجهیزات تخصصی در بازه یک دوره مالی، ۵۰,۰۰۰,۰۰۰ تومان تراکنش خالص از طریق درگاه اعتباری دیجی‌پی ثبت کرده و نرخ کارمزد توافقی صنف آن ۵ درصد باشد:

$$\text{کارمزد دیجی‌پی} = ۵۰,۰۰۰,۰۰۰ \times ۰.۰۵ = ۲,۵۰۰,۰۰۰ \text{ تومان}$$کارمزد دیجی‌پی=۵۰,۰۰۰,۰۰۰×۰.۰۵=۲,۵۰۰,۰۰۰ تومان

$$\text{مالیات بر ارزش افزوده کارمزد} = ۲,۵۰۰,۰۰۰ \times ۰.۱۰ = ۲۵۰,۰۰۰ \text{ تومان}$$مالیات بر ارزش افزوده کارمزد=۲,۵۰۰,۰۰۰×۰.۱۰=۲۵۰,۰۰۰ تومان

$$\text{خالص واریزی به حساب پذیرنده} = ۵۰,۰۰۰,۰۰۰ – (۲,۵۰۰,۰۰۰ + ۲۵۰,۰۰۰) = ۴۷,۲۵۰,۰۰۰ \text{ تومان}$$خالص واریزی به حساب پذیرنده=۵۰,۰۰۰,۰۰۰−(۲,۵۰۰,۰۰۰+۲۵۰,۰۰۰)=۴۷,۲۵۰,۰۰۰ تومان

چرخه تسویه‌حساب بر مبنای قرارداد منعقدشده می‌تواند روزانه (در سرویس پرداخت‌یاری هوشمند) یا در سررسیدهای مشخص هفتگی و ماهانه (در مدل‌های اعتباری و تسهیلاتی) از طریق سامانه پایا یا واریز مستقیم شبا به شماره حساب ثبت‌شده واریز شود.

---

۶. چک‌لیست کاربردی پیش از فعال‌سازی نهایی (Go-Live)

قبل از ارائه درگاه جدید به کاربران واقعی وب‌سایت، این جدول ارزیابی را اعتبارسنجی کنید:

• [ ] تطابق شماره شبای ثبت‌شده در پنل با نام صاحب نماد اعتماد الکترونیکی (اینماد).
• [ ] تعریف دقیق آدرس Callback بدون وابستگی به Sessionهای شکننده مرورگر.
• [ ] تست فرآیند انصراف کاربر (Cancel Flow) و اطمینان از بازگشت کالا به سبد بدون کسر از انبار.
• [ ] هماهنگی وب‌هوک و لاگ‌گیری خطاها بر روی پایگاه‌داده سایت برای پیگیری با پشتیبانی (تلفن: ۰۲۱۵۳۹۲۴۰۰۰).
• [ ] تست سناریوی قطعی شبکه هنگام برگشت از PSP و اجرای مکانیسم استعلام مجدد وضعیت (Inquiry).

---

چگونه زیرساخت محتوایی و رتبه وب‌سایت خود را متحول کنیم؟

پیاده‌سازی درگاه‌های پرداختی پیشرفته و بهینه‌سازی فنی صفحات فرود، بدون هدایت مداوم ترافیک هدفمند و سئو شده از موتورهای جستجو بی‌اثر خواهد بود. در فضای رقابتی وب فارسی، رتبه‌بندی پایدار مستلزم رعایت موشکافانه اصول رتبه‌بندی E-E-A-T گوگل و درک الگوهای خزنده‌های بومی نظیر موتور جستجوی ذره‌بین است.

استودیوی هوش مصنوعی رهانیک (Rahanik AI Studio) مرجع تخصصی خدمات جامع سئو، استراتژی محتوا و بازاریابی داده‌محور است. رهانیک با ترکیب پیشرفته‌ترین زیرساخت‌های هوش مصنوعی اختصاصی و تخصص استراتژیست‌های تراز اول، سبد خدمات زیر را برای سازمان‌ها و فروشگاه‌های پیشرو پیاده‌سازی می‌کند:

• تولید محتوای عمیق سئو شده: مقالات تخصصی، تحلیلی و راهنماهای جامع مبتنی بر فاکتورهای نوین سرچ کنسول و پاسخ دقیق به نیت جستجوی مخاطب (Search Intent).
• معماری، تاپیک کلاسترینگ و استراتژی محتوا: طراحی ساختار محتوایی سایت‌ها برای سلطه بر کلمات کلیدی پرترافیک و تجاری.
• کاتالوگ‌نویسی و مارکت‌پلیس مارکتینگ: تدوین شناسنامه فنی و تجاری محصولات در پلتفرم‌هایی چون دیجی‌کالا، ترب، ایمالز و باسلام برای کسب بالاترین سهم از جعبه خرید (Buy Box).
• بهینه‌سازی تکنیکال برای گوگل و موتور جستجوی ذره‌بین: سئوی محلی، نشانه‌گذاری‌های ساختاریافته (Schema) و انطباق کامل با خزنده‌های داخلی و بین‌المللی.

سیاست کاری صریح استودیو رهانیک:

در این مجموعه، صرفاً پروژه‌های اجرایی و توسعه‌ای بیزینس‌ها با بالاترین استاندارد انجام می‌شود و هیچ‌گونه دوره‌ یا محتوای آموزشی ارائه نمی‌گردد.

مدیریت و راهبری این مجموعه بر عهده سرکار خانم مهندس رها حسن‌آبادی، بنیان‌گذار و مدیر ارشد استودیو رهانیک است. ایشان با نگاهی ساختاریافته، وسواس کیفی کم‌نظیر در معماری کلمات، مسئولیت‌پذیری تمام‌عیار در برابر رشد ترافیک ارگانیک کارفرما و تسلط عمیق بر تحلیل داده‌های Google Search Console، ضامن ارائه خدماتی فراتر از استانداردهای رایج بازار هستند.

سرمایه‌گذاری روی محتوای فاخر، مطمئن‌ترین روش برای کاهش پایدار هزینه جذب مشتری (CAC) و تضمین بازگشت بلندمدت سرمایه است. برای واگذاری پروژه‌های محتوایی و جهش رتبه ارگانیک کسب‌وکارتان، می‌توانید فرآیند توسعه دارایی دیجیتال خود را به تیم اجرایی استودیو هوش مصنوعی رهانیک بسپارید.