اگر از قبل در حال کاوش هستید اکساپی, احتمالاً به دنبال راهی مطمئن برای پذیرش پرداخت‌های کریپتو در وب‌سایت خود، بدون پیچیدگی، تأخیر یا ریسک اضافی هستید. این راهنما بر اساس تجربه پیاده‌سازی واقعی ساخته شده است و دقیقاً به شما نشان می‌دهد که چگونه شروع کنید، چه در حال راه‌اندازی یک لینک پرداخت، نصب یک افزونه یا ادغام API کامل باشید.
قبل از شروع: چک لیست قبل از ادغام
قبل از شروع مراحل ادغام، مطمئن شوید که موارد زیر را آماده دارید:
- یک وب‌سایت کاربردی (وردپرس، SaaS یا بک‌اند سفارشی).
- دسترسی ادمین برای نصب افزونه‌ها یا ویرایش کد بک‌اند.
- یک هدف تجاری: آیا شما برای محصولات، اشتراک‌ها یا کمک‌های مالی، ارز دیجیتال قبول می‌کنید؟
- حساب OxaPay شما ایجاد و تأیید شد (نیازی به احراز هویت مشتری/شناسایی هویت مشتری نیست)).
- اختیاری: دسترسی توسعه‌دهنده در صورتی که قصد استفاده از API را دارید.
مطمئن شوید که پلتفرم و تیم شما از نظر فنی آماده پشتیبانی از تراکنش‌های کریپتو مستقیماً در وب‌سایت شما، با یا بدون مشارکت توسعه‌دهنده، هستند.
🧭 نکته: اگر مطمئن نیستید از کدام روش استفاده کنید (افزونه یا API)، جدول مقایسه در انتها را بررسی کنید.
مرحله ۱: یک حساب OxaPay ایجاد کنید و به API خود دسترسی پیدا کنید
قبل از شروع ادغام، به یک حساب تأیید شده OxaPay نیاز دارید. در اینجا مراحل انجام آن آمده است:
- ثبت نام در اکساپی- نیازی به احراز هویت مشتری (KYC)/شناسایی هویت مشتری (KYB) نیست.
- به داشبورد خود > تنظیمات API بروید.
- کپی کنید کلید API فروشنده و رمز تماس برگشتی خود را یادداشت کنید.
این اعتبارنامه‌ها پایه و اساس یک ارتباط امن بین وب‌سایت شما و OxaPay و اولین قدم برای پذیرش پرداخت‌های کریپتو در وب‌سایت شما با کنترل کامل هستند.
🔒 نکته توسعه‌دهنده:
برای امنیت بهتر، کلیدهای API خود را به صورت دوره‌ای تغییر دهید و آنها را در متغیرهای محیطی ذخیره کنید، نه در پایگاه کد خود.
مرحله ۲: روش ادغام مناسب را انتخاب کنید
OxaPay از روش‌های مختلفی برای ادغام پرداخت‌های کریپتو در سایت شما پشتیبانی می‌کند. بر اساس نوع وب‌سایت و ظرفیت فنی خود، یکی را انتخاب کنید:
۱. ادغام افزونه (بدون نیاز به کد)
ایده‌آل برای پلتفرم‌های تجارت الکترونیک و صدور صورتحساب مانند WooCommerce، WHMCS و Blesta. OxaPay همچنین از پلتفرم‌های اضافی پشتیبانی می‌کند،, تمام افزونه‌ها و ادغام‌های پرداخت با ارزهای دیجیتال را بررسی کنید برای کسب و کار شما.
چگونه آن را انجام دهیم:
- افزونه را از اینجا نصب کنید صفحه مستندات OxaPay.
- کلید API خود را در تنظیمات وارد کنید.
- سکه‌های مورد نظر و مهلت پرداخت خود را تنظیم کنید.
- انجام شد. شما زنده هستید.
⏱ زمان تنظیم: حدود ۱۵ دقیقه
۲. ادغام API (برای توسعه‌دهندگان)
اگر یک پلتفرم سفارشی را اجرا می‌کنید، از آن استفاده خواهید کرد API REST شرکت OxaPay برای ایجاد فاکتورها و تراکنش‌ها را با کنترل کامل در بک‌اند مدیریت کنید.
نقاط پایانی اصلی که استفاده خواهید کرد:
- پست /api/create-invoice
- دریافت /api/check-invoice
- وب‌هوک: فراخوانی مجدد POST با تأیید HMAC
جریان پایه:
- بخش مدیریت شما یک فاکتور شامل مبلغ، نوع سکه و آدرس اینترنتی هدایت‌شده تولید می‌کند.
- OxaPay یک آدرس پرداخت منحصر به فرد را برمی‌گرداند.
- مشتری از طریق کیف پول یا کد QR پرداخت می‌کند.
- OxaPay تراکنش را تأیید می‌کند و یک وب‌هوک امضا شده به آدرس اینترنتی (URL) شما ارسال می‌کند.
🧩 ادغام معمولاً حدود ۸۰ تا ۱۵۰ خط کد بک‌اند طول می‌کشد.
هر دو روش برای کمک به شما در پذیرش قابل اعتماد پرداخت‌های کریپتو در وب‌سایتتان ساخته شده‌اند، چه از یک افزونه استفاده کنید و چه یک بک‌اند کاملاً سفارشی بسازید. برای بررسی عمیق‌تر نحوه کار API و آنچه می‌توانید با آن بسازید، به راهنمای کامل ما در مورد API پرداخت با ارزهای دیجیتال و موارد استفاده.
📦 گوشه توسعه‌دهندگان - نمونه کد پایتون
درخواست‌های ورودی import hmac, hashlib API_KEY = "your-api-key" CALLBACK_SECRET = "your-secret" invoice_data = { "amount": 49.99, "currency": "USDT", "callback_url": "https://your-site.com/payment-callback" } response = requests.post("https://api.oxapay.com/api/create-invoice", json=invoice_data, headers={"Authorization": API_KEY}) print(response.json()) def verify_signature(data, signature): return hmac.new(CALLBACK_SECRET.encode(), data.encode(), hashlib.sha256).hexdigest() == signature
📘 ساده‌سازی فراخوانی پاسخ:
مطمئن شوید که نقطه پایانی فراخوانی شما به صورت عمومی قابل دسترسی است و پاسخ‌ها را برمی‌گرداند HTTP 200 تایید شد.
می‌توانید ورودی‌ها را ثبت کنید پست درخواست‌هایی برای تأیید ساختار و آزمایش منطق اعتبارسنجی امضای شما.
مرحله ۳: سفارشی‌سازی رفتار پرداخت
شما می‌توانید نحوه‌ی مدیریت پرداخت‌ها توسط OxaPay را در سایت خود تنظیم کنید:
- تبدیل خودکار: فوراً رمزارز دریافتی را به USDT تبدیل کنید .
- مهلت فاکتور: مدت اعتبار فاکتورها را تعریف کنید.
- بازیابی کم درآمد: به کاربران این امکان را می‌دهد که در صورت ارسال کمتر از مقدار مورد نیاز، پرداخت‌ها را تکمیل کنند.
- زبان و برندسازی: عنوان، لوگو و زبان صفحه پرداخت را سفارشی کنید.
این تنظیمات از طریق داشبورد یا پارامترهای API در هنگام ایجاد فاکتور قابل دسترسی هستند.
تنظیم دقیق این گزینه‌ها تضمین می‌کند که مشتریان شما از یک تجربه پایدار در هنگام پذیرش پرداخت‌های کریپتو در وب‌سایت شما، مطابق با برندسازی و نیازهای عملیاتی شما، بهره‌مند شوند.
⚙️ نکته پیشرفته برای توسعه‌دهندگان:
برای اعمال برندسازی به صورت پویا، هنگام ایجاد فاکتور از طریق API، فیلدهای custom_logo_url، language و redirect_after را ارسال کنید.
🔗 به ساخت یک تجربه پرداخت کریپتو با برند خودتان علاقه‌مند هستید؟ برای اطلاعات بیشتر به ... مراجعه کنید. نحوه ایجاد درگاه پرداخت سفارشی.
مرحله ۴: قبل از انتشار، یکپارچه‌سازی خود را آزمایش کنید
همیشه پیاده‌سازی خود را با استفاده از موارد زیر آزمایش کنید سندباکس OxaPay محیط زیست:
- فاکتورهای آزمایشی با مبالغ فرضی ایجاد کنید.
- با استفاده از کیف پول‌های آزمایشی، تأییدیه‌های پرداخت را شبیه‌سازی کنید.
- اعتبارسنجی کنید که فراخوانی‌های برگشتی به سرور شما برسند و منطق صحیح را فعال کنند (مثلاً علامت‌گذاری یک سفارش به عنوان پرداخت‌شده).
🔐 نکته توسعه‌دهنده:
از امضای HMAC ارسال شده در هر فراخوانی مجدد برای تأیید صحت با استفاده از رمز فراخوانی مجدد خود استفاده کنید. تلاش‌های تأیید ناموفق را ثبت کنید تا سوءاستفاده‌های احتمالی را رصد کنید.
🛠 عیب‌یابی مشکلات رایج:
- فاکتور منقضی شده؟ مدت زمان وقفه را در تنظیمات افزایش دهید یا اجازه دهید دوباره به سرعت تولید شود.
- تراکنش کم ارزش؟ گزینه “بازیابی کسری بودجه” را فعال کنید تا مشتریان بتوانند بقیه مراحل را انجام دهند.
- تماس برگشتی دریافت نشد؟ مطمئن شوید که سرور شما عمومی است و درخواست‌های POST را به درستی می‌پذیرد.
🧪 نکته تست:
شما می‌توانید با استفاده از کیف پول‌های آزمایشی مانند TronLink یا MetaMask در شبکه‌های آزمایشی، پرداخت‌ها را شبیه‌سازی کنید. OxaPay یک حالت sandbox اختصاصی برای آزمایش ایمن ارائه می‌دهد. آزمایش مناسب، نرخ شکست را کاهش می‌دهد و تضمین می‌کند که سیستم شما واقعاً آماده پذیرش پرداخت‌های کریپتو در وب‌سایت شما در شرایط دنیای واقعی است.
مرحله ۵: شروع به پذیرش کریپتو در وب‌سایت خود کنید
پس از اتمام آزمایش:
- فاکتورهای خود را از حالت سندباکس به حالت زنده تغییر دهید.
- تأییدیه‌های پرداخت را در داشبورد OxaPay نظارت کنید.
- اکنون آماده‌اید تا پرداخت‌های کریپتو را در وب‌سایت خود، به صورت ایمن، آنی و با قابلیت مشاهده کامل از طریق داشبورد OxaPay بپذیرید.
🌟 آنچه مشتریان شما تجربه می‌کنند
- یک صفحه پرداخت تمیز و مناسب برای موبایل.
- نمایش کد QR و آدرس کیف پول به صورت آنی.
- تایمر شمارش معکوس برای اعتبار فاکتور.
- تأیید خودکار در صورت موفقیت پرداخت.
✨ این عناصر بصری و کاربردی، اعتماد را افزایش و ترک خدمت را کاهش می‌دهند.
💸 اولین پرداخت کریپتویی شما (راهنمای گام به گام)
روند کار برای اولین تراکنش شما به این صورت است:
- شما از طریق افزونه یا API یک فاکتور ایجاد می‌کنید.
- مشتری یک صفحه پرداخت کاملاً سفارشی‌سازی‌شده را مشاهده می‌کند.
- آنها با استفاده از کیف پول رمزنگاری خود پرداخت می‌کنند (QR را اسکن کنید یا آدرس را جای‌گذاری کنید).
- OxaPay تراکنش را تأیید کرده و سیستم شما را از طریق فراخوانی مجدد به‌روزرسانی می‌کند.
- تأیید را در داشبورد خود مشاهده می‌کنید.
⚡ اکثر پرداخت‌های مبتنی بر ترون یا بایننس کوین در کمتر از ۶۰ ثانیه تأیید می‌شوند.
🧩 نکاتی برای موفقیت بلندمدت
- برداشت خودکار به کیف پول صرافی یا کیف پول سرد خود را فعال کنید.
- برای تطبیق فاکتورها، تاریخچه تراکنش‌ها را هفتگی بررسی کنید.
- برای بهبود نرخ بازیابی، از ردیابی کم‌هزینه استفاده کنید.
- تیم پشتیبانی خود را در مورد وضعیت پرداخت‌ها و تاریخ انقضای فاکتورها آموزش دهید.
- تنظیم نام تجاری و زبان‌ها بر اساس موقعیت مکانی کاربر.
📊 مقایسه روش‌های ادغام
| روش | زمان راه‌اندازی | پیچیدگی | بهترین برای |
| افزونه | حدود ۱۵ دقیقه | کم | ووکامرس، WHMCS، بلستا |
| API رست | ۱ تا ۳ ساعت | متوسط | نرم‌افزار به عنوان سرویس (SaaS)، برنامه‌های وب سفارشی، بک‌اند |
نتیجه‌گیری: ساخته شده برای سادگی. آماده برای مقیاس‌پذیری.
با OxaPay، می‌توانید پرداخت‌های کریپتو را در وب‌سایت خود بدون نوشتن کد پیچیده بلاکچین یا وابستگی به متولیان شخص ثالث بپذیرید. این فرآیند سریع، ایمن و مقیاس‌پذیر است، از افزونه‌های ساده گرفته تا کنترل کامل API.
🎯 آماده اجرای زنده هستید؟
آماده‌ی شروع به کار هستید؟ درگاه پرداخت کریپتویی OxaPay یا در ما غوطه‌ور شوید مستندات API برای ایجاد یک راهکار سفارشی برای کسب و کار شما.
