شماره راهنما50راه‌اندازی درگاه پرداخت از صفر تا اولین تراکنش واقعی
پیش‌نیاز حساب پذیرنده، گرفتن کلید API و Secret، ثبت نشانی عمومی HTTPS، آزمون اتصال و اولین تراکنش کم‌ارزش.
یک درگاه با وارد‌کردن دو فیلد «آماده» نمی‌شود؛ بخشی از کار در پنل خود ارائه‌دهنده و بخشی در اوردیکس انجام می‌شود. این راهنما ترتیب درست را می‌گوید تا اولین تراکنش واقعی با کمترین ریسک انجام شود.
گام یک - حساب و هویت پذیرنده
در همان سرویس پرداخت، حساب بسازید، شمارهٔ کارت خود را ثبت و هویت را تأیید کنید و سطح اشتراکی بگیرید که دسترسی API دارد. بدون کارت ثبت‌شده یا بدون اشتراک فعال، درخواست ساخت فاکتور پاسخ ۴۲۲ یا ۴۰۳ می‌گیرد و هیچ وجهی جابه‌جا نمی‌شود. این مرحله در پنل اوردیکس انجام نمی‌شود و مسئولیتش با صاحب حساب است.
گام دو - گرفتن کلید API و Secret
کلید API از بخش «API» پنل فروشنده گرفته می‌شود و فقط به همان حساب وصل است؛ Secret امضای callback هم از همان‌جا یا از تنظیمات وبهوک حساب روشن می‌شود. هر دو را فقط در فیلدهای «درگاه پرداخت فروشگاه» وارد کنید: مقدارها رمزنگاری‌شده در همان فضای کاری نگهداری می‌شوند، هرگز به مرورگر برگردانده نمی‌شوند و در فیلدهای خالی، مقدار قبلی حفظ می‌ماند. برای پاک‌کردن کلید از گزینهٔ «حذف» استفاده کنید.
گام سه - نشانی عمومی HTTPS
سامانه باید از بیرون با HTTPS قابل دسترسی باشد تا تیکارت بتواند رویداد تأیید را به آن بفرستد. نشانی پایهٔ عمومی در تنظیمات مدیرکل نگه داشته می‌شود؛ localhost، IP خام، HTTP و نشانی‌های بدون HTTPS پذیرفته نمی‌شوند. اگر سایت پشت فایروال یا حالت تعمیرات است، پیش از فروش واقعی آن را بردارید وگرنه تأیید خودکار انجام نمی‌شود.
گام چهار - فعال کردن و آزمون اتصال
پس از ذخیره، کلید را فعال کنید و «آزمون اتصال» را بزنید. این آزمون با همان مسیر مستندِ خواندن محصولات، زنده‌بودن کلید و دسترسی API حساب را بررسی می‌کند. پاسخ‌های رایج معنا دارند: ۴۰۱ یعنی کلید نامعتبر، ۴۰۳ یعنی اشتراک حساب اجازه API ندارد، ۴۲۹ یعنی سقف ۱۲۰ درخواست در دقیقه پر شده است.
گام پنج - اولین تراکنش واقعی
یک کالای کم‌قیمت بسازید، با شمارهٔ خودتان سفارش دهید، مبلغ یکتا را دقیق واریز کنید و ببینید وضعیت به «پرداخت تأییدشده» می‌رسد و سند دریافت در امور مالی ثبت می‌شود. در پنل همان درگاه هم رویداد را بررسی کنید؛ تطبیقِ دو طرف، نشانهٔ درست‌کارکردن مسیر است.
سقف‌ها و محدودیت‌های عملیاتی
سقف درخواست‌ها در دقیقه به ازای هر کلید محاسبه می‌شود و اوردیکس عمداً زیر سقف مستند درخواست می‌فرستد. اگر چند فروشگاه با یک کلید کار کنند، سهمیهٔ آن کلید مشترک است. محیط آزمایشی (sandbox) در مستندات تیکارت تعریف نشده است؛ بنابراین معیار نهایی، همان تراکنش کم‌ارزش واقعی است.
انتقال، بازگشت وجه و فاکتور رسمی
این مسیر API بازگشت وجه ندارد؛ مرجوعی با بررسی دستی و از کارت خودِ پذیرنده انجام می‌شود و باید شمارهٔ پیگیری‌اش در همان سفارش ثبت شود. فاکتور رسمی مالیاتی و دفتر قانونی هم صادر نمی‌شود و گزارش‌های مالی برای تصمیم نهایی باید با اسناد واقعی کسب‌وکار تطبیق داده شوند.
نقشه اجرایی: راه‌اندازی درگاه پرداخت از صفر تا اولین تراکنش واقعی
نمای مفهومی از موضوعات این راهنما؛ عنوان‌ها و داده‌ها صرفاً آموزشی‌اند.
پس از مطالعه این راهنما چه مواردی را بررسی کنم؟
- پیش‌نیازها و محدوده دسترسی مرتبط با این بخش را پیش از شروع بررسی کنید.
- هر مرحله را با داده واقعی و در دامنه مجاز فضای کاری انجام دهید.
- پس از اجرا، وضعیت و نتیجه را در همان ماژول بازبینی کنید.
نکته مهم: این شبیه‌سازی داده واقعی را تغییر نمی‌دهد. نتیجه نهایی به مجوز کاربر، پلن، تنظیمات اتصال و سرویس‌های بیرونی وابسته است.