ادغام اکساپی ورود به وبسایت یا پلتفرم شما عموماً یک فرآیند روان است، اما مانند هر ادغام فنی دیگری، ممکن است گاهی اوقات چالشهایی وجود داشته باشد. چه در حال راهاندازی OxaPay از طریق افزونهها، APIها یا لینکهای پرداخت سفارشی آن باشید، این راهنما مشکلات رایج ادغام را پوشش میدهد و راهحلهای سادهای را برای کمک به شما در حل سریع آنها ارائه میدهد.
مشکل ۱: کلید API کار نمیکند
یکی از رایجترین مشکلاتی که بازرگانان در طول فرآیند ادغام OxaPay با آن مواجه میشوند، مربوط به کلیدهای API است. اگر شما کلید API کار نمیکند، تراکنشها ممکن است پردازش نشوند و یکپارچهسازی شما آنطور که انتظار میرود عمل نخواهد کرد.
راه حل:
- قالب کلید API را بررسی کنیدمطمئن شوید که کلید API مورد استفاده شما به درستی از داشبورد OxaPay کپی شده است. مراقب هرگونه فاصله یا کاراکتر اضافی که ممکن است هنگام کپی کردن اضافه شده باشد، باشید.
- از کلید API صحیح استفاده کنیداکساپی دو نوع کلید API ارائه میدهد: کلید API فروشنده برای پردازش پرداختها و کلید API پرداخت برای مدیریت پرداختها. مطمئن شوید که از کلید صحیح برای ادغام خود استفاده میکنید.
- لیست مجاز IP را بررسی کنیداگر IP های مجاز برای انتقال API را تنظیم کردهاید، مطمئن شوید که درخواستها از IP های مجاز ارسال میشوند. درخواستهای آدرسهای IP غیرمجاز مسدود خواهند شد.
- تست در حالت سندباکساگر مطمئن نیستید که کلید API شما به درستی تنظیم شده است، قبل از رفتن به تراکنشهای زنده، از محیط sandbox OxaPay برای آزمایش آن استفاده کنید.
نکته: کلیدهای API خود را به طور واضح در داشبورد برچسب گذاری کنید تا از سردرگمی بین کلیدهای فروشنده و پرداخت جلوگیری شود.
مشکل ۲: خطاهای نصب افزونه
اگر از یکی از آنها استفاده میکنید افزونههای OxaPay, ممکن است در طول مرحله نصب یا فعالسازی با مشکلاتی مواجه شوید.
راه حل:
- بررسی سازگاریمطمئن شوید که پلتفرم شما (مثلاً وردپرس، WHMCS) بهروز و با نسخه افزونه OxaPay که نصب میکنید سازگار است.
- مستندات افزونه را دنبال کنید: مراجعه کنید به راهنمای نصب افزونه OxaPay مخصوص پلتفرم شما. برخی از پلتفرمها ممکن است به تنظیمات اضافی مانند فعال کردن درگاههای پرداخت در تنظیمات پلتفرم نیاز داشته باشند.
- بررسی مجوزهای فایلمطمئن شوید که مجوزهای فایل صحیح را روی سرور خود دارید. گاهی اوقات افزونهها به دلیل مجوزهای محدودکننده نصب نمیشوند.
- پاک کردن حافظه پنهان (Cache)اگر افزونه نصب شده است اما به درستی کار نمیکند، پاک کردن حافظه پنهان پلتفرم شما ممکن است مشکل را حل کند.
مشکل ۳: پرداخت تأیید نشده یا با تأخیر انجام میشود
پس از ادغام OxaPay، ممکن است متوجه شوید که برخی از پرداختها به سرعت مورد انتظار تأیید نمیشوند. اگر به درستی به این تأخیر رسیدگی نشود، میتواند منجر به نارضایتی مشتری شود.
راه حل:
- بررسی تاییدیههای بلاکچینپرداختهای ارز دیجیتال اغلب قبل از اینکه معتبر در نظر گرفته شوند، به تعداد مشخصی از تأییدیهها در بلاکچین نیاز دارند. در داشبورد OxaPay، مطمئن شوید که تنظیمات شما برای تعداد تأییدیههای مورد نیاز منطقی است. به عنوان مثال، بیتکوین ممکن است بیشتر از سکههای سریعتری مانند لایتکوین طول بکشد.
- نظارت بر ازدحام شبکهاگر متوجه تأخیرهای مکرر شدید، وضعیت شبکه ارز دیجیتال مورد قبول خود را بررسی کنید. در دورههای فعالیت بالای شبکه، تأیید تراکنشها میتواند زمان بیشتری طول بکشد.
- تنظیم وب هوکهامطمئن شوید که ادغام OxaPay شما از موارد زیر استفاده میکند: وب هوکها برای دریافت بهروزرسانیهای بلادرنگ در مورد وضعیت پرداختها. این تضمین میکند که سیستم شما به محض دریافت، تأییدیههای پرداخت را بهطور خودکار بهروزرسانی میکند.
نکته: برای مدیریت انتظارات، مشتریان را از زمانهای تأیید مورد انتظار برای هر ارز دیجیتال مطلع کنید.
مشکل ۴: مبالغ پرداختی نادرست
گاهی اوقات، مشتریان ممکن است به دلیل نوسانات قیمت ارزهای دیجیتال یا خطاهای ورودی، مبلغ فاکتور را کمتر یا بیشتر از مقدار واقعی آن پرداخت کنند.
راه حل:
- پوشش کمبود پرداخت را فعال کنیددر داشبورد OxaPay، گزینهی گزینه پوشش کم پرداختی. این به شما امکان میدهد پرداختهایی را که کمی کمتر از مبلغ درخواستی هستند (در یک درصد مشخص) بپذیرید و از ایجاد مغایرتهای جزئی که منجر به تراکنش ناموفق میشوند، جلوگیری کنید.
- با مشتریان ارتباط برقرار کنید: برای مشتریان روشن کنید که باید دقیقاً مبلغ مشخص شده در هنگام پرداخت را ارسال کنند. ارائه دستورالعمل های واضح می تواند خطاها را کاهش دهد.
مشکل ۵: خطاهای API پرداخت
اگر استفاده میکنید رابط برنامهنویسی کاربردی پرداخت OxaPay برای خودکارسازی انتقال ارزهای دیجیتال برای فروشندگان، مشتریان یا شرکا، ممکن است در فرآیند انتقال با خطاهایی مواجه شوید.
راه حل:
- بررسی اعتبارنامههای API: دوباره بررسی کنید که از کلید API پرداخت صحیح استفاده میشود و معتبر است.
- تأیید لیست مجاز IPاگر محدودیتهای IP را برای اهداف امنیتی تنظیم کردهاید، مطمئن شوید که درخواستها از آدرسهای IP مجاز میآیند.
- بررسی محدودیتهای انتقال روزانه: OxaPay به شما امکان میدهد محدودیتهای انتقال روزانه و هر تراکنش را تعیین کنید. اگر این محدودیتها خیلی محدودکننده باشند، درخواستهای پرداخت شما ممکن است ناموفق باشند. این محدودیتها را در صورت نیاز در تنظیمات API پرداخت بررسی و تنظیم کنید.
مشکل ۶: لینکهای پرداخت ایجاد نمیشوند
اگر سعی در تولید دارید لینکهای پرداخت با ارزهای دیجیتال برای مشتریان، اما آنها به درستی کار نمیکنند یا تولید نمیشوند، میتواند به دلیل پیکربندی نادرست در داشبورد OxaPay شما باشد.
راه حل:
- اطمینان از پیکربندی مناسب: چه زمانی ایجاد لینکهای پرداخت, دوباره بررسی کنید که تمام فیلدهای مورد نیاز، از جمله نام، مبلغ پرداختی و ارزهای دیجیتال انتخابی را پر کردهاید.
- انتخاب صحیح سکه: مطمئن شوید که ارزهای دیجیتال انتخاب شده معتبر و برای پرداخت در دسترس هستند. OxaPay از طیف گستردهای از ارزهای دیجیتال پشتیبانی میکند, ، اما اطمینان حاصل کنید که موارد صحیح انتخاب شدهاند.
- از یک نام معتبر استفاده کنیدنام لینک پرداخت باید در محدوده کاراکتری مشخص شده توسط OxaPay باشد، معمولاً بین ۳ تا ۳۰ کاراکتر.
نکته: برای آسانتر کردن پیگیری، از نامهای توصیفی و واضح برای لینکهای پرداخت استفاده کنید.
شماره ۷: اختلاف در هزینه تراکنش
برخی از بازرگانان ممکن است با مشکلاتی مواجه شوند که در آن هزینههای تراکنش با آنچه انتظار دارند مطابقت ندارد، چه از تنظیمات خودشان و چه به دلیل نوسانات شبکه.
راه حل:
- تنظیمات کارمزد را بررسی کنیدبررسی کنید که آیا هزینههایی را تعیین کردهاید که توسط مشتری یا توسط کسبوکارتان پوشش داده شود (هزینه پرداخت شده توسط پرداخت کننده یا فروشنده). این تنظیمات را بر اساس آنچه برای شما مناسبتر است، تنظیم کنید.
- هزینههای شبکه را در نظر بگیریدبه خاطر داشته باشید که برخی از ارزهای دیجیتال، به خصوص در دورههای تقاضای بالا، کارمزد شبکه متغیری دارند. کوینهای پذیرفته شده خود را تنظیم کنید یا در مورد هزینههای اضافی احتمالی با مشتریان خود صحبت کنید.
نتیجهگیری
اکساپی ساده میکند پرداختهای ارز دیجیتال برای کسبوکارها, ، اما پرداختن به مسائل رایج ادغام برای یک تجربه یکپارچه ضروری است. با عیبیابی پیشگیرانه خطاهای API، مشکلات افزونه یا تأخیر در پرداخت، میتوانید اختلالات را به حداقل رسانده و عملیات روان را حفظ کنید.
برای راهنمایی دقیق تر، به مستندات جامع OxaPay یا برای دریافت کمک شخصی با ما تماس بگیرید. پیادهسازی این راهکارها، یکپارچهسازی قابل اعتماد و کارآمد OxaPay را برای کسب و کار شما تضمین میکند.




