وضعیت پرداخت و وضعیت سفارش به هم مرتبط‌اند، اما یک رکورد نیستند
درگاه اتفاقات پرداخت را گزارش می‌کند، اما برنامه شما درباره سفارش تصمیم می‌گیرد. سامانه قابل‌اعتماد با پیام تأییدنشده سفارش را تحویل نمی‌دهد، پس از رویداد جدیدتر وضعیت را به عقب برنمی‌گرداند و استثنای مبلغ را بدون سیاست روشن، پرداخت کامل فرض نمی‌کند.
هیچ درخواست، وبهوک، انتقال وجه، بازپرداخت یا تغییر سفارشی به OxaPay ارسال نمی‌شود. دادهها در همین مرورگر میمانند و مرجع معتبر، پاسخ واقعی API است.
این ابزار انتقال‌های احتمالی وضعیت و اقدامات پذیرنده را توضیح می‌دهد؛ پرداخت واقعی نمی‌سازد، به API متصل نمی‌شود، تراکنش حقیقی را بررسی نمی‌کند و جای Payment Information را نمی‌گیرد.
روش استفاده از شبیه‌ساز وضعیت پرداخت
این شبیه‌ساز به پذیرندگان و توسعه‌دهندگان کمک می‌کند اثر یک رویداد پرداخت را بر سفارش بررسی کنند. سناریوی آماده را انتخاب کنید یا مبلغ، انقضا، تأیید شبکه، روش پرداخت و شرایط وبهوک را خودتان تنظیم کنید. این ابزار آموزشی است و هیچ تراکنش واقعی را بررسی نمی‌کند و درخواستی به OxaPay نمی‌فرستد.
وضعیت پرداخت با وضعیت سفارش فرق دارد
درگاه فقط وضعیت پرداخت را گزارش می‌کند؛ فروشگاه مستقل از آن تصمیم می‌گیرد سفارش معلق بماند، تحویل شود یا بررسی دستی آغاز شود. مشاهده انتقال به‌معنای پذیرش قطعی پرداخت نیست. تحویل غیرقابل‌بازگشت فقط با وضعیت نهایی معتبر و مجاز انجام می‌شود. وبهوک تکراری یا خارج از ترتیب هم نباید به تحویل مجدد منجر شود.
کسری مبلغ و زمان‌بندی چگونه شبیه‌سازی می‌شوند؟
کسری مجاز با مبلغ سفارش و درصد پوشش کم‌پرداختی محاسبه می‌شود. کسری بیش از حد، انتقال دیرهنگام یا روش پرداخت نامتناسب به سیاست مشخص پذیرنده نیاز دارد. واریز آدرس ثابت باید جداگانه به مشتری و تراکنش مربوط تطبیق داده شود. صفر تأیید شبکه جای وضعیت نهایی گزارش‌شده توسط درگاه را نمی‌گیرد.
تحویل وبهوک و بازیابی
سناریوها شامل پیام تکراری، امضای HMAC نامعتبر، رویدادهای خارج از ترتیب، خطای تلاش اول و پایان تلاش‌های مجدد هستند. پردازشگر باید امضای بدنه خام را بررسی کند، سفارش را با شناسه تطبیق دهد، تغییرات را بدون تکرار اجرا کند و اختلاف‌ها را با Payment Information یا Payment History رفع کند. JSON نمونه پاسخ واقعی API نیست.
محدودیت‌های شبیه‌سازی
همه سفارش‌ها، شناسه تراکنش‌ها، زمان‌ها و پیام‌ها ساختگی هستند. وضعیت‌ها، محدودیت‌ها و برنامه تلاش مجدد OxaPay ممکن است تغییر کنند. پیش از ساخت منطق عملیاتی، مستندات رسمی روز را بررسی کنید. این ابزار نه پول ارسال می‌کند، نه بازپرداخت یا وبهوک واقعی انجام می‌دهد و نه کلید خصوصی می‌گیرد.
وضعیت‌های مستند پرداخت OxaPay
کسری مجاز با مبلغ سفارش و درصد پوشش کم‌پرداختی محاسبه می‌شود. کسری بیش از حد، انتقال دیرهنگام یا روش پرداخت نامتناسب به سیاست مشخص پذیرنده نیاز دارد. واریز آدرس ثابت باید جداگانه به مشتری و تراکنش مربوط تطبیق داده شود. صفر تأیید شبکه جای وضعیت نهایی گزارش‌شده توسط درگاه را نمی‌گیرد.
new- فاکتور ایجاد شده؛ ارز پرداخت انتخاب نشده است.
waiting- ارز انتخاب شده و سیستم منتظر پرداخت است.
paying- تراکنش شناسایی شده یا هنوز در حال پردازش است.
paid- فاکتور به‌طور کامل پرداخت شده است.
manual_accept- پذیرنده فاکتور را به‌صورت دستی پذیرفته است.
underpaid- پرداخت جزئی شرط مبلغ فاکتور را برآورده نکرده است.
refunding- فرایند بازپرداخت آغاز شده است.
refunded- پرداخت بازگردانده شده است.
expired- مهلت فاکتور بدون پرداخت قابل‌قبول پایان یافته است.
مستندات روز OxaPay
جدول وضعیت، پارامترهای فاکتور، استعلام پرداخت و راهنمای وبهوک را در مستندات روز بررسی کنید.